本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 疑難排解
<a name="troubleshooting-agent"></a>

## 代理程式無法啟動
<a name="agent-fails-to-start"></a>

 AWS Ground Station 代理程式可能會因多種原因而無法啟動，但最常見的情況可能是代理程式組態檔案設定錯誤。啟動代理程式後 （請參閱 [AWS Ground Station 代理程式啟動](managing-agent.md#gs-agent-start))，您可能會得到如下狀態：

```
#agent is automatically retrying a restart
aws-groundstation-agent.service - aws-groundstation-agent
Loaded: loaded (/usr/lib/systemd/system/aws-groundstation-agent.service; enabled; vendor preset: disabled)
Active: activating (auto-restart) (Result: exit-code) since Fri 2023-03-10 01:48:14 UTC; 23s ago
Docs: https://aws.amazon.com/ground-station/
Process: 43038 ExecStart=/opt/aws/groundstation/bin/launch-aws-gs-agent (code=exited, status=101)
Main PID: 43038 (code=exited, status=101)

#agent has failed to start
aws-groundstation-agent.service - aws-groundstation-agent
Loaded: loaded (/usr/lib/systemd/system/aws-groundstation-agent.service; enabled; vendor preset: disabled)
Active: failed (Result: start-limit) since Fri 2023-03-10 01:50:15 UTC; 13s ago
Docs: https://aws.amazon.com/ground-station/
Process: 43095 ExecStart=/opt/aws/groundstation/bin/launch-aws-gs-agent (code=exited, status=101)
Main PID: 43095 (code=exited, status=101)
```

### 疑難排解
<a name="agent-fails-to-start-ts"></a>

```
sudo journalctl -u aws-groundstation-agent | grep -i -B 3 -A 3 'Loading Config' | tail -6
```

可能會導致輸出：

```
launch-aws-gs-agent[43095]: Running with options Production(ProductionOptions { endpoint: None, region: None })
launch-aws-gs-agent[43095]: Loading Config
launch-aws-gs-agent[43095]: System has 96 logical cores
systemd[1]: aws-groundstation-agent.service: main process exited, code=exited, status=101/n/a
systemd[1]: Unit aws-groundstation-agent.service entered failed state.
```

 在「載入 Config」之後無法啟動代理程式，表示代理程式組態發生問題。請參閱 [代理程式組態檔案](configuring-agent.md#agent-config-file)以驗證您的代理程式組態。

## AWS Ground Station 客服人員日誌
<a name="gs-agent-logs"></a>

 AWS Ground Station 客服人員會撰寫聯絡執行、錯誤和運作狀態的相關資訊，以記錄執行客服人員之執行個體上的檔案。您可以手動連線至執行個體來檢視日誌檔案。

您可以在下列位置檢視客服人員日誌。

```
/var/log/aws/groundstation
```

## 沒有可用的聯絡人
<a name="no-contacts-available"></a>

 排程聯絡人需要運作狀態良好的 AWS Ground Station 客服人員。請透過 get-dataflow-endpoint-group 查詢 AWS Ground Station API，確認您的 AWS Ground Station 代理程式已啟動且運作狀態良好：

```
aws groundstation get-dataflow-endpoint-group --dataflow-endpoint-group-id ${DATAFLOW-ENDPOINT-GROUP-ID} --region ${REGION}
```

確認 `agentStatus`的 `awsGroundStationAgentEndpoint` 為 ACTIVE，且 `auditResults` 為 HEALTHY。