Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Inoltro di log di sistema

Il System log forwarder (aws.greengrass.SystemLogForwarder) carica i log di sistema attivi direttamente su Amazon CloudWatch utilizzando l'API HTTPS. CloudWatch

Versioni

Questo componente ha le seguenti versioni:

Tipo

Questo componente è un componente generico () aws.greengrass.generic. Il nucleo Greengrass esegue gli script del ciclo di vita del componente.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente deve essere installato su sistemi Linux basati su sistema.

Requisiti

Questo componente presenta i seguenti requisiti:

Il componente richiede l'accesso per creare gruppi di log e stream, CloudWatch nonché l'autorizzazione per eseguire la chiamata PutLogEvents HTTP. È necessario aggiungere almeno le seguenti autorizzazioni di policy all'alias di ruolo del dispositivo Greengrass:

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}"
    }
  ]
}

Endpoint e porte

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

2.1.x

La tabella seguente elenca le dipendenze per la versione 2.1.x di questo componente.

Dipendenza	Versioni compatibili	Tipo di dipendenza
Servizio di scambio di token	>=2.0.0	Rigidi
Greengrass Nucleus Lite	>=2.3.0	Flessibili

2.0.x

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.

Dipendenza	Versioni compatibili	Tipo di dipendenza
Servizio di scambio di token	>=2.0.0	Rigidi

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

2.0.x-2.1.x

maxUploadIntervalSec

Il periodo massimo in cui il log forwarder di sistema tenterà di caricare i log. Poiché il log forwarder caricherà i log quando la memoria si riempie, potrebbe comunque caricarsi più spesso della cadenza massima configurata.

maxRetriesCount

Numero di volte in cui il log forwarder di sistema tenterà di riprovare un errore HTTP transitorio.

bufferCapacity

La dimensione del ring buffer per l'archiviazione dei log in memoria.

logGroup

Il percorso del registro in. CloudWatch

logStream

Il CloudWatch LogStream.

filters

Una mappa delle configurazioni dei filtri per il dispositivo principale.

services

Un elenco di filtri per i nomi di servizio che System Log Forwarder utilizzerà per determinare quali log verranno caricati. Un registro verrà caricato solo se il servizio da cui proviene corrisponde ad almeno uno dei filtri in questo elenco. I filtri in questo elenco possono essere una stringa a cui il nome del servizio deve corrispondere completamente o una stringa che termina con *, il che significa che il prefisso deve corrispondere.

Impostazione predefinita: [ggl.*]

Importante

Un registro verrà caricato solo se il servizio da cui proviene corrisponde ad almeno uno dei filtri in questo elenco.

Nota

L'utilizzo del valore * includerà tutti i servizi disponibili.

Esempio Configurazione di esempio:

L'esempio seguente filtrerà i log in base a tutti i servizi inclusi in Greengrass Nucleus Lite.

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

Changelog

La tabella seguente descrive le modifiche in ogni versione del componente.