AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

配置清单收集

本部分介绍了如何使用 Amazon EC2 控制台在一个或多个托管实例上配置清单收集。本部分还介绍如何使用 Systems Manager 资源数据同步在单个 Amazon S3 存储桶中聚合多个 AWS 账户和区域的清单数据。有关如何使用 AWS CLI 来配置清单收集的示例,请参阅Systems Manager Inventory Manager 演练

开始前的准备工作

配置清单收集前,请完成以下任务。

  • 更新需要清点的实例上的 SSM 代理。通过运行最新版本的 SSM 代理,可确保您能够收集所有支持的清单类型的元数据。有关如何使用 状态管理器 更新 SSM 代理 的信息,请参阅演练:自动更新 SSM 代理 (CLI)

  • 验证您的实例是否满足 Systems Manager 先决条件。有关更多信息,请参阅 Systems Manager 先决条件

  • (可选) 创建用于收集自定义清单的 JSON 文件。有关更多信息,请参阅 使用自定义清单

配置收集

请按照以下过程使用控制台配置对托管实例的清单收集。

注意

配置清单收集时,首先创建 Systems Manager 状态管理器 关联。Systems Manager 会在关联运行时收集清单数据。如果您不先创建关联,并试图使用 Run Command 等调用 aws:softwareInventory 插件,则系统会返回以下错误:

The aws:softwareInventory plugin can only be invoked via ssm-associate.

还要注意,一个实例一次只能配置一个 Inventory 关联。如果您为实例配置了两个或更多关联,则关联不会运行,而且系统不会收集清单数据。

配置清单收集 ()

  1. https://console.amazonaws.cn/systems-manager/ 上打开 AWS Systems Manager 控制台。

  2. 在导航窗格中,选择 Inventory

    -或者-

    如果 AWS Systems Manager 主页首先打开,请选择菜单图标 ( ) 以打开导航窗格,然后在导航窗格中选择 Inventory

  3. 选择设置清单

  4. Targets 部分中,通过手动指定标签或选择实例来标识您要运行此操作的实例。

    注意

    如果使用标签,则将来使用相同标签创建的所有实例也将报告清单。

  5. 计划部分,选择您希望系统从实例中收集清单元数据的频率。

  6. Parameters 部分,使用列表启用或禁用不同类型的清单收集。如果要针对文件Windows 注册表创建清单搜索,请参阅以下示例。

    文件

    • 在 Linux 上,会收集 /home/ec2-user 目录 (不包括所有子目录) 中的 .sh 文件中的元数据。

      [{"Path":"/home/ec2-user","Pattern":["*.sh", "*.sh"],"Recursive":false}]
    • 在 Windows 上,会以递归方式收集程序文件夹 (包括子目录) 中的所有“.exe”文件的元数据。

      [{"Path":"C:\Program Files","Pattern":["*.exe"],"Recursive":true}]
    • 在 Windows 上,会收集指定日志模式的元数据。

      [{"Path":"C:\ProgramData\Amazon","Pattern":["*amazon*.log"],"Recursive":true}]
    • 在执行递归集合时会限制目录计数。

      [{"Path":"C:\Users","Pattern":["*.ps1"],"Recursive":true, "DirScanLimit": 1000}]

    Windows 注册表

    • 以递归方式针对特定路径收集所有键和值。

      [{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon","Recursive": true}]
    • 针对特定路径收集所有键和值 (禁用递归搜索)。

      [{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Intel\PSIS\PSIS_DECODER", "Recursive": false}]
    • 使用 ValueNames 选项收集特定键。

      {"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\MachineImage","ValueNames":["AMIName"]}

    有关收集文件和 Windows 注册表清单的更多信息,请参阅使用文件和 Windows 注册表清单

  7. 如果需要在 Amazon S3 存储桶中存储关联执行状态,请在 Advanced 部分中选择 Sync inventory execution logs to an S3 bucket

  8. 选择设置清单。Systems Manager 创建一个 状态管理器 关联并立即在指定或目标实例上运行清单。

  9. 在导航窗格中,选择 状态管理器。验证是否使用 AWS-GatherSoftwareInventory 文档创建了新的关联。此外,确认 Status 字段显示 Success。如果选择 Sync inventory execution logs to an S3 bucket 选项,则过几分钟后,可以在 Amazon S3 中查看日志数据。要查看特定实例的清单数据,请在导航窗格中选择 Managed Instances

  10. 选择一个实例,然后选择 View details

  11. 在实例详细信息页面上,选择 Inventory。使用 Inventory type 列表筛选清单。

在配置清单收集后,我们建议您配置 Systems Manager 资源数据同步。资源数据同步将所有清单数据集中在目标 Amazon S3 存储桶中,当收集新的清单数据时,将会自动更新中央存储。所有清单数据存储在目标 Amazon S3 存储桶中后,您可以使用 Amazon Athena 和 Amazon QuickSight 等服务查询和分析聚合数据。有关更多信息,请参阅 配置清单的资源数据同步

本页内容: