Protokolle - AWS IoT Greengrass
getlist-keywordslist-log-files

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.

Protokolle

Verwenden Sie den logs Befehl , um Greengrass-Protokolle auf Ihrem Core-Gerät zu analysieren.

Unterbefehle

get

Sammeln, filtern und visualisieren Sie Greengrass-Protokolldateien. Dieser Befehl unterstützt nur JSON-formatierte Protokolldateien. Sie können das Protokollierungsformat in der -Kernkonfiguration angeben.

Syntax
greengrass-cli logs get
    [--log-dir path/to/a/log/folder]
    [--log-file path/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 zum Verzeichnis, das auf Protokolldateien geprüft werden soll, z. B. /greengrass/v2/logs. Verwenden Sie nicht mit --syslog. Verwenden Sie ein separates Argument für jedes anzugebende zusätzliche Verzeichnis. 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 ein separates Argument für jedes anzugebende zusätzliche Verzeichnis. 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. Zeigen Sie Protokollaktualisierungen an, sobald sie auftreten. Die Greengrass-CLI wird weiterhin ausgeführt und liest aus den angegebenen Protokollen. Wenn Sie ein Zeitfenster angeben, stoppt die Greengrass-CLI die Überwachung von Protokollen, nachdem alle Zeitfenster beendet wurden.

  • --filter, -f. Das Schlüsselwort, reguläre Ausdrücke oder 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 anzugebenden zusätzlichen Filter ein separates Argument.

    Bei der Auswertung werden mehrere Filter, die in einem einzigen Argument angegeben sind, durch ODER-Operatoren getrennt, und Filter, die in zusätzlichen Argumenten angegeben sind, werden mit AND-Operatoren kombiniert. Wenn Ihr Befehl beispielsweise enthält--filter "installed" --filter "name=alpha,name=beta", filtert und zeigt Greengrass CLI Protokollmeldungen an, die sowohl das Schlüsselwort als auch installed einen name Schlüssel mit den Werten alpha oder enthaltenbeta.

  • --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 Format angeben<begin-time>,<end-time>. Wenn Sie weder die Start- noch die Endzeit angeben, wird der Wert für diese Option standardmäßig auf das aktuelle Systemdatum und die aktuelle Systemzeit festgelegt. Verwenden Sie ein separates Argument für jedes zusätzliche Zeitfenster, um anzugeben.

    Greengrass CLI unterstützt die folgenden Formate für Zeitstempel:

    • yyyy-MM-DD, z. B. 2020-06-30. Die Standardzeit ist 00:00:00, wenn Sie dieses Format verwenden.

      yyyyMMDD, z. B. 20200630. Die Standardzeit ist 00:00:00, wenn Sie dieses Format verwenden.

      HH:mm:ss, z. B. 15:30:45. Das Datum ist standardmäßig das aktuelle Systemdatum, wenn Sie dieses Format verwenden.

      HH:mm:ssSSS, z. B. 15:30:45. Das Datum ist standardmäßig das aktuelle Systemdatum, wenn Sie dieses Format verwenden.

      YYYY-MM-DD'T'HH:mm:ss'Z', z. B. 2020-06-30T15:30:45Z.

      YYYY-MM-DD'T'HH:mm:ss, z. B. 2020-06-30T15:30:45.

      yyyy-MM-dd'T'HH:mm:ss.SSS, z. B. 2020-06-30T15:30:45.250.

    Relative Offsets geben einen Offset des Zeitraums von der aktuellen Systemzeit an. Die Greengrass-CLI unterstützt das folgende Format für relative Offsets: +|-[<value>h|hr|hours][valuem|min|minutes][value]s|sec|seconds.

    Zum Beispiel das folgende Argument zur Angabe eines Zeitfensters zwischen 1 Stunde und 2 Stunden und 15 Minuten, bevor die aktuelle Zeit ist--time-window -2h15min,-1hr.

  • --verbose. Zeigen Sie alle Felder aus den Protokollmeldungen an. Verwenden Sie nicht mit --syslog.

  • --no-color, -nc. Entfernen Sie die Farbkodierung. Die Standard-Farbkodierung für Protokollmeldungen verwendet fettroten 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. Verarbeiten Sie alle Protokolldateien mit dem von RFC3164 definierten Syslog-Protokoll. Verwenden Sie nicht mit --log-dir und --verbose. Das Syslog-Protokoll verwendet das folgende Format: "<$Priority>$Timestamp $Host $Logger ($Class): $Message". Wenn Sie keine Protokolldatei angeben, liest die Greengrass-CLI Protokollmeldungen von den folgenden Speicherorten: /var/log/messages/var/log/syslog, oder /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. Der Standardwert 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

list-keywords

Zeigen Sie vorgeschlagene Schlüsselwörter an, mit denen Sie Protokolldateien filtern können.

Syntax
greengrass-cli logs list-keywords [arguments]
Argumente

None

Ausgabe

Die folgenden Beispiele zeigen die Ausgabe, die erzeugt wird, wenn Sie diesen Befehl ausführen.

$ 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

Zeigen Sie Protokolldateien an, die sich in einem angegebenen Verzeichnis befinden.

Syntax
greengrass-cli logs list-log-files [arguments]
Argumente

--log-dir, -ld. Der Pfad zum Verzeichnis, das auf Protokolldateien geprüft werden soll.

Ausgabe

Das folgende Beispiel zeigt die Ausgabe, die erzeugt wird, wenn Sie diesen Befehl ausführen.

$ 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.