Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon IoT Greengrass Version 12023 年 6 月 30 日进入延长寿命阶段。有关更多信息，请参阅Amazon IoT Greengrass V1维护政策。在此日期之后，Amazon IoT Greengrass V1不会发布提供功能、增强功能、错误修复或安全补丁的更新。在上运行的设备Amazon IoT Greengrass V1不会受到干扰，将继续运行并连接到云端。我们强烈建议你迁移到Amazon IoT Greengrass Version 2，它补充说重要的新功能和支持其他平台。

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

从Amazon IoT Greengrass核心设备收集系统运行状况遥测数据

系统健康遥测数据是诊断数据，可以帮助您监控 Greengrass 核心设备上关键操作的性能。Greengrass 核心上的遥测代理收集本地遥测数据并将其发布到亚马逊， EventBridge 无需客户进行任何互动。核心设备会尽最大努力将 EventBridge 遥测数据发布到。例如，核心设备在离线时可能无法提供遥测数据。

您可以创建项目和应用程序来检索、分析、转换和报告边缘设备上的遥测数据。领域专家，例如工艺工程师，可以使用这些应用程序来深入了解机队的健康状况。

为确保 Greengrass 边缘组件正常运行，将数据用于开发和质量改进目的。Amazon IoT Greengrass此功能还有助于为新的和增强的边缘功能提供信息。 Amazon IoT Greengrass最多只能将遥测数据保留七天。

此功能在Amazon IoT Greengrass Core 软件 v1.11.0 中可用，所有 Greengrass 内核（包括现有内核）默认启用。一旦升级到Amazon IoT Greengrass Core 软件 v1.11.0 或更高版本，就会自动开始接收数据。

有关如何访问或管理已发布的遥测数据的信息，请参阅订阅接收遥测数据。

遥测代理收集并发布以下系统指标。

配置遥测设置

Greengrass 遥测使用以下设置：

您可以为 Greengrass 核心设备启用或禁用遥测功能。 Amazon IoT Greengrass使用阴影来管理遥测配置。当内核连接到时，您的更改会立即生效Amazon IoT Core。

遥测代理使用 MQTT 协议发布数据，服务质量 (QoS) 级别为 0。这意味着它不会确认交付或重试发布尝试。遥测消息与发往的订阅的其他消息共享 MQTT 连接Amazon IoT Core。

除了您的数据链路成本外，从核心向内核传输数据Amazon IoT Core是免费的。这是因为代理向Amazon保留主题发布内容。但是，根据您的用例，您在接收或处理数据时可能会产生费用。

要求

配置遥测设置时，以下要求适用：

配置遥测设置（控制台）

以下显示了如何在Amazon IoT Greengrass控制台中更新 Greengrass 核心的遥测设置。

更改在运行时生效。您不需要部署群组。

配置遥测设置 (CLI)

在Amazon IoT Greengrass API 中，该TelemetryConfiguration对象表示 Greengrass 核心的遥测设置。该对象是与核心相关的RuntimeConfiguration对象的一部分。您可以使用Amazon IoT Greengrass API 或Amazon SDK 来管理 Greengrass 遥测。Amazon CLI本节中的示例使用Amazon CLI。

TelemetryConfiguration 物体

该TelemetryConfiguration对象具有以下属性：

订阅接收遥测数据

您可以在亚马逊中创建规则 EventBridge ，定义如何处理从 Greengrass 核心设备发布的遥测数据。 EventBridge 收到数据时，它会调用规则中定义的目标操作。例如，您可以创建事件规则来发送通知、存储事件信息、采取纠正措施或调用其他事件。

遥测事件

包括遥测数据在内的部署状态更改事件使用以下格式：

{
    "version": "0",
    "id": "f70f943b-9ae2-e7a5-fec4-4c22178a3e6a",
    "detail-type": "Greengrass Telemetry Data",
    "source": "aws.greengrass",
    "account": "123456789012",
    "time": "2020-07-28T20:45:53Z",
    "region": "us-west-1",
    "resources": [],
    "detail": {
        "ThingName": "CoolThing",
        "Schema": "2020-06-30",
        "ADP": [
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToKinesis",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToS3ExportTaskExecutor",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToHTTP",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToIoTAnalytics",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "StreamManager",
                "M": [
                    {
                        "N": "BytesAppended|BytesUploadedToIoTSiteWise",
                        "Sum": 11,
                        "U": "Bytes"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function",
                "M": [
                    {
                        "N": "LambdaTimeout",
                        "Sum": 15,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 123231546,
                "NS": "CloudSpooler",
                "M": [
                    {
                        "N": "DroppedMessageCount",
                        "Sum": 15,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 1593727692,
                "NS": "SystemMetrics",
                "M": [
                    {
                        "N": "SystemMemUsage",
                        "Sum": 11.23,
                        "U": "Megabytes"
                    },
                    {
                        "N": "CpuUsage",
                        "Sum": 35.63,
                        "U": "Percent"
                    },
                    {
                        "N": "TotalNumberOfFDs",
                        "Sum": 416,
                        "U": "Count"
                    }
                ]
            },
            {
                "TS": 1593727692,
                "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function",
                "M": [
                    {
                        "N": "LambdaOutOfMemory",
                        "Sum": 12,
                        "U": "Count"
                    },
                    {
                        "N": "LambdaUngracefullyKilled",
                        "Sum": 100,
                        "U": "Count"
                    },
                    {
                        "N": "LambdaError",
                        "Sum": 7,
                        "U": "Count"
                    }
                ]
            }
        ]
    }
}

该ADP数组包含具有以下属性的聚合数据点列表：

创建 EventBridge 规则的先决条件

在为其创建 EventBridge 规则之前Amazon IoT Greengrass，您应执行以下操作：

有关更多信息，请参阅什么是 Amazon EventBridge？ 以及《亚马逊 EventBridge 用户指南》 EventBridge中的 “亚马逊入门”。

创建事件规则以获取遥测数据（控制台）

使用以下步骤Amazon Web Services Management Console来创建接收 Greengrass 核心发布的遥测数据的 EventBridge 规则。这样，Web 服务器、电子邮件地址和其他主题订阅者就可以响应事件。有关更多信息，请参阅《亚马逊 EventBridge 用户指南》中的创建在Amazon资源事件时触发的 EventBridge 规则。

创建事件规则以获取遥测数据 (CLI)

使用以下步骤Amazon CLI来创建接收 Greengrass 核心发布的遥测数据的 EventBridge 规则。这样，Web 服务器、电子邮件地址和其他主题订阅者就可以响应事件。

有关更多信息，请参阅《亚马逊 EventBridge 用户指南》 EventBridge中的事件和事件模式。

Amazon IoT Greengrass遥测疑难解答

可以使用以下信息帮助解决配置Amazon IoT Greengrass遥测问题。

错误：运行 get-thing-runtime-configuration 命令后，响应包含ConfigurationStatusOutOfSync “:”

解决方案：