本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 问题排查
<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.
```

 在“加载配置”后仍未能启动座席表示座席配置存在问题。要验证您的座席配置，请参阅 [代理配置文件](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 代理。请通过以下方式查询 AWS Ground Station API，确认您的 AWS Ground Station 代理已启动且运行正常 get-dataflow-endpoint-group：

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

验证您的 `awsGroundStationAgentEndpoint` 的 `agentStatus` 处于活动状态且 `auditResults` 运行状况良好。