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.

Systemprotokollweiterleitung

Der System Log Forwarder (aws.greengrass.SystemLogForwarder) lädt aktive Systemprotokolle CloudWatch mithilfe der CloudWatch HTTPS-API direkt zu Amazon hoch.

Versionen

Diese Komponente hat die folgenden Versionen:

Typ

Diese Komponente ist eine generische Komponente (aws.greengrass.generic). Der Greengrass-Kern führt die Lifecycle-Skripte der Komponente aus.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Diese Komponente muss auf systemd-basierten Linux-Systemen installiert werden.

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

Die Komponente benötigt Zugriff zum Erstellen von Protokoll- und Stream-Gruppen CloudWatch sowie die Erlaubnis, den PutLogEvents HTTP-Aufruf durchzuführen. Sie müssen dem Rollenalias Ihres Greengrass-Geräts mindestens die folgenden Richtlinienberechtigungen hinzufügen:

JSON

{
    "Version":"2012-10-17",
    "Statement": [
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogGroup"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*"
    },
    {
      "Effect": "Allow",
      "Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}"
    }
  ]
}

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.

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.1.x

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.x dieser Komponente aufgeführt.

-Abhängigkeit	Kompatible Versionen	Typ der Abhängigkeit
Token-Austauschdienst	> =2,0,0	Hart
Greengrass Nucleus lite	> =2,3,0	Weich

2.0.x

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.

-Abhängigkeit	Kompatible Versionen	Typ der Abhängigkeit
Token-Austauschdienst	> =2,0,0	Hart

Konfiguration

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

2.0.x-2.1.x

maxUploadIntervalSec

Der maximale Zeitraum, in dem die Systemprotokollweiterleitung versucht, Protokolle hochzuladen. Da der Log-Forwarder Protokolle hochlädt, wenn der Speicher voll ist, kann es dennoch vorkommen, dass er öfter als die konfigurierte maximale Schrittfrequenz hochgeladen wird.

maxRetriesCount

Häufigkeit, mit der die Systemprotokollweiterleitung versucht, einen vorübergehenden HTTP-Fehler erneut zu versuchen.

bufferCapacity

Die Größe des Ringpuffers für die speicherinterne Protokollspeicherung.

logGroup

Der Log-Pfad in CloudWatch.

logStream

Der CloudWatch LogStream.

filters

Eine Karte der Filterkonfigurationen für das Kerngerät.

services

Eine Liste von Dienstnamenfiltern, anhand derer System Log Forwarder bestimmt, welche Protokolle hochgeladen werden. Ein Protokoll wird nur hochgeladen, wenn der Dienst, von dem es stammt, mit mindestens einem der Filter in dieser Liste übereinstimmt. Die Filter in dieser Liste können entweder eine Zeichenfolge sein, mit der der Dienstname vollständig übereinstimmen muss, oder eine Zeichenfolge, die mit * endet, was bedeutet, dass das Präfix übereinstimmen muss.

Standard: [ggl.*]

Wichtig

Ein Protokoll wird nur hochgeladen, wenn der Dienst, von dem es stammt, mit mindestens einem der Filter in dieser Liste übereinstimmt.

Anmerkung

Wenn Sie den Wert * verwenden, werden alle verfügbaren Dienste eingeschlossen.

Beispiel Beispielkonfiguration:

Das folgende Beispiel filtert Protokolle nach allen Diensten, die in Greengrass Nucleus Lite enthalten sind.

{
    "maxUploadIntervalSec": 300,
    "maxRetriesCount": 3,
    "bufferCapacity": 1048576,
    "logGroup": "greengrass/systemLogs",
    "logStream": "deviceName",
    "filters": {
        "services": ["ggl.*"]
    }
}

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.