Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
CloudWatch Metriken
Die CloudWatch Amazon-Metrikkomponente (aws.greengrass.Cloudwatch) veröffentlicht benutzerdefinierte Metriken von Greengrass-Kerngeräten für Amazon CloudWatch. Die Komponente ermöglicht es Komponenten, CloudWatch Metriken zu veröffentlichen, mit denen Sie die Umgebung des Greengrass-Kerngeräts überwachen und analysieren können. Weitere Informationen finden Sie unter Verwenden von CloudWatch Amazon-Metriken im CloudWatch Amazon-Benutzerhandbuch.
Um eine CloudWatch Metrik mit dieser Komponente zu veröffentlichen, veröffentlichen Sie eine Nachricht zu einem Thema, für das sich diese Komponente angemeldet hat. Standardmäßig abonniert diese Komponente das cloudwatch/metric/put lokale publish/subscribe Thema. Sie können andere Themen, einschließlich AWS IoT Core MQTT-Themen, angeben, wenn Sie diese Komponente bereitstellen.
Diese Komponente sammelt Stapel von Metriken, die sich im selben Namespace befinden, und veröffentlicht sie in regelmäßigen CloudWatch Abständen.
Diese Komponente bietet ähnliche Funktionen wie der CloudWatch Metrik-Connector in AWS IoT Greengrass V1. Weitere Informationen finden Sie unter CloudWatch Metrics Connector im AWS IoT Greengrass V1 Developer Guide.
Versionen
Diese Komponente hat die folgenden Versionen:
-
4.0.x
-
3.2.x
-
3.1.x
-
3.0.x
-
2.1.x
-
2.0.x
Informationen zu den Änderungen in den einzelnen Versionen der Komponente finden Sie im Changelog.
Typ
- v4.x - v3.x
-
Diese Komponente ist eine generische Komponente (aws.greengrass.generic). Der Greengrass-Kern führt die Lifecycle-Skripte der Komponente aus.
- v2.x
-
Diese Komponente ist eine Lambda-Komponente (aws.greengrass.lambda). Der Greengrass-Nukleus führt die Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.
Weitere Informationen finden Sie unter Komponententypen.
Betriebssystem
- v4.x - v3.x
-
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
- v2.x
-
Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.
Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
- v4.x - v3.x
-
-
https://www.python.org/Python-Version 3.7 wurde auf dem Kerngerät installiert und der PATH-Umgebungsvariablen hinzugefügt.
-
Die folgenden Python-Bibliotheken, einschließlich aller Abhängigkeiten, müssen installiert sein und für den Benutzer verfügbar sein, der die Komponente ausführt:
Sie können die UseInstaller Konfiguration so einstellen, dass true diese Bibliotheken automatisch in der bereitgestellten Python-Umgebung installiert werden.
-
Die Greengrass-Geräterolle muss die cloudwatch:PutMetricData Aktion zulassen, wie im folgenden Beispiel für eine IAM-Richtlinie gezeigt.
JSON
- JSON
-
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"cloudwatch:PutMetricData"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
Weitere Informationen finden Sie in der Referenz zu CloudWatch Amazon-Berechtigungen im CloudWatch Amazon-Benutzerhandbuch.
- 2.x
-
-
Ihr Hauptgerät muss die Anforderungen erfüllen, um Lambda-Funktionen ausführen zu können. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter Anforderungen an die Lambda-Funktion.
-
https://www.python.org/Python-Version 3.7 wurde auf dem Kerngerät installiert und der PATH-Umgebungsvariablen hinzugefügt.
-
Die Greengrass-Geräterolle muss die cloudwatch:PutMetricData Aktion zulassen, wie im folgenden Beispiel für eine IAM-Richtlinie gezeigt.
JSON
- JSON
-
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"cloudwatch:PutMetricData"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
Weitere Informationen finden Sie in der Referenz zu CloudWatch Amazon-Berechtigungen im CloudWatch Amazon-Benutzerhandbuch.
-
Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie das folgende Konfigurationsupdate für die ältere Abonnement-Router-Komponente (aws.greengrass.LegacySubscriptionRouter) zusammenführen, wenn Sie diese Komponente bereitstellen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.
Legacy subscription router v2.1.xLegacy subscription router v2.0.x
- Legacy subscription router v2.1.x
{
"subscriptions": {
"aws-greengrass-cloudwatch": {
"id": "aws-greengrass-cloudwatch",
"source": "component:aws.greengrass.Cloudwatch",
"subject": "cloudwatch/metric/put/status",
"target": "cloud"
}
}
}
- Legacy subscription router v2.0.x
{
"subscriptions": {
"aws-greengrass-cloudwatch": {
"id": "aws-greengrass-cloudwatch",
"source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version",
"subject": "cloudwatch/metric/put/status",
"target": "cloud"
}
}
}
-
regionErsetzen Sie durch das AWS-Region , was Sie verwenden.
-
versionErsetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der AWS IoT Greengrass Konsole und suchen Sie nach dem Schlüssel-Wert-Paar der Lambda-Funktion. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.
Sie müssen die Lambda-Funktionsversion auf dem älteren Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.
Weitere Informationen finden Sie unter Erstellen von Bereitstellungen.
Endpunkte und Ports
Diese Komponente muss in der Lage sein, ausgehende Anfragen an die folgenden Endpunkte und Ports auszuführen, zusätzlich zu den Endpunkten und Ports, die für den Basisbetrieb erforderlich sind. Weitere Informationen finden Sie unter Geräteverkehr über einen Proxy oder eine Firewall zulassen.
| Endpoint |
Port |
Erforderlich |
Description |
|
monitoring.region.amazonaws.com
|
443 |
Ja |
Metriken hochladen. CloudWatch
|
Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, werden AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereitgestellt. Das bedeutet, dass Sie die Anforderungen für die Komponente und alle ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitzustellen. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können die Abhängigkeiten für jede Version der Komponente auch in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.
- 4.0.0 - 3.0.0
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 4.0.0 bis 3.0.0 dieser Komponente aufgeführt.
- 2.1.4 - 2.1.9
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 bis 2.1.9 dieser Komponente aufgeführt.
- 2.1.4 - 2.1.8
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 und 2.1.8 dieser Komponente aufgeführt.
- 2.1.2 - 2.1.3
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.2 und 2.1.3 dieser Komponente aufgeführt.
- 2.1.1
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.1 dieser Komponente aufgeführt.
- 2.0.8 - 2.1.0
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 bis 2.1.0 dieser Komponente aufgeführt.
- 2.0.7
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.7 dieser Komponente aufgeführt.
- 2.0.6
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
- 2.0.5
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
- 2.0.4
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
- 2.0.3
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Komponentenrezeptreferenz.
Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
- v4.x
-
-
PublishInterval
-
(Optional) Die maximale Wartezeit in Sekunden, bis die Komponente Batch-Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass sie Metriken so veröffentlicht, wie sie sie empfängt, also ohne Batchverarbeitung, geben Sie Folgendes an. 0
Die Komponente veröffentlicht CloudWatch nach dem Empfang von 20 Metriken im gleichen Namespace oder nach dem von Ihnen angegebenen Intervall.
Die Komponente gibt nicht die Reihenfolge an, in der Ereignisse veröffentlicht werden.
Dieser Wert kann maximal 900 Sekunden betragen.
Standard: 10 Sekunden
-
MaxMetricsToRetain
-
(Optional) Die maximale Anzahl von Metriken in allen Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Kerngerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken zwischenspeichert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im gleichen Namespace.
Wenn der Hostprozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Kerngeräts passieren.
Dieser Wert muss mindestens 2.000 Metriken betragen.
Standard: 5.000 Metriken
InputTopic-
(Optional) Das Thema, für das die Komponente den Empfang von Nachrichten abonniert. Wenn Sie true für angebenPubSubToIoTCore, können Sie in diesem Thema MQTT-Platzhalter (+ und #) verwenden.
Standard: cloudwatch/metric/put
OutputTopic-
(Optional) Das Thema, zu dem die Komponente Statusantworten veröffentlicht.
Standard: cloudwatch/metric/put/status
PubSubToIoTCore-
(Optional) Zeichenkettenwert, der definiert, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen. Unterstützte Werte sind true und false.
Standard: false
LogLevel-
(Optional) Die Protokollierungsebene für die Komponente. Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
-
DEBUG
-
INFO
-
WARNING
-
ERROR
-
CRITICAL
Standard: INFO
-
UseInstaller
-
(Optional) Boolescher Wert, der definiert, ob das Installationsskript verwendet werden soll, um die Python-Abhängigkeiten dieser Komponente in der bereitgestellten Python-Umgebung zu installieren.
Setzen Sie diesen Wert auf, true um die Python-Abhängigkeiten dieser Komponente automatisch zu installieren. Wenn dieser Wert auf gesetzt istfalse, müssen Sie die folgenden Bibliotheken einschließlich aller Abhängigkeiten installieren und sie für die Python-Umgebung verfügbar machen, die dem Benutzer zur Verfügung gestellt wird, der die Komponente ausführt.
Standard: false
PublishRegion-
(Optional) Der AWS-Region , in dem die CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Kerngerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.
accessControl-
(Optional) Das Objekt, das die Autorisierungsrichtlinie enthält, die es der Komponente ermöglicht, die angegebenen Themen zu veröffentlichen und zu abonnieren. Wenn Sie benutzerdefinierte Werte für InputTopic und angebenOutputTopic, müssen Sie die Ressourcenwerte in diesem Objekt aktualisieren.
Standard:
{
"aws.greengrass.ipc.pubsub": {
"aws.greengrass.Cloudwatch:pubsub:1": {
"policyDescription": "Allows access to subscribe to input topics.",
"operations": [
"aws.greengrass#SubscribeToTopic"
],
"resources": [
"cloudwatch/metric/put"
]
},
"aws.greengrass.Cloudwatch:pubsub:2": {
"policyDescription": "Allows access to publish to output topics.",
"operations": [
"aws.greengrass#PublishToTopic"
],
"resources": [
"cloudwatch/metric/put/status"
]
}
},
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.Cloudwatch:mqttproxy:1": {
"policyDescription": "Allows access to subscribe to input topics.",
"operations": [
"aws.greengrass#SubscribeToIoTCore"
],
"resources": [
"cloudwatch/metric/put"
]
},
"aws.greengrass.Cloudwatch:mqttproxy:2": {
"policyDescription": "Allows access to publish to output topics.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"cloudwatch/metric/put/status"
]
}
}
}
Beispiel Beispiel: Aktualisierung der Zusammenführung von Konfigurationen
{
"PublishInterval": 0,
"PubSubToIoTCore": true
}
- v3.x
-
-
PublishInterval
-
(Optional) Die maximale Wartezeit in Sekunden, bis die Komponente Batch-Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass sie Metriken so veröffentlicht, wie sie sie empfängt, also ohne Batchverarbeitung, geben Sie Folgendes an. 0
Die Komponente veröffentlicht CloudWatch nach dem Empfang von 20 Metriken im gleichen Namespace oder nach dem von Ihnen angegebenen Intervall.
Die Komponente gibt nicht die Reihenfolge an, in der Ereignisse veröffentlicht werden.
Dieser Wert kann maximal 900 Sekunden betragen.
Standard: 10 Sekunden
-
MaxMetricsToRetain
-
(Optional) Die maximale Anzahl von Metriken in allen Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Kerngerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken zwischenspeichert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im gleichen Namespace.
Wenn der Hostprozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Kerngeräts passieren.
Dieser Wert muss mindestens 2.000 Metriken betragen.
Standard: 5.000 Metriken
InputTopic-
(Optional) Das Thema, für das die Komponente den Empfang von Nachrichten abonniert. Wenn Sie true für angebenPubSubToIoTCore, können Sie in diesem Thema MQTT-Platzhalter (+ und #) verwenden.
Standard: cloudwatch/metric/put
OutputTopic-
(Optional) Das Thema, zu dem die Komponente Statusantworten veröffentlicht.
Standard: cloudwatch/metric/put/status
PubSubToIoTCore-
(Optional) Zeichenkettenwert, der definiert, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen. Unterstützte Werte sind true und false.
Standard: false
LogLevel-
(Optional) Die Protokollierungsebene für die Komponente. Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
-
DEBUG
-
INFO
-
WARNING
-
ERROR
-
CRITICAL
Standard: INFO
UseInstaller-
(Optional) Boolescher Wert, der definiert, ob das Installationsskript verwendet werden soll, um die Python-Abhängigkeiten dieser Komponente in der bereitgestellten Python-Umgebung zu installieren.
Setzen Sie diesen Wert auf, false um ein benutzerdefiniertes Skript zu verwenden oder Abhängigkeiten manuell zu installieren. Wenn dieser Wert auf gesetzt istfalse, müssen Sie die folgenden Bibliotheken einschließlich aller Abhängigkeiten installieren und sie für die Python-Umgebung verfügbar machen, die dem Benutzer zur Verfügung gestellt wird, der die Komponente ausführt.
Standard: true
PublishRegion-
(Optional) Der AWS-Region , in dem die CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Kerngerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.
accessControl-
(Optional) Das Objekt, das die Autorisierungsrichtlinie enthält, die es der Komponente ermöglicht, die angegebenen Themen zu veröffentlichen und zu abonnieren. Wenn Sie benutzerdefinierte Werte für InputTopic und angebenOutputTopic, müssen Sie die Ressourcenwerte in diesem Objekt aktualisieren.
Standard:
{
"aws.greengrass.ipc.pubsub": {
"aws.greengrass.Cloudwatch:pubsub:1": {
"policyDescription": "Allows access to subscribe to input topics.",
"operations": [
"aws.greengrass#SubscribeToTopic"
],
"resources": [
"cloudwatch/metric/put"
]
},
"aws.greengrass.Cloudwatch:pubsub:2": {
"policyDescription": "Allows access to publish to output topics.",
"operations": [
"aws.greengrass#PublishToTopic"
],
"resources": [
"cloudwatch/metric/put/status"
]
}
},
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.Cloudwatch:mqttproxy:1": {
"policyDescription": "Allows access to subscribe to input topics.",
"operations": [
"aws.greengrass#SubscribeToIoTCore"
],
"resources": [
"cloudwatch/metric/put"
]
},
"aws.greengrass.Cloudwatch:mqttproxy:2": {
"policyDescription": "Allows access to publish to output topics.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"cloudwatch/metric/put/status"
]
}
}
}
Beispiel Beispiel: Aktualisierung der Zusammenführung von Konfigurationen
{
"PublishInterval": 0,
"PubSubToIoTCore": true
}
- v2.x
-
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.
-
lambdaParams
-
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
-
EnvironmentVariables
-
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
-
PUBLISH_INTERVAL
-
(Optional) Die maximale Wartezeit in Sekunden, bis die Komponente gestapelte Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass sie Metriken so veröffentlicht, wie sie sie empfängt, also ohne Batchverarbeitung, geben Sie Folgendes an. 0
Die Komponente veröffentlicht CloudWatch nach dem Empfang von 20 Metriken im gleichen Namespace oder nach dem von Ihnen angegebenen Intervall.
Die Komponente garantiert nicht die Reihenfolge, in der Ereignisse veröffentlicht werden.
Dieser Wert kann maximal 900 Sekunden betragen.
Standard: 10 Sekunden
-
MAX_METRICS_TO_RETAIN
-
(Optional) Die maximale Anzahl von Metriken in allen Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Kerngerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken zwischenspeichert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im gleichen Namespace.
Wenn der Hostprozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Kerngeräts passieren.
Dieser Wert muss mindestens 2.000 Metriken betragen.
Standard: 5.000 Metriken
-
PUBLISH_REGION
-
(Optional) Der AWS-Region , in dem CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Kerngerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.
containerMode-
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
-
NoContainer— Die Komponente läuft nicht in einer isolierten Laufzeitumgebung.
-
GreengrassContainer— Die Komponente wird in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers ausgeführt.
Standard: GreengrassContainer
-
containerParams
-
(Optional) Ein Objekt, das die Containerparameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie GreengrassContainer für angebencontainerMode.
Dieses Objekt enthält die folgenden Informationen:
-
memorySize
-
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 64 MB (65.535 KB).
pubsubTopics-
(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokalen Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
0— Dies ist ein Array-Index als Zeichenfolge.-
Ein Objekt, das die folgenden Informationen enthält:
type-
(Optional) Der publish/subscribe Nachrichtentyp, den diese Komponente zum Abonnieren von Nachrichten verwendet. Wählen Sie aus den folgenden Optionen aus:
-
PUB_SUB— Abonnieren Sie lokale publish/subscribe Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Hinweise zum Senden von Nachrichten aus einer benutzerdefinierten Komponente, wenn Sie diese Option angeben, finden Sie unter. Lokale Nachrichten veröffentlichen/abonnieren
-
IOT_CORE— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Hinweise zum Senden von Nachrichten von benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. Publish/subscribe AWS IoT Core MQTT-Nachrichten
Standard: PUB_SUB
topic-
(Optional) Das Thema, für das die Komponente den Empfang von Nachrichten abonniert. Wenn Sie IotCore für angebentype, können Sie in diesem Thema MQTT-Platzhalter (+und#) verwenden.
Beispiel Beispiel: Aktualisierung der Konfigurationszusammenführung (Containermodus)
{
"containerMode": "GreengrassContainer"
}
Beispiel Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Containermodus)
{
"containerMode": "NoContainer"
}
Diese Komponente akzeptiert Metriken zum folgenden Thema und veröffentlicht die Metriken unter CloudWatch. Standardmäßig abonniert diese Komponente lokale publish/subscribe Nachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten aus Ihren benutzerdefinierten Komponenten an diese Komponente finden Sie unterLokale Nachrichten veröffentlichen/abonnieren.
Ab der Komponentenversion v3.0.0 können Sie diese Komponente optional so konfigurieren, dass sie ein MQTT-Thema abonniert, indem Sie den PubSubToIoTCore Konfigurationsparameter auf setzen. true Weitere Informationen zum Veröffentlichen von Nachrichten zu einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter. Publish/subscribe AWS IoT Core MQTT-Nachrichten
Standardthema: cloudwatch/metric/put
Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.
-
request
-
Die Metrik in dieser Nachricht.
Das Anforderungsobjekt enthält die metrischen Daten, die an CloudWatch veröffentlicht werden sollen. Die Metrikwerte müssen den Spezifikationen des PutMetricData Vorgangs entsprechen.
Typ: object der die folgenden Informationen enthält:
-
namespace
-
Der benutzerdefinierte Namespace für die Metrikdaten in dieser Anfrage. CloudWatch verwendet Namespaces als Container für Metrikdatenpunkte.
Sie können keinen Namespace angeben, der mit der reservierten Zeichenfolge beginnt. AWS/
Typ: string
Gültiges Muster: [^:].*
-
metricData
-
Die Daten für die Metrik.
Typ: object der die folgenden Informationen enthält:
-
metricName
-
Name der Metrik.
Typ: string
-
value
-
Der Wert für die Metrik.
CloudWatch lehnt zu kleine oder zu große Werte ab. Der Wert muss zwischen 8.515920e-109 und 1.174271e+108 (Basis 10) oder 2e-360 und 2e360 (Basis 2) liegen. CloudWatch unterstützt keine speziellen Werte wie NaN+Infinity, und-Infinity.
Typ: double
-
dimensions
-
(Optional) Die Dimensionen für die Metrik. Dimensionen liefern zusätzliche Informationen über die Metrik und ihre Daten. Eine Metrik kann bis zu 10 Dimensionen definieren.
Diese Komponente enthält automatisch eine Dimension mit dem NamencoreName, wobei der Wert der Name des Kerngeräts ist.
Typ: array von Objekten, die jeweils die folgenden Informationen enthalten:
-
name
-
(Optional) Der Dimensionsname.
Typ: string
-
value
-
(Optional) Der Dimensionswert.
Typ: string
-
timestamp
-
(Optional) Die Uhrzeit, zu der die Metrikdaten empfangen wurden, ausgedrückt in Sekunden in Unix-Epochenzeit.
Standardmäßig der Zeitpunkt, zu dem die Komponente die Nachricht empfängt.
Typ: double
Wenn Sie diese Komponente zwischen den Versionen 2.0.3 und 2.0.7 verwenden, empfehlen wir, den Zeitstempel für jede Metrik separat abzurufen, wenn Sie mehrere Metriken aus einer einzigen Quelle senden. Verwenden Sie keine Variable, um den Zeitstempel zu speichern.
-
unit
-
(Optional) Die Einheit der Metrik.
Typ: string
Gültige Werte: Seconds Microseconds Milliseconds Bytes KilobytesMegabytes, GigabytesTerabytes,Bits, KilobitsMegabits, GigabitsTerabits,Percent, CountBytes/Second, Kilobytes/SecondMegabytes/Second, Gigabytes/SecondTerabytes/Second,Bits/Second, Kilobits/SecondMegabits/Second, Gigabits/SecondTerabits/Second,Count/Second, None
Standardeinstellung: None.
Alle Kontingente, die für die CloudWatch PutMetricData API gelten, gelten für Metriken, die Sie mit dieser Komponente veröffentlichen. Die folgenden Kontingente sind besonders wichtig:
-
40-KB-Limit für die API-Nutzlast
-
20 Metriken pro API-Anforderung
-
150 Transaktionen pro Sekunde (TPS) für die PutMetricData-API
Weitere Informationen finden Sie im CloudWatch Benutzerhandbuch unter CloudWatch Dienstkontingente.
Beispiel Beispieleingabe
{
"request": {
"namespace": "Greengrass",
"metricData": {
"metricName": "latency",
"dimensions": [
{
"name": "hostname",
"value": "test_hostname"
}
],
"timestamp": 1539027324,
"value": 123.0,
"unit": "Seconds"
}
}
}
Ausgabedaten
Diese Komponente veröffentlicht standardmäßig Antworten als Ausgabedaten zum folgenden lokalen publish/subscribe Thema. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unterLokale Nachrichten veröffentlichen/abonnieren.
Sie können diese Komponente optional für die Veröffentlichung in einem MQTT-Thema konfigurieren, indem Sie den PubSubToIoTCore Konfigurationsparameter auf true setzen. Weitere Informationen zum Abonnieren von Nachrichten zu einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter. Publish/subscribe AWS IoT Core MQTT-Nachrichten
Standardthema: cloudwatch/metric/put/status
Beispiel Beispielausgabe: Erfolg
Die Antwort enthält den Namespace der Metrikdaten und das RequestId Feld aus der CloudWatch Antwort.
{
"response": {
"cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE",
"namespace": "Greengrass",
"status": "success"
}
}
Beispiel Beispielausgabe: Fehler
{
"response" : {
"namespace": "Greengrass",
"error": "InvalidInputException",
"error_message": "cw metric is invalid",
"status": "fail"
}
}
Wenn die Komponente einen Fehler feststellt, der erneut versucht werden kann, z. B. einen Verbindungsfehler, versucht sie die Veröffentlichung im nächsten Batch erneut.
Lizenzen
Zu dieser Komponente gehören die folgenden Drittanbieter: software/licensing
Diese Komponente wird im Rahmen der Greengrass Core Software-Lizenzvereinbarung veröffentlicht.
Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log
Um die Protokolle dieser Komponente einzusehen
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
- v4.x - v3.x
-
|
Version
|
Änderungen
|
|
4.0.0
|
|
|
3.2.0
|
|
|
3.1.0
|
- Fehlerbehebungen und Verbesserungen
-
|
|
3.0.0
|
Diese Version der CloudWatch Metrikkomponente erwartet andere Konfigurationsparameter als Version 2.x. Wenn Sie eine nicht standardmäßige Konfiguration für Version 2.x verwenden und ein Upgrade von Version 2.x auf Version 3.x durchführen möchten, müssen Sie die Konfiguration der Komponente aktualisieren. Weitere Informationen finden Sie unter Konfiguration der Metrikkomponente. CloudWatch
- Neue Features
-
-
Fügt Unterstützung für Kerngeräte hinzu, auf denen Windows ausgeführt wird.
-
Ändert den Komponententyp von einer Lambda-Komponente in eine generische Komponente. Diese Komponente ist jetzt nicht mehr von der älteren Abonnement-Router-Komponente abhängig, um Abonnements zu erstellen.
-
Fügt einen neuen InputTopic Konfigurationsparameter hinzu, um das Thema anzugeben, für das die Komponente den Empfang von Nachrichten abonniert.
-
Fügt einen neuen OutputTopic Konfigurationsparameter hinzu, um das Thema anzugeben, zu dem die Komponente Statusantworten veröffentlicht.
-
Fügt einen neuen PubSubToIoTCore Konfigurationsparameter hinzu, um anzugeben, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen.
-
Fügt den neuen UseInstaller Konfigurationsparameter hinzu, mit dem Sie optional das Installationsskript deaktivieren können, das Komponentenabhängigkeiten installiert.
- Fehlerbehebungen und Verbesserungen
-
Fügt Unterstützung für doppelte Zeitstempel in Eingabedaten hinzu.
|
- v2.x
-
|
Version
|
Änderungen
|
|
2.1.8
|
Die Version wurde für die Greengrass Nucleus-Version 2.13.0 aktualisiert.
|
|
2.1.3
|
Die Version wurde für die Greengrass Nucleus-Version 2.11.0 aktualisiert.
|
|
2.1.2
|
Die Version wurde für die Greengrass Nucleus-Version 2.7.0 aktualisiert.
|
|
2.1.1
|
Die Version wurde für die Greengrass Nucleus-Version 2.6.0 aktualisiert.
|
|
2.1.0
|
|
|
2.0.8
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.0.7
|
Die Version wurde für die Greengrass Nucleus-Version 2.4.0 aktualisiert.
|
|
2.0.6
|
Die Version wurde für die Greengrass Nucleus-Version 2.3.0 aktualisiert.
|
|
2.0.5
|
Die Version wurde für die Greengrass Nucleus-Version 2.2.0 aktualisiert.
|
|
2.0.4
|
Die Version wurde für die Greengrass Nucleus-Version 2.1.0 aktualisiert.
|
|
2.0.3
|
Erste Version
|
Weitere Informationen finden Sie auch unter
