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 dei log di sistema

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

Versioni

Questo componente ha le seguenti versioni:

Tipo

Questo componente è un componente generico (aws.greengrass.generic). Il nucleo di 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 systemd.

Requisiti

Questo componente ha i seguenti requisiti:

Il componente richiede l'accesso per creare gruppi di log e stream e l'autorizzazione per eseguire la chiamata PutLogEvents HTTP. CloudWatch È necessario aggiungere almeno le seguenti autorizzazioni politiche 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 ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Dipendenze

Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti del 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 semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna 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 durante il quale il log forwarder di sistema tenterà di caricare i log. Poiché il log forwarder caricherà i log quando la memoria si riempie, potrebbe comunque caricarli più spesso della cadenza massima configurata.

maxRetriesCount

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

bufferCapacity

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

logGroup

Il percorso di accesso. CloudWatch

logStream

Il CloudWatch LogStream.

filters

Una mappa delle configurazioni dei filtri per il dispositivo principale.

services

Un elenco di filtri relativi ai 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 di 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 di 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 ciascuna versione del componente.