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.
Verwenden Sie den logs
Befehl, um Greengrass-Protokolle auf Ihrem Kerngerät zu analysieren.
Unterbefehle
get
Sammeln, filtern und visualisieren Sie Greengrass-Protokolldateien. Dieser Befehl unterstützt nur Protokolldateien im JSON-Format. Sie können das Logging-Format in der Nucleus-Konfiguration angeben.
- Syntax
-
greengrass-cli logs get [--log-dir
path/to/a/log/folder
] [--log-filepath/to/a/log/file
] [--follow true | false ] [--filter<filter>
] [--time-window<start-time>
,<end-time>
] [--verbose ] [--no-color ] [--before<value>
] [--after<value>
] [--syslog ] [--max-long-queue-size<value>
] - Argumente
-
-
--log-dir
,-ld
. Der Pfad zu dem Verzeichnis, in dem nach Protokolldateien gesucht werden soll, z.
B. Nicht mit verwenden
/logs/greengrass/v2
--syslog
. Verwenden Sie für jedes weitere Verzeichnis, das Sie angeben möchten, ein separates Argument. Sie müssen mindestens einen von--log-dir
oder verwenden--log-file
. Sie können auch beide Argumente in einem einzigen Befehl verwenden. -
--log-file
,-lf
. Die Pfade zu den Protokollverzeichnissen, die Sie verwenden möchten. Verwenden Sie für jedes weitere Verzeichnis, das Sie angeben möchten, ein separates Argument. Sie müssen mindestens einen von--log-dir
oder verwenden--log-file
. Sie können auch beide Argumente in einem einzigen Befehl verwenden. -
--follow
,-fol
. Zeigt Protokollaktualisierungen an, sobald sie auftreten. Greengrass CLI läuft weiter und liest aus den angegebenen Protokollen. Wenn Sie ein Zeitfenster angeben, stoppt Greengrass CLI die Überwachung der Protokolle, nachdem alle Zeitfenster abgelaufen sind. -
--filter
,-f
. Das Schlüsselwort, die regulären Ausdrücke oder das Schlüssel-Wert-Paar, das als Filter verwendet werden soll. Geben Sie diesen Wert als Zeichenfolge, als regulären Ausdruck oder als Schlüssel-Wert-Paar an. Verwenden Sie für jeden weiteren Filter, den Sie angeben möchten, ein separates Argument.Bei der Auswertung werden mehrere Filter, die in einem einzigen Argument angegeben sind, durch OR-Operatoren getrennt, und in zusätzlichen Argumenten angegebene Filter werden mit AND-Operatoren kombiniert. Wenn Ihr Befehl beispielsweise beinhaltet
--filter "installed" --filter "name=alpha,name=beta"
, filtert und zeigt Greengrass CLI Protokollnachrichten an, die sowohl das Schlüsselwortinstalled
als auch einenname
Schlüssel mit den Wertenalpha
oderbeta
enthalten. -
--time-window
,-t
. Das Zeitfenster, für das Protokollinformationen angezeigt werden sollen. Sie können sowohl exakte Zeitstempel als auch relative Offsets verwenden. Sie müssen diese Informationen im folgenden Format angeben.
Wenn Sie weder die Startzeit noch die Endzeit angeben, wird als Wert für diese Option standardmäßig das aktuelle Systemdatum und die aktuelle Systemzeit verwendet. Verwenden Sie für jedes weitere Zeitfenster, das Sie angeben möchten, ein separates Argument.<begin-time>
,<end-time>
Greengrass CLI unterstützt die folgenden Formate für Zeitstempel:
-
yyyy-MM-DD
, zum Beispiel.2020-06-30
Die Uhrzeit ist standardmäßig 00:00:00, wenn Sie dieses Format verwenden.yyyyMMDD
, zum Beispiel.20200630
Die Uhrzeit ist standardmäßig 00:00:00, wenn Sie dieses Format verwenden.HH:mm:ss
, zum Beispiel.15:30:45
Wenn Sie dieses Format verwenden, entspricht das Datum standardmäßig dem aktuellen Systemdatum.HH:mm:ssSSS
, zum Beispiel.15:30:45
Das Datum ist standardmäßig das aktuelle Systemdatum, wenn Sie dieses Format verwenden.YYYY-MM-DD'T'HH:mm:ss'Z'
, zum Beispiel.2020-06-30T15:30:45Z
YYYY-MM-DD'T'HH:mm:ss
, zum Beispiel2020-06-30T15:30:45
.yyyy-MM-dd'T'HH:mm:ss.SSS
, zum Beispiel2020-06-30T15:30:45.250
.
Relative Offsets geben einen Zeitraum an, der von der aktuellen Systemzeit abweicht. Greengrass CLI unterstützt das folgende Format für relative Offsets:.
+|-[<
value
>h|hr|hours][value
m|min|minutes][value
]s|sec|secondsZum Beispiel das folgende Argument zur Angabe eines Zeitfensters zwischen 1 Stunde und 2 Stunden 15 Minuten vor der aktuellen Uhrzeit.
--time-window -2h15min,-1hr
-
-
--verbose
. Zeigt alle Felder aus den Protokollnachrichten an. Nicht mit verwenden--syslog
. -
--no-color
,-nc
. Entfernen Sie die Farbcodierung. Die Standardfarbcodierung für Protokollnachrichten verwendet fett gedruckten roten Text. Unterstützt nur UNIX-ähnliche Terminals, da ANSI-Escape-Sequenzen verwendet werden. -
--before
-b
,. Die Anzahl der Zeilen, die vor einem übereinstimmenden Protokolleintrag angezeigt werden sollen. Standard = 0. -
--after
,-a
. Die Anzahl der Zeilen, die nach einem übereinstimmenden Protokolleintrag angezeigt werden sollen. Standard = 0. -
--syslog
. Verarbeitet alle Protokolldateien mit dem Syslog-Protokoll, das von definiert ist. RFC3164 Nicht zusammen mit--log-dir
und verwenden.--verbose
Das Syslog-Protokoll verwendet das folgende Format:."<$Priority>$Timestamp $Host $Logger ($Class): $Message"
Wenn Sie keine Protokolldatei angeben, liest Greengrass CLI Protokollnachrichten von den folgenden Speicherorten:/var/log/messages
,/var/log/syslog
, oder der/var/log/system.log
.AWS IoT Greengrass unterstützt diese Funktion derzeit nicht auf Windows Core-Geräten.
-
--max-log-queue-size
,-m
. Die maximale Anzahl von Protokolleinträgen, die dem Speicher zugewiesen werden sollen. Verwenden Sie diese Option, um die Speichernutzung zu optimieren. Die Standardeinstellung ist 100.
-
- Ausgabe
-
Das folgende Beispiel zeigt die Ausgabe, die erzeugt wird, wenn Sie diesen Befehl ausführen.
$ sudo greengrass-cli logs get --verbose \ --log-file /greengrass/v2/logs/greengrass.log \ --filter deployment,serviceName=DeploymentService \ --filter level=INFO \ --time-window 2020-12-08T01:11:17,2020-12-08T01:11:22 2020-12-08T01:11:17.615Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.DeploymentService: Current deployment finished. {DeploymentId=44d89f46-1a29-4044-ad89-5151213dfcbc, serviceName=DeploymentService, currentState=RUNNING} 2020-12-08T01:11:17.675Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.IotJobsHelper: Updating status of persisted deployment. {Status=SUCCEEDED, StatusDetails={detailed-deployment-status=SUCCESSFUL}, ThingName=MyThing, JobId=22d89f46-1a29-4044-ad89-5151213dfcbc
Stichwörter auflisten
Zeigt vorgeschlagene Stichwörter an, die Sie zum Filtern von Protokolldateien verwenden können.
- Syntax
-
greengrass-cli logs list-keywords [arguments]
- Argumente
-
Keine
- Ausgabe
-
Die folgenden Beispiele zeigen die Ausgabe, die bei der Ausführung dieses Befehls erzeugt wird.
$ sudo greengrass-cli logs list-keywords Here is a list of suggested keywords for Greengrass log: level=$str thread=$str loggerName=$str eventType=$str serviceName=$str error=$str
$ sudo greengrass-cli logs list-keywords --syslog Here is a list of suggested keywords for syslog: priority=$int host=$str logger=$str class=$str
list-log-files
Zeigt Protokolldateien an, die sich in einem angegebenen Verzeichnis befinden.
- Syntax
-
greengrass-cli logs list-log-files [arguments]
- Argumente
-
--log-dir
,-ld
. Der Pfad zu dem Verzeichnis, in dem nach Protokolldateien gesucht werden soll. - Ausgabe
-
Das folgende Beispiel zeigt die Ausgabe, die bei der Ausführung dieses Befehls erzeugt wird.
$ sudo greengrass-cli logs list-log-files -ld /greengrass/v2/logs/ /greengrass/v2/logs/aws.greengrass.Nucleus.log /greengrass/v2/logs/main.log /greengrass/v2/logs/greengrass.log Total 3 files found.