• 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)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 對 Systems Manager 庫存的問題進行故障診斷
本主題包含有關如何對 AWS Systems Manager 庫存的常見錯誤或問題進行故障診斷的資訊。如果在 Systems Manager 中檢視節點時發生問題，請參閱 [疑難排解受管節點的可用性](fleet-manager-troubleshooting-managed-nodes.md)。
**Topics**
+ [不支援具有文件 '`AWS-GatherSoftwareInventory`' 的多個應用全部關聯。](#systems-manager-inventory-troubleshooting-multiple)
+ [庫存執行狀態永遠不會結束擱置](#inventory-troubleshooting-pending)
+ [`AWS-ListWindowsInventory` 文件無法執行](#inventory-troubleshooting-ListWindowsInventory)
+ [主控台沒有顯示 Inventory (庫存) 儀表板 \| Detailed View (詳細檢視) \| Settings (設定) 標籤](#inventory-troubleshooting-tabs)
+ [UnsupportedAgent](#inventory-troubleshooting-unsupported-agent)
+ [略過](#inventory-troubleshooting-skipped)
+ [失敗](#inventory-troubleshooting-failed)
+ [Amazon EC2 執行個體的庫存合規失敗](#inventory-troubleshooting-ec2-compliance)
+ [S3 儲存貯體物件包含舊資料](#systems-manager-inventory-troubleshooting-s3)
## 不支援具有文件 '`AWS-GatherSoftwareInventory`' 的多個應用全部關聯。
`Multiple apply all associations with document 'AWS-GatherSoftwareInventory' are not supported` 表示嘗試設定*所有節點*之庫存關聯的一個或多個 AWS 區域 已經使用所有節點的庫存關聯進行設定的錯誤。必要時，您可以刪除所有節點的現有庫存關聯，然後建立新的庫存關聯。若要檢視現有的庫存關聯，請選擇 Systems Manager 主控台中的 **State Manager**，然後找出使用 `AWS-GatherSoftwareInventory` SSM 文件的關聯。如果所有節點的現有庫存關聯是跨多個區域建立的，而您想要建立新的關聯，則必須從每個存在現有關聯的區域中刪除現有關聯。
## 庫存執行狀態永遠不會結束擱置
庫存收集永遠不會結束 `Pending` 狀態的原因有兩個：
+ 選取的 中沒有節點 AWS 區域：
如果您使用 Systems Manager Quick Setup 建立全域庫存關聯，庫存關聯的狀態 (`AWS-GatherSoftwareInventory` 文件) 會顯示 `Pending` (如果選取的區域中沒有可用的節點)。****
+ 許可不足：
如果一或多個節點沒有執行 Systems Manager 庫存的許可，則庫存關聯會顯示 `Pending`。確定 AWS Identity and Access Management (IAM) 執行個體設定檔包含 **AmazonSSMManagedInstanceCore** 受管政策。如需如何將此政策新增到執行個體設定檔的資訊，請參閱 [EC2 執行個體許可的替代組態](setup-instance-permissions.md#instance-profile-add-permissions)。
至少，執行個體設定檔必須具有以下 IAM 許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ssm:DescribeAssociation",
"ssm:ListAssociations",
"ssm:ListInstanceAssociations",
"ssm:PutInventory",
"ssm:PutComplianceItems",
"ssm:UpdateAssociationStatus",
"ssm:UpdateInstanceAssociationStatus",
"ssm:UpdateInstanceInformation",
"ssm:GetDocument",
"ssm:DescribeDocument"
],
"Resource": "*"
}
]
}
```
------
## `AWS-ListWindowsInventory` 文件無法執行
`AWS-ListWindowsInventory` 文件已棄用。請勿使用此文件來收集庫存。請改為使用[設定清查收集](inventory-collection.md)中所述的其中一個處理程序。
## 主控台沒有顯示 Inventory (庫存) 儀表板 \| Detailed View (詳細檢視) \| Settings (設定) 標籤
庫存 **Detailed View** (詳細檢視) 頁面僅在提供 Amazon Athena 的 AWS 區域 中可用。若在庫存頁面上並未顯示下列索引標籤，則表示 Athena 並未在該區域中提供使用，且您無法使用 **Detailed View** (詳細檢視) 來查詢資料。
## UnsupportedAgent
如果庫存關聯的詳細狀態顯示 **UnsupportedAgent**，且**關聯狀態**顯示**失敗**，則受管節點 AWS Systems Manager SSM Agent上的 版本不正確。若要建立全域庫存關聯 （以清查 中的所有節點 AWS 帳戶)，您必須使用 2SSM Agent.0.790.0 版或更新版本。您可以前往 **Managed Instances** (受管執行個體) 頁面的 **Agent version** (代理程式版本) 欄位，檢視每個節點上執行的代理程式版本。如需如何在節點上更新 SSM Agent的相關資訊，請參閱 [使用 Run Command 更新 SSM Agent](run-command-tutorial-update-software.md#rc-console-agentexample)。
## 略過
如果節點的庫存關聯狀態顯示**已略過**，這表示較高優先順序的庫存關聯已在該節點上執行。如果有多個庫存關聯套用至同一受管節點，Systems Manager 會遵循特定的優先順序。
### 庫存關聯優先順序
Systems Manager 會以下列優先順序套用庫存關聯：
1. **Quick Setup 庫存關聯** – 使用 Quick Setup 和整合式主控台建立的關聯。這些關聯的名稱開頭為 `AWS-QuickSetup-SSM-CollectInventory-`，並以所有受管節點為目標。
1. **明確庫存關聯** – 以特定受管節點為目標的關聯，使用：
+ 執行個體 ID
+ 標籤鍵值對
+ AWS 資源群組
1. **全域庫存關聯** – 以所有受管節點 (使用 `--targets "Key=InstanceIds,Values=*"`) 為目標，但**不是**透過 Quick Setup 建立的關聯。
### 常用案例
**案例 1：Quick Setup 關聯覆寫明確關聯**
+ 您有一個以所有執行個體為目標的 Quick Setup 庫存關聯
+ 您用標籤建立了一個以特定受管節點為目標的手動關聯
+ 結果：該手動關聯顯示為 `Skipped`，其詳細狀態為 `OverriddenByExplicitInventoryAssociation`
+ Quick Setup 關聯會繼續從所有執行個體收集庫存資料
**案例 2：明確關聯覆寫全域關聯**
+ 您有一個以所有執行個體為目標的全域庫存關聯 (非 Quick Setup 建立)
+ 您建立一個以特定執行個體為目標的關聯
+ 結果：全域關聯對特定目標執行個體顯示為 `Skipped`
+ 明確關聯會在目標執行個體上執行
### 解決步驟
**如果您想要使用自己的庫存關聯，而非 Quick Setup 關聯：**
1. **找到 Quick Setup 關聯**：在 Systems Manager 主控台中，前往 State Manager 並尋找名稱開頭為 `AWS-QuickSetup-SSM-CollectInventory-` 的關聯。
1. **移除 Quick Setup 組態**：
+ 前往 Systems Manager 主控台中的 Quick Setup。
+ 尋找您的庫存收集組態。
+ 刪除 Quick Setup 組態 (這會移除關聯的庫存關聯)。
**注意**
您無需手動刪除 Quick Setup 建立的關聯。
1. **驗證關聯執行**：移除 Quick Setup 組態後，您的明確庫存關聯應會開始成功執行。
**如果您想要修改現有行為：**
+ 若要檢視現有的全部庫存關聯，請選擇 Systems Manager 主控台中的 **State Manager**，然後找到使用 `AWS-GatherSoftwareInventory` SSM 文件的關聯。
+ 請記住，每個受管節點一次只能有一個作用中的庫存關聯。
**重要**
當節點被指派的 (較高優先順序) 庫存關聯執行時，仍會從已略過的節點收集庫存資料。
Quick Setup 庫存關聯優先於所有其他關聯類型，即使其他關聯具有明確目標，也是如此。
如果某個關聯被優先順序較高的關聯覆寫，無論該關聯的類型為何，都會顯示詳細狀態訊息 `OverriddenByExplicitInventoryAssociation`。
## 失敗
如果節點的庫存關聯狀態顯示 **Failed (失敗)**，這可能表示節點有多個指派的庫存關聯。一次只能指派一個庫存關聯給節點。庫存關聯使用 `AWS-GatherSoftwareInventory` AWS Systems Manager 文件 (SSM 文件）。您可以使用 AWS Command Line Interface (AWS CLI) 檢視節點的關聯清單，來執行下列命令。
```
aws ssm describe-instance-associations-status --instance-id {{instance-ID}}
```
## Amazon EC2 執行個體的庫存合規失敗
如果您將多個庫存關聯指派給執行個體，則 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體的庫存合規可能會失敗。
若要解決此問題，請刪除指派給執行個體的一或多個庫存關聯。如需詳細資訊，請參閱[刪除關聯](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-state-manager-delete-association.html)。
**注意**
如果您為受管節點建立多個庫存關聯，請注意下列行為。
可以為每個節點指派以*所有*節點為目標的庫存關聯 (--targets "Key=InstanceIds,Values=\*")。
每個節點也可以指派使用標籤鍵/值對或 AWS 資源群組的特定關聯。
如果為節點指派多個庫存關聯，則尚未執行之關聯的狀態會顯示為*略過*。最近執行的關聯會顯示庫存關聯的實際狀態。
如果為節點指派多個庫存關聯，且每個都使用標籤索引鍵/值對，則由於標籤衝突，這些庫存關聯無法在節點上執行。該關聯仍然在沒有標籤索引鍵/值衝突的節點上執行。
## S3 儲存貯體物件包含舊資料
當庫存關聯成功並發現新資料時，Amazon S3 儲存貯體物件內的資料會進行更新。當關聯執行但失敗時，每個節點的 Amazon S3 儲存貯體物件都會更新，但在此情況下，物件內部的資料不會得到更新。只有在關聯成功執行時，Amazon S3 儲存貯體物件內的資料才會進行更新。庫存關聯失敗時，Amazon S3 儲存貯體中的資料為舊資料。