彙總庫存資料

完成 AWS Systems Manager 庫存的受管節點設定後，您便能檢視彙整的庫存資料計數。例如，假設您配置了數十或數百個受管節點來收集 AWS:Application 庫存類型。透過本節涵蓋的資訊，您能夠查看經過設定用於收集此資料的節點確切計數。

您也可以彙整資料類型，以查看特定庫存詳細資訊。例如：AWS:InstanceInformation 庫存類型會收集包含 Platform 資料類型的作業系統平台資訊。只要彙總 Platform 資料類型的相關資料，您就能快速查看執行 Windows、執行 Linux 和執行 macOS 的節點數量。

本節所述的程序會說明如何使用 AWS Command Line Interface (AWS CLI) 來檢視彙整的庫存資料計數。或者，您也能前往 AWS Systems Manager 主控台，在 Inventory (庫存) 頁面上檢視預先設定的彙總計數。這些預先設定的儀表板通稱為「庫存詳情」。只需按一下，即可修正庫存組態問題。

檢視庫存資料彙整計數時，請注意以下重要詳細資訊：

如果您終止設定為收集庫存資料的受管節點，Systems Manager 會保留庫存資料 30 天，然後將其刪除。對於執行中的節點，系統會刪除超過 30 天的庫存資料。如果您需要存放庫存資料超過 30 天，可以使用 AWS Config 來記錄歷史記錄，或定期查詢並上傳資料到 Amazon Simple Storage Service (Amazon S3) 儲存貯體。
如果您先前將節點設定成報告特定庫存資料類型 (如 AWS:Network)，之後為了停止收集該類型而變更組態，則彙整計數仍會顯示 AWS:Network 資料，直到節點終止且 30 天過去。

如需相關資訊，以了解如何快速設定和收集特定 AWS 帳戶中所有節點 (以及該帳戶任何未來可能建立的節點) 的庫存資料，請參閱使用主控台來設定收集。

彙總庫存資料以查看收集特定資料類型的節點計數

您可以使用 AWS Systems Manager GetInventory API 操作來檢視彙整的節點計數，這些執行個體皆負責收集一種或多種庫存類型和資料類型。例如，AWS:InstanceInformation 庫存類型可讓您將 GetInventory API 操作與 AWS:InstanceInformation.PlatformType 資料類型搭配使用，檢視作業系統的彙總。下方為 AWS CLI 命令和輸出的範例。


aws ssm get-inventory --aggregators "Expression=AWS:InstanceInformation.PlatformType"

系統會傳回如下資訊。

{
   "Entities":[
      {
         "Data":{
            "AWS:InstanceInformation":{
               "Content":[
                  {
                     "Count":"7",
                     "PlatformType":"windows"
                  },
                  {
                     "Count":"5",
                     "PlatformType":"linux"
                  }
               ]
            }
         }
      }
   ]
}

入門

決定要檢視其計數的庫存類型和資料類型。如需檢視支援彙整功能的庫存類型和資料類型，請在 AWS CLI 中執行以下命令。


aws ssm get-inventory-schema --aggregator

該命令會針對支援彙整功能的庫存類型和資料類型，傳回一份 JSON 清單。TypeName 欄位會顯示支援的庫存類型。Name (名稱) 欄位則會顯示每個資料類型。以以下清單為例，AWS:Application 庫存類型包含 Name 和 Version 的資料類型。

{
    "Schemas": [
        {
            "TypeName": "AWS:Application",
            "Version": "1.1",
            "DisplayName": "Application",
            "Attributes": [
                {
                    "DataType": "STRING",
                    "Name": "Name"
                },
                {
                    "DataType": "STRING",
                    "Name": "Version"
                }
            ]
        },
        {
            "TypeName": "AWS:InstanceInformation",
            "Version": "1.0",
            "DisplayName": "Platform",
            "Attributes": [
                {
                    "DataType": "STRING",
                    "Name": "PlatformName"
                },
                {
                    "DataType": "STRING",
                    "Name": "PlatformType"
                },
                {
                    "DataType": "STRING",
                    "Name": "PlatformVersion"
                }
            ]
        },
        {
            "TypeName": "AWS:ResourceGroup",
            "Version": "1.0",
            "DisplayName": "ResourceGroup",
            "Attributes": [
                {
                    "DataType": "STRING",
                    "Name": "Name"
                }
            ]
        },
        {
            "TypeName": "AWS:Service",
            "Version": "1.0",
            "DisplayName": "Service",
            "Attributes": [
                {
                    "DataType": "STRING",
                    "Name": "Name"
                },
                {
                    "DataType": "STRING",
                    "Name": "DisplayName"
                },
                {
                    "DataType": "STRING",
                    "Name": "ServiceType"
                },
                {
                    "DataType": "STRING",
                    "Name": "Status"
                },
                {
                    "DataType": "STRING",
                    "Name": "StartType"
                }
            ]
        },
        {
            "TypeName": "AWS:WindowsRole",
            "Version": "1.0",
            "DisplayName": "WindowsRole",
            "Attributes": [
                {
                    "DataType": "STRING",
                    "Name": "Name"
                },
                {
                    "DataType": "STRING",
                    "Name": "DisplayName"
                },
                {
                    "DataType": "STRING",
                    "Name": "FeatureType"
                },
                {
                    "DataType": "STRING",
                    "Name": "Installed"
                }
            ]
        }
    ]
}

使用以下語法建立命令，即可彙整任何列出的庫存類型資料。


aws ssm get-inventory --aggregators "Expression=InventoryType.DataType"

請見下方範例。

範例 1

此範例彙總了節點使用的 Windows 角色計數。


aws ssm get-inventory --aggregators "Expression=AWS:WindowsRole.Name"

範例 2

此範例彙總了節點上安裝的應用程式計數。


aws ssm get-inventory --aggregators "Expression=AWS:Application.Name"

結合多個彙總工具

您還能在一個命令中結合多個庫存類型與資料類型，有助於更全面了解相關資料。請見下方範例。

範例 1

此範例彙總了節點使用的作業系統類型計數。此命令亦可傳回特定的作業系統名稱。


aws ssm get-inventory --aggregators '[{"Expression": "AWS:InstanceInformation.PlatformType", "Aggregators":[{"Expression": "AWS:InstanceInformation.PlatformName"}]}]'

範例 2

此範例彙總了節點上執行的應用程式計數，以及每個應用程式的特定版本。


aws ssm get-inventory --aggregators '[{"Expression": "AWS:Application.Name", "Aggregators":[{"Expression": "AWS:Application.Version"}]}]'

如果您願意，還可以在 JSON 檔案中利用一個或多個庫存類型和資料類型來建立彙總表達式，並從 AWS CLI 呼叫該檔案。檔案中的 JSON 物件必須採用以下語法。


[
       {
           "Expression": "string",
           "Aggregators": [
               {
                  "Expression": "string"
               }
           ]
       }
]

請務必使用 .json 副檔名儲存檔案。

以下是運用多個庫存類型和資料類型的範例。


[
       {
           "Expression": "AWS:Application.Name",
           "Aggregators": [
               {
                   "Expression": "AWS:Application.Version",
                   "Aggregators": [
                     {
                     "Expression": "AWS:InstanceInformation.PlatformType"
                     }
                   ]
               }
           ]
       }
]

使用下列命令，即可從 AWS CLI 呼叫檔案。


aws ssm get-inventory --aggregators file://file_name.json

該命令會傳回相關資訊，如以下所示。

{"Entities": 
 [
   {"Data": 
     {"AWS:Application": 
       {"Content": 
         [
           {"Count": "3", 
            "PlatformType": "linux", 
            "Version": "2.6.5", 
            "Name": "audit-libs"}, 
           {"Count": "2", 
            "PlatformType": "windows", 
            "Version": "2.6.5", 
            "Name": "audit-libs"}, 
           {"Count": "4", 
            "PlatformType": "windows", 
            "Version": "6.2.8", 
            "Name": "microsoft office"}, 
           {"Count": "2", 
            "PlatformType": "windows", 
            "Version": "2.6.5", 
            "Name": "chrome"}, 
           {"Count": "1", 
            "PlatformType": "linux", 
            "Version": "2.6.5", 
            "Name": "chrome"}, 
           {"Count": "2", 
            "PlatformType": "linux", 
            "Version": "6.3", 
            "Name": "authconfig"}
         ]
       }
     }, 
    "ResourceType": "ManagedInstance"}
 ]
}

使用群組彙總庫存資料，以查看哪些節點已設定和未設定成收集某個庫存類型

Systems Manager 庫存中的群組可供您快速查看設定成收集一個或多個庫存類型的受管節點計數，以及未進行設定的執行個體數。透過群組功能，您可以指定一個或多個庫存類型，並使用 exists 運算子做為篩選條件。

例如，假設您分別設定四個受管節點，以收集下列庫存類型：

節點 1：AWS:Application
節點 2：AWS:File
節點 3：AWS:Application、AWS:File
節點 4：AWS:Network

您可以從 AWS CLI 執行以下命令，查看設定成同時收集 AWS:Application 與 AWS:File inventory 類型的節點數量。同時，回應還會傳回未設定成收集這兩種庫存類型的節點數。


aws ssm get-inventory --aggregators 'Groups=[{Name=ApplicationAndFile,Filters=[{Key=TypeName,Values=[AWS:Application],Type=Exists},{Key=TypeName,Values=[AWS:File],Type=Exists}]}]'

該命令回應顯示僅有一個受管節點經過設定，會同時收集 AWS:Application 與 AWS:File 庫存類型。

{
   "Entities":[
      {
         "Data":{
            "ApplicationAndFile":{
               "Content":[
                  {
                     "notMatchingCount":"3"
                  },
                  {
                     "matchingCount":"1"
                  }
               ]
            }
         }
      }
   ]
}

注意

群組不會傳回資料類型計數。您也無法深入檢視結果，以查看已設定或未設定成收集庫存類型的節點 ID。

如果您願意，還可以在 JSON 檔案中利用一或多個庫存類型來建立彙整表達式，並從 AWS CLI 呼叫該檔案。檔案中的 JSON 物件必須採用以下語法：


{
   "Aggregators":[
      {
         "Groups":[
            {
               "Name":"Name",
               "Filters":[
                  {
                     "Key":"TypeName",
                     "Values":[
                        "Inventory_type"
                     ],
                     "Type":"Exists"
                  },
                  {
                     "Key":"TypeName",
                     "Values":[
                        "Inventory_type"
                     ],
                     "Type":"Exists"
                  }
               ]
            }
         ]
      }
   ]
}

請務必使用 .json 副檔名儲存檔案。

使用下列命令，即可從 AWS CLI 呼叫檔案。


aws ssm get-inventory --cli-input-json file://file_name.json

其他範例

下列範例會示範彙整庫存資料的方式，使您能查看設定成收集特定庫存類型的受管節點，以及未設定的受管節點。這些範例皆是採用 AWS CLI。每個範例均包含具備篩選功能的完整命令。如此一來，當您想在檔案中輸入資訊時，便能從命令列和範例 input.json 檔案中執行該命令。

範例 1

此範例會彙整設定成收集 AWS:Application 或 AWS:File 庫存類型的節點計數，以及未經過設定的執行個體數。

從 AWS CLI 執行下列命令。


aws ssm get-inventory --aggregators 'Groups=[{Name=ApplicationORFile,Filters=[{Key=TypeName,Values=[AWS:Application, AWS:File],Type=Exists}]}]'

若您偏好使用檔案，則可複製下方範例並貼至檔案，接著將其儲存為 input.json。


{
   "Aggregators":[
      {
         "Groups":[
            {
               "Name":"ApplicationORFile",
               "Filters":[
                  {
                     "Key":"TypeName",
                     "Values":[
                        "AWS:Application",
                        "AWS:File"
                     ],
                     "Type":"Exists"
                  }
               ]
            }
         ]
      }
   ]
}

從 AWS CLI 執行下列命令。


aws ssm get-inventory --cli-input-json file://input.json

該命令會傳回相關資訊，如以下所示。

{
   "Entities":[
      {
         "Data":{
            "ApplicationORFile":{
               "Content":[
                  {
                     "notMatchingCount":"1"
                  },
                  {
                     "matchingCount":"3"
                  }
               ]
            }
         }
      }
   ]
}

範例 2

此範例會彙總設定成收集 AWS:Application、AWS:File 或 AWS:Network 庫存類型的節點計數，以及未經過設定的節點數。

從 AWS CLI 執行下列命令。


aws ssm get-inventory --aggregators 'Groups=[{Name=Application,Filters=[{Key=TypeName,Values=[AWS:Application],Type=Exists}]}, {Name=File,Filters=[{Key=TypeName,Values=[AWS:File],Type=Exists}]}, {Name=Network,Filters=[{Key=TypeName,Values=[AWS:Network],Type=Exists}]}]'

若您偏好使用檔案，則可複製下方範例並貼至檔案，接著將其儲存為 input.json。


{
   "Aggregators":[
      {
         "Groups":[
            {
               "Name":"Application",
               "Filters":[
                  {
                     "Key":"TypeName",
                     "Values":[
                        "AWS:Application"
                     ],
                     "Type":"Exists"
                  }
               ]
            },
            {
               "Name":"File",
               "Filters":[
                  {
                     "Key":"TypeName",
                     "Values":[
                        "AWS:File"
                     ],
                     "Type":"Exists"
                  }
               ]
            },
            {
               "Name":"Network",
               "Filters":[
                  {
                     "Key":"TypeName",
                     "Values":[
                        "AWS:Network"
                     ],
                     "Type":"Exists"
                  }
               ]
            }
         ]
      }
   ]
}

從 AWS CLI 執行下列命令。


aws ssm get-inventory --cli-input-json file://input.json

該命令會傳回相關資訊，如以下所示。

{
   "Entities":[
      {
         "Data":{
            "Application":{
               "Content":[
                  {
                     "notMatchingCount":"2"
                  },
                  {
                     "matchingCount":"2"
                  }
               ]
            },
            "File":{
               "Content":[
                  {
                     "notMatchingCount":"2"
                  },
                  {
                     "matchingCount":"2"
                  }
               ]
            },
            "Network":{
               "Content":[
                  {
                     "notMatchingCount":"3"
                  },
                  {
                     "matchingCount":"1"
                  }
               ]
            }
         }
      }
   ]
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用篩選條件查詢清查收集

使用自訂庫存