• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

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

# 在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 SSM Agent上安裝
<a name="agent-install-ubuntu-64-snap"></a>

**開始之前**  
在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 SSM Agent上安裝 之前，請注意下列事項：

SSM Agent 安裝程式檔案位置  
在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上，SSM Agent安裝程式檔案，包括代理程式二進位檔和組態檔案，會存放在下列目錄中：`/snap/amazon-ssm-agent/current/`。如果您變更此目錄中的任何組態檔案，則必須將這些檔案從 `/snap` 目錄複製到 `/etc/amazon/ssm/` 目錄。日誌和程式庫檔案未變更 (`/var/lib/amazon/ssm`、`/var/log/amazon/ssm`)。

使用 Snap `candidate` 管道  
Snap 商店中的*候選*頻道包含最新版本的 SSM Agent (包括所有最新錯誤修正)；而不是穩定的頻道。若要進一步了解候選頻道和穩定頻道之間的差異，請參閱**風險層級**，網址為 [https://snapcraft.io/docs/channels](https://snapcraft.io/docs/channels)。  
如果您想要追蹤候選頻道的SSM Agent版本資訊，請在 20.04 Ubuntu Server 和 18.04 LTS 64 位元執行個體上執行下列命令。  

```
sudo snap switch --channel=candidate amazon-ssm-agent
```

18.04 版及較新版本推薦使用的 Snap  
在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上，建議您僅使用 Snaps。另外驗證代理程式只有一個執行個體在您的執行個體上安裝和執行。

`Maximum timeout exceeded` 錯誤訊息  
由於 Snap 的已知問題，您可能會看到 `snap` 命令的 `Maximum timeout exceeded` 錯誤。如果您收到此錯誤，請一次執行下列一個命令來啟動、停止代理程式和檢查其狀態：  

```
sudo systemctl start snap.amazon-ssm-agent.amazon-ssm-agent.service
```

```
sudo systemctl stop snap.amazon-ssm-agent.amazon-ssm-agent.service
```

```
sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
```

**在 SSM Agent Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安裝 （使用 Snap 套件）**

1. SSM Agent 根據預設， 會安裝在識別符AMIs為 Ubuntu Server `20180627`或更新版本的 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上。

   如果您需要在現場部署伺服器上安裝 SSM Agent 或者如果您需要重新安裝代理程式，您可以使用以下指令碼。您不需要指定 URL 以供下載，因為 `snap` 命令會自動從 [Snap 應用程式商店](https://snapcraft.io/amazon-ssm-agent)下載代理程式，網址為 [https://snapcraft.io](https://snapcraft.io)。

   ```
   sudo snap install amazon-ssm-agent --classic
   ```

1. 執行下列命令來判斷 SSM Agent 是否在執行。

   ```
   sudo snap list amazon-ssm-agent
   ```

1. 若之前的命令傳回 `amazon-ssm-agent is stopped`、`inactive` 或 `disabled`，請執行以下命令，以啟動服務。

   ```
   sudo snap start amazon-ssm-agent
   ```

1. 檢查代理程式的狀態。

   ```
   sudo snap services amazon-ssm-agent
   ```