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 Amazon- CloudWatch Metrikkomponente (aws.greengrass.Cloudwatch
) veröffentlicht benutzerdefinierte Metriken von Greengrass-Core-Geräten in 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 Amazon CloudWatch-Metriken im Amazon- CloudWatch Benutzerhandbuch.
Um eine CloudWatch Metrik mit dieser Komponente zu veröffentlichen, veröffentlichen Sie eine Nachricht in einem Thema, in dem diese Komponente abonniert wird. Standardmäßig abonniert diese Komponente das cloudwatch/metric/put
lokale Veröffentlichungs-/Abonnementthema. Sie können bei der Bereitstellung dieser Komponente andere Themen angeben, einschließlich AWS IoT Core MQTT-Themen.
Diese Komponente stapelt Metriken, die sich im selben Namespace befinden, und veröffentlicht sie CloudWatch in regelmäßigen Abständen in .
Diese Komponente bietet ähnliche Funktionen wie der CloudWatch Metrik-Konnektor in AWS IoT Greengrass V1. Weitere Informationen finden Sie unter CloudWatch Metrics Connector im AWS IoT Greengrass V1-Entwicklerhandbuch.
Versionen
Diese Komponente hat die folgenden Versionen:
Informationen zu Änderungen in jeder Version der Komponente finden Sie im Änderungsprotokoll .
Typ
- v3.x
-
Diese Komponente ist eine generische Komponente (aws.greengrass.generic
). Der Greengrass-Kern führt die Lebenszyklusskripte der Komponente aus.
- v2.x
-
Diese Komponente ist eine Lambda-Komponente (aws.greengrass.lambda
). Der Greengrass-Kern führt die Lambda-Funktion dieser Komponente mit der Lambda-Launcher-Komponente aus.
Weitere Informationen finden Sie unter Komponententypen.
Betriebssystem
- v3.x
-
Diese Komponente kann auf -Core-Geräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
- v2.x
-
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
- 3.x
-
-
Python Version 3.7 ist auf dem Core-Gerät installiert und der PATH-Umgebungsvariablen hinzugefügt.
-
Die Greengrass-Geräterolle muss die cloudwatch:PutMetricData
Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"cloudwatch:PutMetricData"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
Weitere Informationen finden Sie in der Amazon CloudWatch-Berechtigungsreferenz im Amazon- CloudWatch Benutzerhandbuch.
- 2.x
-
-
Ihr Core-Gerät muss die Anforderungen erfüllen, um Lambda-Funktionen auszuführen. Wenn Sie möchten, dass das Core-Gerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die Voraussetzungen dafür erfüllen. Weitere Informationen finden Sie unter Anforderungen an die Lambda-Funktion.
-
Python Version 3.7 ist auf dem Core-Gerät installiert und der PATH-Umgebungsvariablen hinzugefügt.
-
Die Greengrass-Geräterolle muss die cloudwatch:PutMetricData
Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"cloudwatch:PutMetricData"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
Weitere Informationen finden Sie in der Amazon CloudWatch-Berechtigungsreferenz im Amazon- CloudWatch Benutzerhandbuch.
-
Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie das folgende Konfigurationsupdate für die Legacy-Abonnement-Routerkomponente (aws.greengrass.LegacySubscriptionRouter
) zusammenführen, wenn Sie diese Komponente bereitstellen. Diese Konfiguration gibt das Thema an, in 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"
}
}
}
-
Ersetzen Sie region
durch die AWS-Region , die Sie verwenden.
-
Ersetzen Sie Version
durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie das Rezept für die Version dieser Komponente anzeigen, 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 Legacy-Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die von Ihnen bereitgestellte Komponentenversion verwenden.
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 für den grundlegenden Betrieb erforderlichen Endpunkten und Ports. Weitere Informationen finden Sie unter Zulassen von Gerätedatenverkehr über einen Proxy oder eine Firewall.
Endpunkt |
Port |
Erforderlich |
Beschreibung |
monitoring.region .amazonaws.com
|
443 |
Ja |
Laden Sie CloudWatch Metriken hoch.
|
Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. 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 und die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste Abhängigkeiten.
- 3.0.0 - 3.1.0
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 3.0.0 bis 3.1.0 dieser Komponente aufgeführt.
- 2.1.2 and 2.1.3
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 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 Referenz zum Komponentenrezept .
Konfiguration
Diese Komponente bietet die folgenden Konfigurationsparameter, die Sie bei der Bereitstellung der Komponente anpassen können.
- v3.x
-
-
PublishInterval
-
(Optional) Die maximale Anzahl von Sekunden, die gewartet werden muss, bevor die Komponente Batch-Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass Metriken veröffentlicht werden, sobald sie sie empfangen, d. h. ohne Stapelverarbeitung, geben Sie an0
.
Die Komponente veröffentlicht in , CloudWatch nachdem sie 20 Metriken im selben Namespace oder nach dem von Ihnen angegebenen Intervall erhalten hat.
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 für alle Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Core-Gerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken puffert, 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 selben Namespace.
Wenn der Host-Prozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Core-Geräts geschehen.
Dieser Wert muss mindestens 2 000 Metriken betragen.
Standard: 5 000 Metriken
InputTopic
-
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. 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) Zeichenfolgenwert, der definiert, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen. Unterstützte Werte sind true
und false
.
Standard: false
UseInstaller
-
(Optional) Boolescher Wert, der definiert, ob das Installationsskript in dieser Komponente verwendet werden soll, um die SDK-Abhängigkeiten dieser Komponente zu installieren.
Setzen Sie diesen Wert auf , false
wenn Sie ein benutzerdefiniertes Skript zum Installieren von Abhängigkeiten verwenden möchten, oder wenn Sie Laufzeitabhängigkeiten in ein vorgefertigtes Linux-Image aufnehmen möchten. Um diese Komponente zu verwenden, müssen Sie die folgenden Bibliotheken, einschließlich aller Abhängigkeiten, installieren und sie dem Standard-Greengrass-Systembenutzer zur Verfügung stellen.
Standard: true
PublishRegion
-
(Optional) Die AWS-Region , in der CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Core-Gerä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: Aktualisierung der Konfigurationszusammenführung
{
"PublishInterval": 0,
"PubSubToIoTCore": true
}
- v2.x
-
Die Standardkonfiguration dieser Komponente enthält Lambda-Funktionsparameter. Wir empfehlen Ihnen, nur die folgenden Parameter zu 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 Anzahl von Sekunden, die gewartet werden muss, bevor die Komponente Batch-Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass Metriken veröffentlicht werden, sobald sie sie empfangen, d. h. ohne Stapelverarbeitung, geben Sie an0
.
Die Komponente veröffentlicht in , CloudWatch nachdem sie 20 Metriken im selben Namespace oder nach dem von Ihnen angegebenen Intervall erhalten hat.
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 für alle Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Core-Gerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken puffert, 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 selben Namespace.
Wenn der Host-Prozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Core-Geräts geschehen.
Dieser Wert muss mindestens 2 000 Metriken betragen.
Standard: 5 000 Metriken
-
PUBLISH_REGION
-
(Optional) Die AWS-Region , in der CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Core-Gerä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 wird nicht in einer isolierten Laufzeitumgebung ausgeführt.
-
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 lokale Veröffentlichungs-/Abonnementthemen abonniert.
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 Typ des Veröffentlichungs-/Abonnement-Messagings, den diese Komponente zum Abonnieren von Nachrichten verwendet. Wählen Sie aus den folgenden Optionen aus:
-
PUB_SUB
— Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von 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 Informationen zum Senden von Nachrichten von benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core.
Standard: PUB_SUB
topic
-
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie IotCore
für angebentype
, können Sie in diesem Thema MQTT-Platzhalter (+
und #
) verwenden.
Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)
{
"containerMode": "GreengrassContainer"
}
Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Containermodus)
{
"containerMode": "NoContainer"
}
Diese Komponente akzeptiert Metriken zum folgenden Thema und veröffentlicht die Metriken in CloudWatch. Standardmäßig abonniert diese Komponente lokale Veröffentlichungs-/Abonnementnachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten in dieser Komponente aus Ihren benutzerdefinierten Komponenten finden Sie unter Lokale Nachrichten veröffentlichen/abonnieren.
Ab Komponentenversion v3.0.0 können Sie diese Komponente optional so konfigurieren, dass sie ein MQTT-Thema abonniert, indem Sie den PubSubToIoTCore
Konfigurationsparameter auf setzentrue
. Weitere Informationen zum Veröffentlichen von Nachrichten in einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core.
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 der PutMetricData
Operation entsprechen.
Typ: object
, der die folgenden Informationen enthält:
-
namespace
-
Der benutzerdefinierte Namespace für die Metrikdaten in dieser Anforderung. CloudWatch verwendet Namespaces als Container für Metrikdatenpunkte.
Sie können keinen Namespace angeben, der mit der reservierten Zeichenfolge beginntAWS/
.
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 Werte ab, die zu klein oder zu groß sind. Der Wert muss zwischen 8.515920e-109
und 1.174271e+108
(Base 10) oder 2e-360
und 2e360
(Base 2) liegen. unterstützt CloudWatch 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 Namen coreName
, wobei der Wert der Name des Core-Geräts ist.
Typ: array
der Objekte, die jeweils die folgenden Informationen enthalten:
-
name
-
(Optional) Der Dimensionsname.
Typ: string
-
value
-
(Optional) Der Dimensionswert.
Typ: string
-
timestamp
-
(Optional) Die Zeit, zu der die Metrikdaten empfangen wurden, ausgedrückt in Sekunden in Unix-Epochenzeit.
Standardmäßig ist dies der Zeitpunkt, zu dem die Komponente die Nachricht empfängt.
Typ: double
Wenn Sie zwischen den Versionen 2.0.3 und 2.0.7 dieser Komponente 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
, Kilobytes
, Megabytes
Gigabytes
, Terabytes
, Bits
, Kilobits
, Megabits
, Gigabits
, Terabits
, Percent
, Count
, Bytes/Second
, Kilobytes/Second
, Megabytes/Second
, , Gigabytes/Second
, , Terabytes/Second
, Kilobits/Second
, Bits/Second
, Megabits/Second
, , , Gigabits/Second
, , , Terabits/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:
-
Limit von 40 KB für die API-Nutzlast
-
20 Metriken pro API-Anforderung
-
150 Transaktionen pro Sekunde (TPS) für die PutMetricData
-API
Weitere Informationen finden Sie unter -CloudWatch Servicekontingente im CloudWatch -Benutzerhandbuch.
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 Antworten standardmäßig als Ausgabedaten zum folgenden lokalen Veröffentlichungs-/Abonnementthema. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter Lokale 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 setzentrue
. Weitere Informationen zum Abonnieren von Nachrichten zu einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core.
Komponentenversionen 2.0.x veröffentlichen Antworten standardmäßig als Ausgabedaten für ein MQTT-Thema. Sie müssen das Thema als subject
in der Konfiguration für die Legacy-Abonnement-Routerkomponente angeben.
Standardthema: cloudwatch/metric/put/status
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"
}
}
Beispielausgabe: Fehler
{
"response" : {
"namespace": "Greengrass",
"error": "InvalidInputException",
"error_message": "cw metric is invalid",
"status": "fail"
}
}
Wenn die Komponente einen Fehler erkennt, der erneut versucht werden kann, z. B. einen Verbindungsfehler, wiederholt sie die Veröffentlichung im nächsten Batch.
Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
Diese Komponente wird gemäß dem Greengrass Core Software License Agreement veröffentlicht.
Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
- Linux
-
/greengrass/v2
/logs/aws.greengrass.Cloudwatch.log
- Windows
-
C:\greengrass\v2
\logs\aws.greengrass.Cloudwatch.log
So zeigen Sie die Protokolle dieser Komponente an
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in jeder Version der Komponente beschrieben.
- v3.x
-
Version
|
Änderungen
|
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 v2.x auf v3.x durchführen möchten, müssen Sie die Konfiguration der Komponente aktualisieren. Weitere Informationen finden Sie unter CloudWatch Konfiguration der Metrikkomponente .
- Neue Features
-
-
Fügt Unterstützung für -Core-Geräte hinzu, auf denen Windows ausgeführt wird.
-
Ändert den Komponententyp von einer Lambda-Komponente in eine generische Komponente. Diese Komponente hängt jetzt nicht mehr von der Legacy-Abonnement-Routerkomponente ab, um Abonnements zu erstellen.
-
Fügt einen neuen InputTopic Konfigurationsparameter hinzu, um das Thema anzugeben, das die Komponente abonniert, um Nachrichten zu empfangen.
-
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.3
|
Version für Greengrass-Kern Version 2.11.0 aktualisiert.
|
2.1.2
|
Version für Greengrass-Kern Version 2.7.0 aktualisiert.
|
2.1.1
|
Version für Greengrass-Kern Version 2.6.0 aktualisiert.
|
2.1.0
|
|
2.0.8
|
- Fehlerbehebungen und Verbesserungen
-
|
2.0.7
|
Version für Greengrass-Kern Version 2.4.0 aktualisiert.
|
2.0.6
|
Version für Greengrass-Kern Version 2.3.0 aktualisiert.
|
2.0.5
|
Version für Greengrass-Kern Version 2.2.0 aktualisiert.
|
2.0.4
|
Version für Greengrass-Kern Version 2.1.0 aktualisiert.
|
2.0.3
|
Erste Version
|
Weitere Informationen finden Sie auch unter