使用 Amazon CloudWatch 日志进行监控 - Amazon IoT SiteWise
管理登录 Amazon IoT SiteWise示例： Amazon IoT SiteWise 日志文件条目
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 Amazon CloudWatch 日志进行监控

配置 Amazon IoT SiteWise 为将信息记录到 CloudWatch 日志，以监控服务并对其进行故障排除。

使用 Amazon IoT SiteWise 控制台时， Amazon IoT SiteWise 会创建一个服务相关角色，允许服务代表您记录信息。如果您不使用 Amazon IoT SiteWise 控制台，则必须手动创建服务相关角色才能接收日志。有关更多信息，请参阅 为创建服务相关角色 Amazon IoT SiteWise。

您必须有一个允许将日志事件放 Amazon IoT SiteWise 入 CloudWatch 流中的资源策略。要创建和更新 CloudWatch 日志的资源策略，请运行以下命令。logging-policy-name替换为要创建的策略的名称。

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"

CloudWatch 日志还支持 a ws: SourceArn 和 a ws: SourceAccount 条件上下文密钥。这些条件上下文键是可选的。

要创建或更新仅允许 Amazon IoT SiteWise 将与指定资源关联的日志放入 CloudWatch 流的 Amazon IoT SiteWise 资源策略，请运行命令并执行以下操作：

  • logging-policy-name替换为要创建的策略的名称。

  • source-ARN替换为 Amazon IoT SiteWise 资源的 ARN，例如资产模型或资产。要查找每种 Amazon IoT SiteWise 资源类型的 ARN，请参阅《服务授权参考》 Amazon IoT SiteWise中定义的资源类型。

  • 替换为account-ID与指定 Amazon IoT SiteWise 资源关联的 Amazon 账户 ID。

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"

默认情况下， Amazon IoT SiteWise 不将信息记录到 CloudWatch 日志。要激活日志记录，请选择 “禁用” (OFF) 以外的日志级别。 Amazon IoT SiteWise 支持以下日志级别：

  • OFF – 日志记录处于关闭状态。

  • ERROR – 记录错误。

  • INFO – 记录错误和信息性消息。

您可以将 SiteWise Edge 网关配置为通过 Lo CloudWatch gs 记录信息 Amazon IoT Greengrass。有关更多信息，请参阅 监控 SiteWise 边缘网关日志。

如果 Amazon IoT Core 要对 Amazon IoT SiteWise 规则操作进行故障排除，也可以配置为将信息 CloudWatch 记录到日志。有关更多信息，请参阅 对 Amazon IoT SiteWise 规则操作进行故障排除。

管理登录 Amazon IoT SiteWise

使用 Amazon IoT SiteWise 控制台或 Amazon CLI 执行以下日志配置任务。

查找日志记录级别

Console

使用以下过程可在 Amazon IoT SiteWise 控制台中查找当前的日志记录级别。

要查找您当前的 Amazon IoT SiteWise 日志级别

  1. 导航至 Amazon IoT SiteWise 控制台。

  2. 在左侧导航窗格中，选择日志记录选项。

    当前日志记录状态显示在日志记录状态下。如果已激活日志记录，则当前日志记录级别将显示在详细程度级别下。

Amazon CLI

运行以下命令以查找您当前的 Amazon IoT SiteWise 日志记录级别 Amazon CLI。

aws iotsitewise describe-logging-options

此操作将采用以下格式返回包含日志记录级别的响应。

{
  "loggingOptions": {
    "level": "String"
  }
}

更改日志记录级别

使用以下步骤在 Amazon IoT SiteWise 控制台或使用中更改日志记录级别 Amazon CLI。

Console
更改您的 Amazon IoT SiteWise 日志级别

  1. 导航至 Amazon IoT SiteWise 控制台。

  2. 在左侧导航窗格中，选择日志记录选项。

  3. 选择编辑。

  4. 选择要激活的详细程度级别。

  5. 选择保存。

Amazon CLI

运行以下 Amazon CLI 命令来更改您的 Amazon IoT SiteWise 日志级别。logging-level替换为所需的日志级别。

aws iotsitewise put-logging-options --logging-options level=logging-level

示例： Amazon IoT SiteWise 日志文件条目

每个 Amazon IoT SiteWise 日志条目都包含事件信息和该事件的相关资源，因此您可以了解和分析日志数据。

以下示例显示了成功创建资产模型时 Amazon IoT SiteWise 记录的 CloudWatch 日志条目。

{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}