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 Lebenszyklusskripte 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 Log- 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, stellt AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. 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	Art 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	Art 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 der System-Log-Forwarder versucht, Protokolle hochzuladen. Da die Protokollweiterleitung Protokolle hochlädt, wenn der Speicher voll ist, kann es dennoch vorkommen, dass sie öfter als die konfigurierte maximale Schrittfrequenz hochlädt.

maxRetriesCount

Gibt an, wie oft der System-Log-Forwarder versucht, einen vorübergehenden HTTP-Fehler zu wiederholen.

bufferCapacity

Die Größe des Ringpuffers für die Speicherung von Protokollen im Arbeitsspeicher.

logGroup

Der Protokollpfad in CloudWatch.

logStream

Der CloudWatch LogStream.

filters

Eine Übersicht 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, mindestens einem der Filter in dieser Liste entspricht. Bei den Filtern in dieser Liste kann es sich entweder um eine Zeichenfolge handeln, der der Dienstname vollständig entsprechen muss, oder um 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, mindestens einem der Filter in dieser Liste entspricht.

Anmerkung

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

Beispielkonfiguration:

Das folgende Beispiel filtert Logs 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.