View a markdown version of this page

Amazon EC2 实例的运行时覆盖率和故障排除 - 亚马逊 GuardDuty
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon EC2 实例的运行时覆盖率和故障排除

对于 Amazon EC2 资源,运行时间覆盖率是在实例级别评估的。亚马逊 EC2 的承保范围还反映了在亚马逊 EC2 实例上运行的亚马逊 ECS 集群的实例级状态。

查看覆盖率统计数据

您的账户和成员账户中 Amazon EC2 实例的覆盖率统计数据是所选实例中运行状况良好的实例的百分比 Amazon Web Services 区域:

(健康 instances/All 实例) *100

选择一种访问方法来查看您账户的覆盖率统计数据。

Console
  • 登录 Amazon Web Services 管理控制台 然后打开 GuardDuty 控制台在 https://console.aws.amazon.com/guardduty/。

  • 在导航窗格中,选择运行时监控。

  • 选择运行时覆盖率选项卡。

  • 您可以在 EC2 实例运行时覆盖率选项卡下查看覆盖率统计数据,按实例列表中可用的每个 Amazon EC2 实例的覆盖率状态汇总。

    • 您可以按以下列筛选实例列表:

      • 账户 ID

      • 代理管理类型

      • 代理版本

      • 覆盖状态

      • 实例 ID

      • 集群 ARN

  • 如果任何 EC2 实例的覆盖率状态为不正常,则问题列可能包含有关不正常状态原因的其他信息。

API/CLI
  • 运行 ListCoverage 带有您自己的有效探测器 ID、当前区域和服务终端节点的 API。您可以使用此 API 对实例列表进行筛选和排序。

    • 您可以使用以下 CriterionKey 选项之一更改示例 filter-criteria:

      • ACCOUNT_ID

      • RESOURCE_TYPE

      • COVERAGE_STATUS

      • AGENT_VERSION

      • MANAGEMENT_TYPE

      • INSTANCE_ID

      • CLUSTER_ARN

    • 当 filter-criteria 包含 RESOURCE_TYPE 为 EC2 的条件时,运行时监控将不支持将 ISSUE 作为 AttributeName。如果您使用该属性,API 响应将导致 InvalidInputException。

      您可以使用以下选项更改 sort-criteria 中的示例 AttributeName:

      • ACCOUNT_ID

      • COVERAGE_STATUS

      • INSTANCE_ID

      • UPDATED_AT

    • 你可以更改 max-results (最多 50 个)。

    • 要找到 detectorId 有关您的账户和当前地区,请参阅 设置 中的页面 https://console.aws.amazon.com/guardduty/ 控制台,或者运行 ListDetectors API。

    aws guardduty --region us-east-1 list-coverage --detector-id 12abc34d567e8fa901bc2d34e56789f0 --sort-criteria '{"AttributeName": "EKS_CLUSTER_NAME", "OrderBy": "DESC"}' --filter-criteria '{"FilterCriterion":[{"CriterionKey":"ACCOUNT_ID", "FilterCondition":{"EqualsValue":"111122223333"}}] }' --max-results 5
  • 运行 GetCoverageStatistics 用于检索覆盖率汇总统计数据的 API statisticsType。

    • 您可以使用以下选项之一更改示例 statisticsType:

      • COUNT_BY_COVERAGE_STATUS:表示按覆盖状态汇总的 EKS 集群的覆盖率统计数据。

      • COUNT_BY_RESOURCE_TYPE — 根据类型汇总的覆盖率统计数据 Amazon 列表中的资源。

      • 您可以在命令中更改示例 filter-criteria。您可以对 CriterionKey 使用以下选项:

        • ACCOUNT_ID

        • RESOURCE_TYPE

        • COVERAGE_STATUS

        • AGENT_VERSION

        • MANAGEMENT_TYPE

        • INSTANCE_ID

        • CLUSTER_ARN

    • 要找到 detectorId 有关您的账户和当前地区,请参阅 设置 中的页面 https://console.aws.amazon.com/guardduty/ 控制台,或者运行 ListDetectors API。

    aws guardduty --region us-east-1 get-coverage-statistics --detector-id 12abc34d567e8fa901bc2d34e56789f0 --statistics-type COUNT_BY_COVERAGE_STATUS --filter-criteria '{"FilterCriterion":[{"CriterionKey":"ACCOUNT_ID", "FilterCondition":{"EqualsValue":"123456789012"}}] }'

如果 EC2 实例的覆盖率状态为不正常,请参阅对 Amazon EC2 运行时覆盖率问题进行故障排除。

承保状态变更为 EventBridge 通知

Amazon EC2 实例的覆盖率状态可能显示为不正常。要检测覆盖率状态何时变为不正常,我们建议您定期监控覆盖率状态,并在状态变为不正常时进行故障排除。或者,你可以创建一个亚马逊 EventBridge 规则是当保险状态从任一保险状态发生变化时收到通知 不健康 到 健康 或者以其他方式。默认情况下, GuardDuty 将其发布在 EventBridge 公共汽车 用于您的账户。

示例通知架构

在一个 EventBridge 规则,您可以使用预定义的示例事件和事件模式来接收保险状态通知。有关创建的更多信息 EventBridge 规则,参见 创建规则 在 亚马逊 EventBridge 用户指南。

此外,您还可以使用以下示例通知架构来创建自定义事件模式。确保替换账户的值。当您的 Amazon EC2 实例的覆盖范围状态更改时收到通知 Healthy 到 Unhealthy,那个 detail-type 应该是 GuardDuty Runtime Protection Unhealthy。在承保状态更改时收到通知 Unhealthy 到 Healthy,替换的值 detail-type 和 GuardDuty Runtime Protection Healthy。

{ "version": "0", "id": "event ID", "detail-type": "GuardDuty Runtime Protection Unhealthy", "source": "aws.guardduty", "account": "Amazon Web Services 账户 ID", "time": "event timestamp (string)", "region": "Amazon Web Services 区域", "resources": [ ], "detail": { "schemaVersion": "1.0", "resourceAccountId": "string", "currentStatus": "string", "previousStatus": "string", "resourceDetails": { "resourceType": "EC2", "ec2InstanceDetails": { "instanceId":"", "instanceType":"", "clusterArn": "", "agentDetails": { "version":"" }, "managementType":"" } }, "issue": "string", "lastUpdatedAt": "timestamp" } }

对 Amazon EC2 运行时覆盖率问题进行故障排除

如果 Amazon EC2 实例的覆盖率状态为不正常,则可以在问题列下查看原因。

如果 EC2 实例与某个 EKS 集群关联,并且手动或通过自动代理配置安装了 EKS 安全代理,则要对覆盖率问题进行故障排除,请参阅Amazon EKS 集群的运行时覆盖率和故障排除。

下表列举了问题类型和相应的故障排除步骤。

问题类型 问题消息 故障排除步骤

无代理报告

正在等待 SSM 通知

接收 SSM 通知可能需要几分钟时间。

确保 Amazon EC2 实例是由 SSM 托管的。有关更多信息,请参阅以下步骤 方法 1-通过使用 Amazon 系统经理 在 手动安装安全代理。

(特意留空)

如果你正在管理 GuardDuty 手动使用安全代理,确保按照以下步骤操作 手动管理 Amazon EC2 资源的安全代理。

如果您启用了自动代理配置:

如果您的亚马逊 VPC 使用 guardduty-data 亚马逊 VPC 终端节点,验证您的亚马逊 EC2 实例的 VPC 终端节点配置是否正确。有关更多信息,请参阅 验证 VPC 端点配置。

如果您的组织设置了服务控制策略(SCP),请验证权限边界未限制 guardduty:SendSecurityTelemetry 权限。有关更多信息,请参阅 在多账户环境中验证组织服务控制策略。

代理已断开连接

  • 查看安全代理的状态。有关更多信息,请参阅 正在验证 GuardDuty 安全客户端安装状态。

  • 查看安全代理日志以确定可能的根本原因。日志提供了详细的错误信息,您可以使用这些信息来自行排查问题。这些文件位于 /var/log/amzn-guardduty-agent/ 下。

    完成 sudo journalctl -u amazon-guardduty-agent。

未预置代理

带有排除标签的实例将排除在运行时监控之外。

GuardDuty 不接收来自使用排除标签启动的 Amazon EC2 实例的运行时事件 GuardDutyManaged:false。

要接收来自此 Amazon EC2 实例的运行时事件,请移除排除标签。

内核版本低于支持的版本。

有关各操作系统分发支持的内核版本的信息,请参阅验证架构要求,了解 Amazon EC2 实例。

内核版本高于支持的版本。

有关各操作系统分发支持的内核版本的信息,请参阅验证架构要求,了解 Amazon EC2 实例。

无法检索实例身份文档。

按照以下步骤进行操作:

  1. 确认您的资源是 Amazon EC2 实例,而不是混合的非 EC2 实例。

  2. 确认实例元数据服务(IMDS)已启用。为此,请参阅《Amazon EC2 用户指南》中的配置实例元数据服务选项。

  3. 验证实例身份文档是否存在。为此,请参阅《Amazon EC2 用户指南》中的检索实例身份文档。

  4. 如果实例身份文档仍然不存在,则重启实例。实例身份文档在实例停止并启动、重新启动或启动时生成。

创建 SSM 关联失败

GuardDuty 您的账户中已存在 SSM 关联

  1. 手动删除现有的关联。有关更多信息,请参阅《Amazon Systems Manager 用户指南》中的删除关联。

  2. 删除关联后,禁用然后重新启用 GuardDuty 亚马逊 EC2 的自动代理配置。

您的账户有太多的 SSM 关联

请选择以下两个选项之一:

  • 删除任何未使用的 SSM 关联。有关更多信息,请参阅《Amazon Systems Manager 用户指南》中的删除关联。

  • 检查您的账户是否有资格申请增加配额。有关信息,请参阅《Amazon Web Services 一般参考》中的 Systems Manager Service quotas。

更新 SSM 关联失败

GuardDuty 您的账户中不存在 SSM 关联

GuardDuty 您的账户中没有 SSM 关联。禁用运行时监控,然后重新启用。

删除 SSM 关联失败

GuardDuty 您的账户中不存在 SSM 关联

您的账户中不存在该 SSM 关联。如果 SSM 关联已被有意删除,则无需执行任何操作。

SSM 实例关联执行失败

不满足架构要求或其他先决条件。

有关经验证的操作系统发行版的信息,请参阅 Amazon EC2 实例支持的先决条件。

如果您仍然遇到此问题,以下步骤将有助您识别和潜在解决问题:

  1. 打开 Amazon Systems Manager 控制台在 https://console.aws.amazon.com/systems-manager/。

  2. 在导航窗格中的节点管理下,选择状态管理器。

  3. 按文档名称属性筛选并输入 AmazonGuardDuty-ConfigureRuntimeMonitoringSsmPlugin。

  4. 选择相应的关联 ID 并查看其执行历史记录。

  5. 使用执行历史记录,查看失败的记录,确定可能的根本原因,然后尝试解决问题。

VPC 端点创建失败

共享 VPC 不支持创建 VPC 终端节点 vpcId

运行时监控支持在组织内使用共享 VPC。有关更多信息,请参阅 使用带运行时监控功能的共享 VPC。

仅在将自动代理配置与共享 VPC 结合使用时

所有者账户 ID 111122223333 用于共享 VPC vpcId 没有启用运行时监控、自动代理配置,或两者都启用

共享 VPC 所有者账户必须至少为一种资源类型 [Amazon EKS 或 Amazon ECS(Amazon Fargate)] 启用运行时监控和自动代理配置。有关更多信息,请参阅 特定于的先决条件 GuardDuty 运行时监控。

启用私有 DNS 需要两者 enableDnsSupport 和 enableDnsHostnames VPC 属性设置为 true 为了 vpcId (服务:Ec2,状态 Code:400,请求 ID: a1b2c3d4-5678-90ab-cdef-EXAMPLE11111)。

确保以下 VPC 属性设置为 true – enableDnsSupport 和 enableDnsHostnames。有关更多信息,请参阅 VPC 中的 DNS 属性。

如果你使用亚马逊 VPC 控制台,网址为 https://console.aws.amazon.com/vpc/ 创建亚马逊 VPC,然后选择两者 启用 DNS 主机名 和 启用 DNS 解析。有关更多信息,请参阅 VPC 配置选项。

更新 VPC 属性后,必须通过进行以下更改之一来加快 VPC 端点创建的重试速度:

  • 您可以为 Amazon EC2 实例添加或修改 GuardDutyManaged 标签(推荐)。例如,您可以添加 GuardDutyManaged:true,进而包含运行时监控的实例。

  • 您可以更改 Amazon EC2 实例的状态(停止或重启)。

VPC 端点删除失败

不允许删除账户 ID 的共享 VPC 终端节点 111122223333,共享 VPC vpcId,所有者账户 ID 555555555555。

可能的步骤:
  • 禁用共享 VPC 参与者账户的运行时监控状态不会影响共享 VPC 端点策略和所有者账户中存在的安全组。

    要删除共享 VPC 端点和安全组,您必须在共享 VPC 所有者账户中禁用运行时监控或自动代理配置状态。

  • 共享 VPC 参与者账户无法删除共享 VPC 端点和共享 VPC 所有者账户中托管的安全组。

代理未报告

(特意留空)

对该问题类型的支持已经终止。如果您继续遇到此问题但尚未这样做,请启用 GuardDuty 亚马逊 EC2 的自动代理。

如果问题仍然存在,可考虑禁用运行时监控几分钟,然后重新启用。