终止支持通知：2026 年 10 月 7 日， AWS 将停止对的支持。 AWS IoT Greengrass Version 1 2026 年 10 月 7 日之后，您将无法再访问这些 AWS IoT Greengrass V1 资源。如需了解更多信息，请访问迁移自 AWS IoT Greengrass Version 1。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Device Defender 连接器
Device Defender 连接器向管理员通知 Greengrass 核心设备状态的变化。这有助于识别可能指示受损设备的异常行为。
此连接器从核心设备上的/proc目录中读取系统指标，然后将指标发布到 AWS IoT Device Defender。有关指标报告的详细信息，请参阅AWS IoT 开发人员指南中的设备指标文档规范。
此连接器具有以下版本。
版本 |
ARN |
|---|---|
3 |
|
2 |
|
1 |
|
有关版本更改的信息，请参阅更改日志。
要求
此连接器具有以下要求：
连接器参数
该连接器提供以下参数：
SampleIntervalSeconds-
收集和报告指标的每个周期之间的秒数。最小值为 300 秒 (5 分钟)。
AWS IoT 控制台中的显示名称：指标报告间隔
必需：
true类型：
string有效模式：
^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$ ProcDestinationPath-ResourceId-
/proc卷资源的 ID。注意
此连接器被授予对该资源的只读访问权限。
AWS IoT 控制台中的显示名称：/proc 目录的资源
必需：
true类型：
string有效模式：
[a-zA-Z0-9_-]+ ProcDestinationPath-
/proc卷资源的目标路径。AWS IoT 控制台中的显示名称：/proc 资源的目标路径
必需：
true类型：
string有效模式：
\/[a-zA-Z0-9_-]+
创建连接器示例 (AWS CLI)
以下 CLI 命令创建一个 ConnectorDefinition，其初始版本包含 Device Defender 连接器。
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyDeviceDefenderConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/DeviceDefender/versions/3", "Parameters": { "SampleIntervalSeconds": "600", "ProcDestinationPath": "/host_proc", "ProcDestinationPath-ResourceId": "my-proc-resource" } } ] }'
注意
此连接器中的 Lambda 函数的生命周期很长。
在 AWS IoT Greengrass 控制台中，您可以从群组的 “连接器” 页面添加连接器。有关更多信息，请参阅 Greengrass 连接器入门（控制台）。
输入数据
该连接器不接受 MQTT 消息作为输入数据。
输出数据
此连接器将安全指标 AWS IoT Device Defender 作为输出数据发布到。
- 订阅中的主题筛选条件
-
$aws/things/+/defender/metrics/json注意
这是 AWS IoT Device Defender 预期的主题语法。连接器将
+通配符替换为设备名称（例如，$aws/things/）。thing-name/defender/metrics/json - 示例输出
-
有关指标报告的详细信息，请参阅AWS IoT 开发人员指南中的设备指标文档规范。
{ "header": { "report_id": 1529963534, "version": "1.0" }, "metrics": { "listening_tcp_ports": { "ports": [ { "interface": "eth0", "port": 24800 }, { "interface": "eth0", "port": 22 }, { "interface": "eth0", "port": 53 } ], "total": 3 }, "listening_udp_ports": { "ports": [ { "interface": "eth0", "port": 5353 }, { "interface": "eth0", "port": 67 } ], "total": 2 }, "network_stats": { "bytes_in": 1157864729406, "bytes_out": 1170821865, "packets_in": 693092175031, "packets_out": 738917180 }, "tcp_connections": { "established_connections":{ "connections": [ { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" }, { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" } ], "total": 2 } } } }
许可证
该连接器在 Greengrass Core 软件许可协议
更改日志
下表介绍每个版本连接器的更改。
版本 |
更改 |
|---|---|
3 |
已将 Lambda 运行时升级到 Python 3.7，这会更改运行时要求。 |
2 |
进行了修复，以减少过多的日志记录。 |
1 |
首次发布。 |
Greengrass 组在一个时间上只能包含一个版本的连接器。有关升级连接器版本的信息，请参阅升级连接器版本。
另请参阅
-
《AWS IoT 开发人员指南》中的 Device Defender
