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.
Protokollmanager
Wir empfehlen ein Upgrade auf Log Manager v2.3.5 oder höher. Version 2.3.5 optimiert die Schreibvorgänge in der Log Manager-Konfiguration, reduziert die I/O-Operationen und verbessert die Geschwindigkeit des Log-Uploads, die allgemeine Geräteleistung und verlängert möglicherweise die Lebensdauer des Geräts.
Die Log Manager-Komponente (aws.greengrass.LogManager) lädt Protokolle von AWS IoT Greengrass Kerngeräten in Amazon Logs hoch. CloudWatch Sie können Protokolle aus dem Greengrass Nucleus, anderen Greengrass-Komponenten und anderen Anwendungen und Diensten hochladen, die keine Greengrass-Komponenten sind. Weitere Informationen zur Überwachung von Protokollen in CloudWatch Logs und im lokalen Dateisystem finden Sie unter. AWS IoT Greengrass Protokolle überwachen
Die folgenden Überlegungen gelten, wenn Sie die Log-Manager-Komponente verwenden, um in CloudWatch Logs zu schreiben:
-
Verzögerungen protokollieren
Die Log Manager-Komponente Version 2.2.8 (und früher) verarbeitet und lädt nur Protokolle aus rotierten Protokolldateien hoch. Standardmäßig rotiert die AWS IoT Greengrass Core-Software die Protokolldateien jede Stunde oder danach, wenn sie 1.024 KB groß sind. Daher lädt die Log Manager-Komponente Protokolle erst hoch, nachdem die AWS IoT Greengrass Core-Software oder eine Greengrass-Komponente Protokolle im Wert von über 1.024 KB geschrieben hat. Sie können eine niedrigere Größenbeschränkung für Protokolldateien konfigurieren, damit die Protokolldateien häufiger rotieren. Dadurch lädt die Log Manager-Komponente häufiger CloudWatch Protokolle in Logs hoch.
Die Version 2.3.0 (und höher) der Log Manager-Komponente verarbeitet alle Logs und lädt sie hoch. Wenn Sie ein neues Protokoll schreiben, verarbeitet Log Manager Version 2.3.0 (und höher) diese aktive Protokolldatei und lädt sie direkt hoch, anstatt darauf zu warten, dass sie rotiert wird. Das bedeutet, dass Sie das neue Protokoll in 5 Minuten oder weniger einsehen können.
Die Log Manager-Komponente lädt regelmäßig neue Protokolle hoch. Standardmäßig lädt die Log Manager-Komponente alle 5 Minuten neue Logs hoch. Sie können ein niedrigeres Upload-Intervall konfigurieren, sodass die Log Manager-Komponente CloudWatch Protokolle häufiger in Logs hochlädt, indem Sie den konfigurieren. periodicUploadIntervalSec Weitere Informationen zur Konfiguration dieses periodischen Intervalls finden Sie unter Konfiguration.
Protokolle können nahezu in Echtzeit aus demselben Greengrass-Dateisystem hochgeladen werden. Wenn Sie Protokolle in Echtzeit beobachten müssen, sollten Sie die Verwendung von Dateisystemprotokollen in Betracht ziehen.
Wenn Sie zum Schreiben von Protokollen unterschiedliche Dateisysteme verwenden, kehrt der Log Manager zu dem Verhalten der Log Manager-Komponentenversionen 2.2.8 und früher zurück. Informationen zum Zugriff auf Dateisystemprotokolle finden Sie unter Zugreifen auf Dateisystemprotokolle.
-
Zeitversatz
Die Log Manager-Komponente verwendet den Standard-Signaturprozess von Signature Version 4, um API-Anfragen an CloudWatch Logs zu erstellen. Wenn die Systemzeit auf einem Kerngerät um mehr als 15 Minuten nicht synchronisiert ist, lehnt CloudWatch Logs die Anfragen ab. Weitere Informationen finden Sie unter Signaturprozess mit Signaturversion 4 in derAllgemeine AWS-Referenz .
Hinweise zu den Protokollgruppen und Logstreams, in die diese Komponente Protokolle hochlädt, finden Sie unter. Usage
Versionen
Diese Komponente hat die folgenden Versionen:
Typ
Diese Komponente ist eine Plugin-Komponente (aws.greengrass.plugin). Der Greengrass-Nukleus führt diese Komponente in derselben Java Virtual Machine (JVM) aus wie der Nucleus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Kerngerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Nucleus. Weitere Informationen finden Sie unter AWS IoT Greengrass Protokolle überwachen.
Weitere Informationen finden Sie unter Komponententypen.
Betriebssystem
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
-
Die Greengrass-Geräterolle muss die logs:DescribeLogStreams Aktionenlogs:CreateLogGroup, logs:CreateLogStreamlogs:PutLogEvents, und zulassen, wie im folgenden Beispiel für eine IAM-Richtlinie dargestellt.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams"
],
"Effect": "Allow",
"Resource": "arn:aws:logs:*:*:*"
}
]
}
Die Greengrass-Geräterolle, die Sie bei der Installation der AWS IoT Greengrass Core-Software erstellen, beinhaltet standardmäßig die Berechtigungen in dieser Beispielrichtlinie.
Weitere Informationen finden Sie unter Verwenden identitätsbasierter Richtlinien (IAM-Richtlinien) für CloudWatch Protokolle im Amazon CloudWatch Logs-Benutzerhandbuch.
-
Die Ausführung der Log Manager-Komponente wird in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
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 |
|
logs.region.amazonaws.com
|
443 |
Nein |
Erforderlich, wenn Sie Protokolle in Logs schreiben. 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.
- 2.3.13 and 2.3.14
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.13 und 2.3.14 dieser Komponente aufgeführt.
- 2.3.12
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.12 dieser Komponente aufgeführt.
- 2.3.11
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.11 dieser Komponente aufgeführt.
- 2.3.10
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.10 dieser Komponente aufgeführt.
- 2.3.9
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.9 dieser Komponente aufgeführt.
- 2.3.8
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.8 dieser Komponente aufgeführt.
- 2.3.7
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.7 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Typ der Abhängigkeit |
| Grüngras-Kern |
> =2,1,0 <2,13,0 |
Weich |
- 2.3.5 and 2.3.6
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.5 und 2.3.6 dieser Komponente aufgeführt.
- 2.3.3 – 2.3.4
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.3 bis 2.3.4 dieser Komponente aufgeführt.
- 2.2.8 – 2.3.2
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.8 bis 2.3.2 dieser Komponente aufgeführt.
- 2.2.7
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.7 dieser Komponente aufgeführt.
- 2.2.6
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.6 dieser Komponente aufgeführt.
- 2.2.5
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.5 dieser Komponente aufgeführt.
- 2.2.1 - 2.2.4
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.1 - 2.2.4 dieser Komponente aufgeführt.
- 2.1.3 and 2.2.0
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.3 und 2.2.0 dieser Komponente aufgeführt.
- 2.1.2
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 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.1.0
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.0 dieser Komponente aufgeführt.
- 2.0.x
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x 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.
- v2.3.10
-
logsUploaderConfiguration
-
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
-
systemLogsConfiguration
-
(Optional) Die Konfiguration für die Systemprotokolle der AWS IoT Greengrass Core-Software, die Protokolle der Greengrass-Nukleus - und Plugin-Komponenten enthalten. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
uploadToCloudWatch
-
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: false
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn Sie die Greengrass-Nucleus-Komponente für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Protokolle im JSON-Format zu aktivieren, geben Sie den Parameter JSON für das Logging-Format an (logging.format).
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. diskSpaceLimitUnit Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
-
componentLogsConfigurationMap
-
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes componentName Objekt in dieser Map definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wir empfehlen dringend, pro Komponente einen einzigen Konfigurationsschlüssel zu verwenden. Sie sollten nur auf eine Gruppe von Dateien abzielen, die nur eine Protokolldatei haben, in die aktiv geschrieben wird, wenn Sie den verwendenlogFileRegex. Die Nichtbeachtung dieser Empfehlung kann dazu führen, dass doppelte Protokolle hochgeladen werden CloudWatch. Wenn Sie mehrere aktive Protokolldateien mit einer einzigen Regex als Ziel verwenden, empfehlen wir Ihnen, auf Log Manager v2.3.1 oder höher zu aktualisieren und Ihre Konfiguration anhand der Beispielkonfiguration zu ändern.
Wenn Sie ein Upgrade von einer Version von Log Manager vor Version 2.2.0 durchführen, können Sie stattdessen weiterhin die Liste verwenden. componentLogsConfiguration componentLogsConfigurationMap Wir empfehlen jedoch dringend, das Kartenformat zu verwenden, damit Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu dem componentLogsConfiguration Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
componentName
-
Die Protokollkonfiguration für die componentName Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des AWS IoT Greengrass
Protokollierungsmoduls unter finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen EinheitdiskSpaceLimitUnit. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
logFileDirectoryPath
-
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: /greengrass/v2/logs.
logFileRegex
-
(Optional) Ein regulärer Ausdruck, der das Format des Logdateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log-Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizierenlogFileDirectoryPath.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die in der Standardausgabe (stdout) und in der Standardfehlerausgabe (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie eine Regex an, die den rotierten Protokolldateinamen entspricht. Sie können beispielsweise angebenhello_world\\\\w*.log, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das \\\\w* Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser Regex gleicht Logdateien mit und ohne Zeitstempel im Namen ab. In diesem Beispiel lädt der Logmanager die folgenden Logdateien hoch:
Standard:componentName\\\\w*.log, wobei componentName der Name der Komponente für diese Protokollkonfiguration ist.
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
multiLineStartPattern
-
(Optional) Ein regulärer Ausdruck, der angibt, wann eine Protokollnachricht in einer neuen Zeile eine neue Protokollnachricht ist. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log-Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls hängt er diese Zeile an die aktuelle Protokollnachricht an. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
-
periodicUploadIntervalSec
-
(Optional) Der Zeitraum in Sekunden, in dem die Log-Manager-Komponente nach neuen Logdateien sucht, die hochgeladen werden sollen.
Standard: 300 (5 Minuten)
Minimum: 0.000001 (1 Mikrosekunde)
updateToTlogIntervalSec
-
(Optional) Der Zeitraum in Sekunden, der angibt, wie oft der Nucleus Amazon CloudWatch Events Log-Upload-Ereignisdetails in das lokale Transaktionslog () schreibt. config.tlog Standardmäßig wird der unter angegebene Wert verwendet. periodicUploadIntervalSec Sie können diesen Parameter ändern, um das Schreibintervall zu verlängern.
Standard: periodicUploadIntervalSec
Minimum: periodicUploadIntervalSec
deprecatedVersionSupport
-
Gibt an, ob der Log Manager die in Log Manager v2.3.5 eingeführten Verbesserungen der Protokollierungsgeschwindigkeit verwenden sollte. Stellen Sie den Wert auf ein, false um die Verbesserungen zu verwenden.
Wenn Sie diesen Wert false beim Upgrade von Log Manager v2.3.1 oder einer früheren Version auf setzen, werden möglicherweise doppelte Protokolleinträge hochgeladen.
Der Standardwert ist true.
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, dass Systemprotokolle und com.example.HelloWorld Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
Beispiel Beispiel: Konfiguration zum Hochladen mehrerer aktiver Protokolldateien mit Log Manager v2.3.1
Die folgende Beispielkonfiguration ist das empfohlene Beispiel, wenn Sie mehrere aktive Protokolldateien als Ziel verwenden möchten. Diese Beispielkonfiguration gibt an, in welche aktiven Protokolldateien Sie hochladen möchten CloudWatch. Bei Verwendung dieser Konfigurationsbeispielkonfiguration werden auch alle rotierten Dateien hochgeladen, die mit den übereinstimmenlogFileRegex. Diese Beispielkonfiguration wird in Log Manager v2.3.1 unterstützt.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.3.6 – v2.3.9
-
logsUploaderConfiguration
-
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
-
systemLogsConfiguration
-
(Optional) Die Konfiguration für die Systemprotokolle der AWS IoT Greengrass Core-Software, die Protokolle der Greengrass-Nukleus - und Plugin-Komponenten enthalten. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
uploadToCloudWatch
-
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: false
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn Sie die Greengrass-Nucleus-Komponente für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Protokolle im JSON-Format zu aktivieren, geben Sie den Parameter JSON für das Logging-Format an (logging.format).
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. diskSpaceLimitUnit Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
-
componentLogsConfigurationMap
-
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes componentName Objekt in dieser Map definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wir empfehlen dringend, pro Komponente einen einzigen Konfigurationsschlüssel zu verwenden. Sie sollten nur auf eine Gruppe von Dateien abzielen, die nur eine Protokolldatei haben, in die aktiv geschrieben wird, wenn Sie den verwendenlogFileRegex. Die Nichtbeachtung dieser Empfehlung kann dazu führen, dass doppelte Protokolle hochgeladen werden CloudWatch. Wenn Sie mehrere aktive Protokolldateien mit einer einzigen Regex als Ziel verwenden, empfehlen wir Ihnen, ein Upgrade auf Log Manager v2.3.1 oder höher durchzuführen und in Betracht zu ziehen, Ihre Konfiguration anhand der Beispielkonfiguration zu ändern.
Wenn Sie ein Upgrade von einer Version von Log Manager vor Version 2.2.0 durchführen, können Sie stattdessen weiterhin die Liste verwenden. componentLogsConfiguration componentLogsConfigurationMap Wir empfehlen jedoch dringend, das Kartenformat zu verwenden, damit Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu dem componentLogsConfiguration Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
componentName
-
Die Protokollkonfiguration für die componentName Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des AWS IoT Greengrass
Protokollierungsmoduls unter finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen EinheitdiskSpaceLimitUnit. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
logFileDirectoryPath
-
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: /greengrass/v2/logs.
logFileRegex
-
(Optional) Ein regulärer Ausdruck, der das Format des Logdateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log-Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizierenlogFileDirectoryPath.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die in der Standardausgabe (stdout) und in der Standardfehlerausgabe (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie eine Regex an, die den rotierten Protokolldateinamen entspricht. Sie können beispielsweise angebenhello_world\\\\w*.log, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das \\\\w* Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser Regex gleicht Logdateien mit und ohne Zeitstempel im Namen ab. In diesem Beispiel lädt der Logmanager die folgenden Logdateien hoch:
Standard:componentName\\\\w*.log, wobei componentName der Name der Komponente für diese Protokollkonfiguration ist.
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
multiLineStartPattern
-
(Optional) Ein regulärer Ausdruck, der angibt, wann eine Protokollnachricht in einer neuen Zeile eine neue Protokollnachricht ist. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log-Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls hängt er diese Zeile an die aktuelle Protokollnachricht an. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
-
periodicUploadIntervalSec
-
(Optional) Der Zeitraum in Sekunden, in dem die Log-Manager-Komponente nach neuen Logdateien sucht, die hochgeladen werden sollen.
Standard: 300 (5 Minuten)
Minimum: 0.000001 (1 Mikrosekunde)
deprecatedVersionSupport
-
Gibt an, ob der Log-Manager die in Log Manager v2.3.5 eingeführten Verbesserungen der Protokollierungsgeschwindigkeit verwenden soll. Stellen Sie den Wert auf ein, false um die Verbesserungen zu verwenden.
Wenn Sie diesen Wert false beim Upgrade von Log Manager v2.3.1 oder einer früheren Version auf setzen, werden möglicherweise doppelte Protokolleinträge hochgeladen.
Der Standardwert ist true.
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, dass Systemprotokolle und com.example.HelloWorld Komponentenprotokolle in Logs hochgeladen werden. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
Beispiel Beispiel: Konfiguration zum Hochladen mehrerer aktiver Protokolldateien mit Log Manager v2.3.1
Die folgende Beispielkonfiguration ist das empfohlene Beispiel, wenn Sie mehrere aktive Protokolldateien als Ziel verwenden möchten. Diese Beispielkonfiguration gibt an, in welche aktiven Protokolldateien Sie hochladen möchten CloudWatch. Bei Verwendung dieser Konfigurationsbeispielkonfiguration werden auch alle rotierten Dateien hochgeladen, die mit den übereinstimmenlogFileRegex. Diese Beispielkonfiguration wird in Log Manager v2.3.1 unterstützt.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.3.0 – 2.3.5
-
logsUploaderConfiguration
-
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
-
systemLogsConfiguration
-
(Optional) Die Konfiguration für die Systemprotokolle der AWS IoT Greengrass Core-Software, die Protokolle der Greengrass-Nukleus - und Plugin-Komponenten enthalten. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
uploadToCloudWatch
-
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: false
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn Sie die Greengrass-Nucleus-Komponente für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Protokolle im JSON-Format zu aktivieren, geben Sie den Parameter JSON für das Logging-Format an (logging.format).
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. diskSpaceLimitUnit Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
-
componentLogsConfigurationMap
-
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes componentName Objekt in dieser Map definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wir empfehlen dringend, pro Komponente einen einzigen Konfigurationsschlüssel zu verwenden. Sie sollten nur auf eine Gruppe von Dateien abzielen, die nur eine Protokolldatei haben, in die aktiv geschrieben wird, wenn Sie den verwendenlogFileRegex. Die Nichtbeachtung dieser Empfehlung kann dazu führen, dass doppelte Protokolle hochgeladen werden CloudWatch. Wenn Sie mehrere aktive Protokolldateien mit einer einzigen Regex als Ziel verwenden, empfehlen wir Ihnen, auf Log Manager v2.3.1 zu aktualisieren und Ihre Konfiguration anhand der Beispielkonfiguration zu ändern.
Wenn Sie ein Upgrade von einer Version von Log Manager vor Version 2.2.0 durchführen, können Sie stattdessen weiterhin die Liste verwenden. componentLogsConfiguration componentLogsConfigurationMap Wir empfehlen jedoch dringend, das Kartenformat zu verwenden, damit Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu dem componentLogsConfiguration Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
componentName
-
Die Protokollkonfiguration für die componentName Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des AWS IoT Greengrass
Protokollierungsmoduls unter finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen EinheitdiskSpaceLimitUnit. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
logFileDirectoryPath
-
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: /greengrass/v2/logs.
logFileRegex
-
(Optional) Ein regulärer Ausdruck, der das Format des Logdateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log-Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizierenlogFileDirectoryPath.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie eine Regex an, die den rotierten Protokolldateinamen entspricht. Sie können beispielsweise angebenhello_world\\\\w*.log, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das \\\\w* Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser Regex gleicht Logdateien mit und ohne Zeitstempel im Namen ab. In diesem Beispiel lädt der Logmanager die folgenden Logdateien hoch:
Standard:componentName\\\\w*.log, wobei componentName der Name der Komponente für diese Protokollkonfiguration ist.
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
multiLineStartPattern
-
(Optional) Ein regulärer Ausdruck, der angibt, wann eine Protokollnachricht in einer neuen Zeile eine neue Protokollnachricht ist. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log-Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls hängt er diese Zeile an die aktuelle Protokollnachricht an. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
-
periodicUploadIntervalSec
-
(Optional) Der Zeitraum in Sekunden, in dem die Log-Manager-Komponente nach neuen Logdateien sucht, die hochgeladen werden sollen.
Standard: 300 (5 Minuten)
Minimum: 0.000001 (1 Mikrosekunde)
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, dass Systemprotokolle und com.example.HelloWorld Komponentenprotokolle in Logs hochgeladen werden. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
Beispiel Beispiel: Konfiguration zum Hochladen mehrerer aktiver Protokolldateien mit Log Manager v2.3.1
Die folgende Beispielkonfiguration ist das empfohlene Beispiel, wenn Sie mehrere aktive Protokolldateien als Ziel verwenden möchten. Diese Beispielkonfiguration gibt an, in welche aktiven Protokolldateien Sie hochladen möchten CloudWatch. Bei Verwendung dieser Konfigurationsbeispielkonfiguration werden auch alle rotierten Dateien hochgeladen, die mit den übereinstimmenlogFileRegex. Diese Beispielkonfiguration wird in Log Manager v2.3.1 unterstützt.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.2.x
-
logsUploaderConfiguration
-
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
-
systemLogsConfiguration
-
(Optional) Die Konfiguration für die Systemprotokolle der AWS IoT Greengrass Core-Software, die Protokolle der Greengrass-Nukleus - und Plugin-Komponenten enthalten. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
uploadToCloudWatch
-
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: false
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn Sie die Greengrass-Nucleus-Komponente für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Protokolle im JSON-Format zu aktivieren, geben Sie JSON für den Logging-Formatparameter (logging.format) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. diskSpaceLimitUnit Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
-
componentLogsConfigurationMap
-
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes componentName Objekt in dieser Map definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wenn Sie ein Upgrade von einer Version von Log Manager vor Version 2.2.0 durchführen, können Sie stattdessen weiterhin die componentLogsConfiguration Liste verwenden. componentLogsConfigurationMap Wir empfehlen jedoch dringend, das Kartenformat zu verwenden, damit Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu dem componentLogsConfiguration Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
componentName
-
Die Protokollkonfiguration für die componentName Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des AWS IoT Greengrass
Protokollierungsmoduls unter finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen EinheitdiskSpaceLimitUnit. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
logFileDirectoryPath
-
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: /greengrass/v2/logs.
logFileRegex
-
(Optional) Ein regulärer Ausdruck, der das Format des Logdateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log-Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizierenlogFileDirectoryPath.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die in der Standardausgabe (stdout) und in der Standardfehlerausgabe (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie eine Regex an, die den rotierten Protokolldateinamen entspricht. Sie können beispielsweise angebenhello_world\\\\w*.log, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das \\\\w* Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser Regex gleicht Logdateien mit und ohne Zeitstempel im Namen ab. In diesem Beispiel lädt der Logmanager die folgenden Logdateien hoch:
Standard:componentName\\\\w*.log, wobei componentName der Name der Komponente für diese Protokollkonfiguration ist.
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
multiLineStartPattern
-
(Optional) Ein regulärer Ausdruck, der angibt, wann eine Protokollnachricht in einer neuen Zeile eine neue Protokollnachricht ist. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log-Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls hängt er diese Zeile an die aktuelle Protokollnachricht an. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
-
periodicUploadIntervalSec
-
(Optional) Der Zeitraum in Sekunden, in dem die Log-Manager-Komponente nach neuen Logdateien sucht, die hochgeladen werden sollen.
Standard: 300 (5 Minuten)
Minimum: 0.000001 (1 Mikrosekunde)
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, dass Systemprotokolle und com.example.HelloWorld Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
- v2.1.x
-
logsUploaderConfiguration
-
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
-
systemLogsConfiguration
-
(Optional) Die Konfiguration für die Systemprotokolle der AWS IoT Greengrass Core-Software, die Protokolle der Greengrass-Nukleus - und Plugin-Komponenten enthalten. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
uploadToCloudWatch
-
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: false
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn Sie die Greengrass-Nucleus-Komponente für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Protokolle im JSON-Format zu aktivieren, geben Sie den Parameter JSON für das Logging-Format an (logging.format).
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. diskSpaceLimitUnit Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
-
componentLogsConfiguration
-
(Optional) Eine Liste der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jede Konfiguration in dieser Liste definiert die Protokollkonfiguration für eine Komponente oder Anwendung. Die Log Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch CloudWatch
Jedes Objekt enthält die folgenden Informationen:
componentName
-
Der Name der Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des AWS IoT Greengrass
Protokollierungsmoduls unter finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen EinheitdiskSpaceLimitUnit. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
logFileDirectoryPath
-
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: /greengrass/v2/logs.
logFileRegex
-
(Optional) Ein regulärer Ausdruck, der das Format des Logdateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log-Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizierenlogFileDirectoryPath.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die in der Standardausgabe (stdout) und in der Standardfehlerausgabe (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie eine Regex an, die den rotierten Protokolldateinamen entspricht. Sie können beispielsweise angebenhello_world\\\\w*.log, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das \\\\w* Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Diese Regex gleicht Logdateien mit und ohne Zeitstempel im Namen ab. In diesem Beispiel lädt der Logmanager die folgenden Logdateien hoch:
Standard:componentName\\\\w*.log, wobei componentName der Name der Komponente für diese Protokollkonfiguration ist.
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
multiLineStartPattern
-
(Optional) Ein regulärer Ausdruck, der angibt, wann eine Protokollnachricht in einer neuen Zeile eine neue Protokollnachricht ist. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log-Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls hängt er diese Zeile an die aktuelle Protokollnachricht an. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
-
periodicUploadIntervalSec
-
(Optional) Der Zeitraum in Sekunden, in dem die Log-Manager-Komponente nach neuen Logdateien sucht, die hochgeladen werden sollen.
Standard: 300 (5 Minuten)
Minimum: 0.000001 (1 Mikrosekunde)
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, dass Systemprotokolle und com.example.HelloWorld Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
- v2.0.x
-
logsUploaderConfiguration
-
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
systemLogsConfiguration
-
(Optional) Die Konfiguration für Systemprotokolle der AWS IoT Greengrass Kernsoftware. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
uploadToCloudWatch
-
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: false
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn Sie die Greengrass-Nucleus-Komponente für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Protokolle im JSON-Format zu aktivieren, geben Sie den Parameter JSON für das Logging-Format an (logging.format).
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. diskSpaceLimitUnit Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: false
componentLogsConfiguration
-
(Optional) Eine Liste der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jede Konfiguration in dieser Liste definiert die Protokollkonfiguration für eine Komponente oder Anwendung. Die Log Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch CloudWatch
Jedes Objekt enthält die folgenden Informationen:
componentName
-
Der Name der Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
minimumLogLevel
-
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des AWS IoT Greengrass
Protokollierungsmoduls unter finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
Standard: INFO
diskSpaceLimit
-
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen EinheitdiskSpaceLimitUnit. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die Log-Größenbeschränkung (totalLogsSizeKB) der Greengrass-Nucleus-Komponente. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
diskSpaceLimitUnit
-
(Optional) Die Einheit für diediskSpaceLimit. Wählen Sie aus den folgenden Optionen aus:
-
KB— Kilobyte
-
MB— Megabyte
-
GB— Gigabyte
Standard: KB
logFileDirectoryPath
-
Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Um die Logs einer Greengrass-Komponente hochzuladen/greengrass/v2/logs, geben Sie diesen an und /greengrass/v2 ersetzen Sie ihn durch Ihren Greengrass-Stammordner.
logFileRegex
-
Ein regulärer Ausdruck, der das Format des Logdateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizierenlogFileDirectoryPath.
Um die Logs einer Greengrass-Komponente hochzuladen, geben Sie eine Regex an, die den rotierten Logdateinamen entspricht. Sie können beispielsweise angebencom.example.HelloWorld\\w*.log, dass Protokolle für eine Hello World-Komponente hochgeladen werden sollen. Das \\w* Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser Regex gleicht Logdateien mit und ohne Zeitstempel im Namen ab. In diesem Beispiel lädt der Log-Manager die folgenden Logdateien hoch:
-
com.example.HelloWorld.log— Die neueste Protokolldatei für die Hello World-Komponente.
-
com.example.HelloWorld_2020_12_15_17_0.log— Eine ältere Protokolldatei für die Hello World-Komponente. Der Greengrass-Kern fügt den Logdateien einen rotierenden Zeitstempel hinzu.
deleteLogFileAfterCloudUpload
-
(Optional) Sie können eine Logdatei löschen, nachdem die Log-Manager-Komponente die Logs in Logs hochgeladen hat. CloudWatch
Standard: false
multiLineStartPattern
-
(Optional) Ein regulärer Ausdruck, der angibt, wann eine Protokollnachricht in einer neuen Zeile eine neue Protokollnachricht ist. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log-Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls hängt er diese Zeile an die aktuelle Protokollnachricht an. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
periodicUploadIntervalSec
-
(Optional) Der Zeitraum in Sekunden, in dem die Log-Manager-Komponente nach neuen Logdateien sucht, die hochgeladen werden sollen.
Standard: 300 (5 Minuten)
Minimum: 0.000001 (1 Mikrosekunde)
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, dass Systemprotokolle und com.example.HelloWorld Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"logFileDirectoryPath": "/greengrass/v2/logs",
"logFileRegex": "com.example.HelloWorld\\w*.log",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
Usage
Die Log Manager-Komponente lädt in die folgenden Loggruppen und Logstreams hoch.
- 2.1.0 and later
-
- Name der Protokollgruppe
-
/aws/greengrass/componentType/region/componentName
Der Name der Protokollgruppe verwendet die folgenden Variablen:
-
componentType— Der Typ der Komponente. Dabei kann es sich um eine der folgenden handeln:
-
GreengrassSystemComponent— Diese Protokollgruppe enthält Protokolle für die Nucleus- und Plugin-Komponenten, die in derselben JVM wie der Greengrass-Nucleus ausgeführt werden. Die Komponente ist Teil des Greengrass-Kerns.
-
UserComponent— Diese Protokollgruppe enthält Protokolle für generische Komponenten, Lambda-Komponenten und andere Anwendungen auf dem Gerät. Die Komponente ist nicht Teil des Greengrass-Kerns.
Weitere Informationen finden Sie unter Komponententypen.
-
region— Die AWS Region, die das Kerngerät verwendet.
-
componentName— Der Name der Komponente. Für Systemprotokolle ist dieser WertSystem.
- Name des Log-Streams
-
/date/thing/thingName
Der Name des Log-Streams verwendet die folgenden Variablen:
-
date— Das Datum des Protokolls, z. 2020/12/15 B. Die Log-Manager-Komponente verwendet das yyyy/MM/dd Format.
-
thingName— Der Name des Kerngeräts.
Wenn der Name eines Dings einen Doppelpunkt (:) enthält, ersetzt der Logmanager den Doppelpunkt durch ein Plus (+).
- 2.0.x
-
- Name der Protokollgruppe
-
/aws/greengrass/componentType/region/componentName
Der Name der Protokollgruppe verwendet die folgenden Variablen:
-
componentType— Der Typ der Komponente. Dabei kann es sich um eine der folgenden handeln:
-
GreengrassSystemComponent— Die Komponente ist Teil des Greengrass-Kerns.
-
UserComponent— Die Komponente ist nicht Teil des Greengrass-Kerns. Der Log Manager verwendet diesen Typ für Greengrass-Komponenten und andere Anwendungen auf dem Gerät.
-
region— Die AWS Region, die das Kerngerät verwendet.
-
componentName— Der Name der Komponente. Für Systemprotokolle ist dieser WertSystem.
- Name des Log-Streams
-
/date/deploymentTargets/thingName
Der Name des Log-Streams verwendet die folgenden Variablen:
-
date— Das Datum des Protokolls, z. 2020/12/15 B. Die Log Manager-Komponente verwendet das yyyy/MM/dd Format.
-
deploymentTargets— Die Dinge, zu deren Installationen die Komponente gehört. Die Log Manager-Komponente trennt jedes Ziel durch einen Schrägstrich. Wenn die Komponente aufgrund einer lokalen Bereitstellung auf dem Kerngerät ausgeführt wird, lautet LOCAL_DEPLOYMENT dieser Wert.
Stellen Sie sich ein Beispiel vorMyGreengrassCore, bei dem Sie ein Kerngerät benannt haben und das Kerngerät zwei Bereitstellungen hat:
-
Eine Bereitstellung, die auf das Kerngerät abzielt,MyGreengrassCore.
-
Eine Bereitstellung, die auf eine Dinggruppe mit dem Namen abzieltMyGreengrassCoreGroup, die das Kerngerät enthält.
Die deploymentTargets für dieses Kerngerät sindthing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup.
-
thingName— Der Name des Kerngeräts.
Formate für Logeinträge.
Der Greengrass-Nukleus schreibt Protokolldateien entweder im Zeichenketten- oder im JSON-Format. Bei Systemprotokollen steuern Sie das Format, indem Sie das format Feld des logging Eintrags festlegen. Sie finden den logging Eintrag in der Konfigurationsdatei der Greengrass Nucleus-Komponente. Weitere Informationen finden Sie unter Greengrass Nucleus-Konfiguration.
Das Textformat ist frei und akzeptiert jede beliebige Zeichenfolge. Die folgende Meldung des Flottenstatusdienstes ist ein Beispiel für eine Protokollierung im Zeichenkettenformat:
2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published.
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService,
currentState=RUNNING}
Sie sollten das JSON-Format verwenden, wenn Sie Logs mit dem Greengrass CLI-Logs-Befehl anzeigen oder programmgesteuert mit Logs interagieren möchten. Das folgende Beispiel skizziert die JSON-Form:
{
"loggerName": <string>,
"level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
"eventType": <string, optional>,
"cause": <string, optional>,
"contexts": {},
"thread": <string>,
"message": <string>,
"timestamp": <epoch time> # Needs to be epoch time
}
Um die Ausgabe der Protokolle Ihrer Komponente zu steuern, können Sie die minimumLogLevel Konfigurationsoption verwenden. Um diese Option verwenden zu können, muss Ihre Komponente ihre Protokolleinträge im JSON-Format schreiben. Sie sollten dasselbe Format wie die Systemprotokolldatei verwenden.
Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die Greengrass Nucleus-Komponente.
- Linux
-
/greengrass/v2/logs/greengrass.log
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Um die Protokolle dieser Komponente einzusehen
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
|
Version
|
Änderungen
|
|
2.3.14
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.13
|
Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.18.0.
|
|
2.3.12
|
Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.17.0.
|
|
2.3.11
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.10
|
- Neue Features
-
-
Fügt einen neuen Konfigurationsschlüssel (updateToTlogIntervalSec) hinzu, um die Häufigkeit zu steuern, mit der Log-Upload-Ereignisdetails im lokalen Transaktionslog () gespeichert werden. config.tlog
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.9
|
Die Version wurde für die Greengrass Nucleus-Version 2.14.0 aktualisiert.
|
|
2.3.8
|
Die Version wurde für die Greengrass Nucleus-Version 2.13.0 aktualisiert.
|
|
2.3.7
|
Die Version wurde für die Greengrass Nucleus-Version 2.12.0 aktualisiert.
|
|
2.3.6
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.5
|
- Verbesserungen
-
Verbessert die Geschwindigkeit beim Hochladen von Protokollen.
Die Version wurde für die Greengrass Nucleus-Version 2.11.0 aktualisiert. |
|
2.3.4
|
- Fehlerbehebungen und Verbesserungen
-
-
Integriert die Unterstützung für das Setzen des periodicUploadIntervalSec Parameters auf Bruchwerte. Das Minimum ist 1 Mikrosekunde.
-
Behebt ein Problem, bei dem der Log-Manager die CloudWatch putLogEvents Grenzwerte nicht einhält.
|
|
2.3.3
|
Die Version wurde für die Greengrass Nucleus-Version 2.10.0 aktualisiert.
|
|
2.3.2
|
- Fehlerbehebungen und Verbesserungen
-
-
Verbessert die Speicherplatzverwaltung, sodass Protokolldateien nicht gelöscht werden, bevor sie hochgeladen werden.
-
Behebt Probleme mit der Cache-Verwaltung.
-
Weitere kleinere Fehlerkorrekturen und Verbesserungen.
|
|
2.3.1
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem Zieldateigruppen mit mehreren aktiven Protokolldateien doppelte Einträge hochladen. CloudWatch
-
Weitere kleinere Fehlerkorrekturen und Verbesserungen.
|
|
2.3.0
|
Wir empfehlen Ihnen, ein Upgrade auf Greengrass Nucleus 2.9.1 durchzuführen, wenn Sie auf Log Manager 2.3.0 aktualisieren.
- Neue Features
-
Reduziert Verzögerungen bei der Protokollierung, indem aktive Protokolldateien verarbeitet und direkt hochgeladen werden, anstatt darauf zu warten, dass neue Dateien rotiert werden.
- Fehlerbehebungen und Verbesserungen
-
|
|
2.2.8
|
Die Version wurde für die Greengrass Nucleus-Version 2.9.0 aktualisiert. |
|
2.2.7
|
Die Version wurde für die Greengrass Nucleus-Version 2.8.0 aktualisiert. |
|
2.2.6
|
Die Version wurde für die Greengrass Nucleus-Version 2.7.0 aktualisiert.
|
|
2.2.5
|
Die Version wurde für die Greengrass Nucleus-Version 2.6.0 aktualisiert.
|
|
2.2.4
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.2.3
|
- Fehlerbehebungen und Verbesserungen
-
-
Verbessert die Stabilität in bestimmten Szenarien, in denen die Komponente neu gestartet wird oder Fehler auftreten.
-
Behebt Probleme, bei denen große Protokollnachrichten und große Protokolldateien in bestimmten Szenarien nicht hochgeladen werden konnten.
-
Behebt Probleme mit der Art und Weise, wie diese Komponente Aktualisierungen zum Zurücksetzen der Konfiguration verarbeitet.
-
Behebt ein Problem, bei dem ein null diskSpaceLimit Konfigurationswert die Bereitstellung der Komponente verhinderte.
|
|
2.2.2
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.2.1
|
Die Version wurde für die Greengrass Nucleus-Version 2.5.0 aktualisiert.
|
|
2.2.0
|
|
|
2.1.3
|
Die Version wurde für die Greengrass Nucleus-Version 2.4.0 aktualisiert.
|
|
2.1.2
|
Die Version wurde für die Greengrass Nucleus-Version 2.3.0 aktualisiert.
|
|
2.1.1
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.1.0
|
- Fehlerbehebungen und Verbesserungen
-
-
Verwenden Sie Standardwerte für logFileDirectoryPath Greengrass-KomponentenlogFileRegex, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken, und die für diese funktionieren.
-
Leiten Sie den Datenverkehr korrekt über einen konfigurierten Netzwerk-Proxy weiter, wenn Sie Protokolle in Logs hochladen. CloudWatch
-
Behandeln Sie Doppelpunkte (:) in Log-Stream-Namen korrekt. CloudWatch Log-Log-Stream-Namen unterstützen keine Doppelpunkte.
-
Vereinfachen Sie die Namen von Log-Streams, indem Sie Dinggruppennamen aus dem Log-Stream entfernen.
-
Entfernen Sie eine Fehlerprotokollmeldung, die bei normalem Verhalten ausgegeben wird.
|
|
2.0.x
|
Erste Version
|