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à.
Gestore dei log
Si consiglia di eseguire l'aggiornamento a Log manager v2.3.5 o successivo. La versione 2.3.5 ottimizza le scritture di configurazione di Log Manager, riducendo le operazioni di I/O e migliorando la velocità di caricamento dei log, le prestazioni complessive del dispositivo e possibilmente prolungandone la durata.
Il componente Log manager (aws.greengrass.LogManager) carica i log dai dispositivi AWS IoT Greengrass principali su Amazon Logs. CloudWatch Puoi caricare i log dal nucleo di Greengrass, da altri componenti Greengrass e da altre applicazioni e servizi che non sono componenti Greengrass. Per ulteriori informazioni su come monitorare i CloudWatch log in Logs e nel file system locale, vedere. Monitora AWS IoT Greengrass i registri
Le seguenti considerazioni si applicano quando si utilizza il componente di gestione dei log per scrivere su CloudWatch Logs:
-
Ritardi nei log
La versione 2.2.8 (e precedenti) del componente Log manager elabora e carica i log solo da file di registro ruotati. Per impostazione predefinita, il software AWS IoT Greengrass Core ruota i file di registro ogni ora o dopo che sono pari a 1.024 KB. Di conseguenza, il componente Log manager carica i log solo dopo che il software AWS IoT Greengrass Core o un componente Greengrass hanno scritto più di 1.024 KB di log. È possibile configurare un limite inferiore per le dimensioni dei file di registro per far sì che i file di registro ruotino più spesso. Ciò fa sì che il componente Log manager carichi i CloudWatch log in Logs con maggiore frequenza.
La versione 2.3.0 (e successive) del componente Log manager elabora e carica tutti i log. Quando si scrive un nuovo registro, la versione 2.3.0 (e successive) di Log manager elabora e carica direttamente il file di registro attivo anziché attendere che venga ruotato. Ciò significa che è possibile visualizzare il nuovo registro in 5 minuti o meno.
Il componente Log manager carica periodicamente nuovi log. Per impostazione predefinita, il componente Log manager carica nuovi log ogni 5 minuti. È possibile configurare un intervallo di caricamento inferiore, in modo che il componente Log manager carichi i log in CloudWatch Logs più frequentemente configurando il. periodicUploadIntervalSec Per ulteriori informazioni su come configurare questo intervallo periodico, vedere Configurazione. https://docs.aws.amazon.com/greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration
I log possono essere caricati quasi in tempo reale dallo stesso file system Greengrass. Se avete bisogno di osservare i log in tempo reale, prendete in considerazione l'utilizzo dei log Accedere ai log del file system del file system.
Se utilizzi file system diversi su cui scrivere i log, Log manager torna al comportamento delle versioni 2.2.8 e precedenti del componente Log manager. Per informazioni sull'accesso ai log del file system, vedi Accedere ai log del file system.
-
Orologio inclinato
Il componente Log manager utilizza il processo di firma standard Signature Version 4 per creare richieste API per CloudWatch i log. Se l'ora di sistema su un dispositivo principale non è sincronizzata per più di 15 minuti, CloudWatch Logs rifiuta le richieste. Per ulteriori informazioni, consulta la pagina relativa al processo di firma Signature Version 4 nella Riferimenti generali di AWS.
Per informazioni sui gruppi di log e sui flussi di log in cui questo componente carica i log, consulta. Utilizzo
Versioni
Questo componente ha le seguenti versioni:
Tipo
Questo componente è un componente plug-in (aws.greengrass.plugin). Il nucleo di Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.
Questo componente utilizza lo stesso file di registro del nucleo di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.
Per ulteriori informazioni, consulta Tipi di componenti.
Sistema operativo
Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:
Requisiti
Questo componente ha i seguenti requisiti:
-
Il ruolo del dispositivo Greengrass deve consentire le logs:DescribeLogStreams azioni logs:CreateLogGrouplogs:CreateLogStream,logs:PutLogEvents, e, come mostrato nel seguente esempio di policy IAM.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams"
],
"Effect": "Allow",
"Resource": "arn:aws:logs:*:*:*"
}
]
}
Il ruolo del dispositivo Greengrass creato durante l'installazione del software AWS IoT Greengrass Core include le autorizzazioni di questa politica di esempio per impostazione predefinita.
Per ulteriori informazioni, consulta Using Identity-Based Policy (politiche IAM) for CloudWatch Logs nella Amazon Logs User Guide. CloudWatch
-
Il componente Log manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.
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.
| Endpoint |
Porta |
Richiesto |
Description |
|
logs.region.amazonaws.com
|
443 |
No |
Obbligatorio se si scrivono i log in Logs. CloudWatch
|
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 distribuirlo correttamente. 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.3.13 and 2.3.14
-
La tabella seguente elenca le dipendenze per le versioni 2.3.13 e 2.3.14 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.19.0 |
Flessibili |
- 2.3.12
-
La tabella seguente elenca le dipendenze per la versione 2.3.12 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.18.0 |
Flessibili |
- 2.3.11
-
La tabella seguente elenca le dipendenze per la versione 2.3.11 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.17.0 |
Flessibili |
- 2.3.10
-
La tabella seguente elenca le dipendenze per la versione 2.3.10 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.16.0 |
Flessibili |
- 2.3.9
-
La tabella seguente elenca le dipendenze per la versione 2.3.9 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.15.0 |
Flessibili |
- 2.3.8
-
La tabella seguente elenca le dipendenze per la versione 2.3.8 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.14.0 |
Flessibili |
- 2.3.7
-
La tabella seguente elenca le dipendenze per la versione 2.3.7 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.13.0 |
Flessibili |
- 2.3.5 and 2.3.6
-
La tabella seguente elenca le dipendenze per le versioni 2.3.5 e 2.3.6 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.12.0 |
Flessibili |
- 2.3.3 – 2.3.4
-
La tabella seguente elenca le dipendenze per le versioni da 2.3.3 a 2.3.4 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.11.0 |
Flessibili |
- 2.2.8 – 2.3.2
-
La tabella seguente elenca le dipendenze per le versioni da 2.2.8 a 2.3.2 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.10.0 |
Flessibili |
- 2.2.7
-
La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.9.0 |
Flessibili |
- 2.2.6
-
La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.8.0 |
Flessibili |
- 2.2.5
-
La tabella seguente elenca le dipendenze per la versione 2.2.5 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.7.0 |
Flessibili |
- 2.2.1 - 2.2.4
-
La tabella seguente elenca le dipendenze per le versioni 2.2.1 - 2.2.4 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.6.0 |
Flessibili |
- 2.1.3 and 2.2.0
-
La tabella seguente elenca le dipendenze per le versioni 2.1.3 e 2.2.0 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.5.0 |
Flessibili |
- 2.1.2
-
La tabella seguente elenca le dipendenze per la versione 2.1.2 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.4.0 |
Flessibili |
- 2.1.1
-
La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.3.0 |
Flessibili |
- 2.1.0
-
La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.1.0 <2.2.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 |
| Nucleo Greengrass |
> =2.0.3 <2.1.0 |
Flessibili |
Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti. ComponentDependencies
Configurazione
Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.
- v2.3.10
-
logsUploaderConfiguration-
(Facoltativo) La configurazione per i log caricati dal componente Log manager. Questo oggetto contiene le seguenti informazioni:
-
systemLogsConfiguration
-
(Facoltativo) La configurazione per i log di sistema del software AWS IoT Greengrass principale, che includono i log del nucleo di Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:
uploadToCloudWatch-
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.
Impostazione predefinita: false
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima dei file di registro di sistema di Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.
Questo parametro è equivalente al parametro limite di dimensione del log (totalLogsSizeKB) del componente Greengrass nucleus. Nucleo di Greengrass Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.
diskSpaceLimitUnit-
(Facoltativo) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
-
componentLogsConfigurationMap
-
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti in CloudWatch Logs.
Consigliamo vivamente di utilizzare una singola chiave di configurazione per componente. Dovresti scegliere come target solo un gruppo di file che ha un solo file di registro su cui viene scritto attivamente quando usi illogFileRegex. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati su CloudWatch. Se hai come target più file di log attivi con una singola regex, ti consigliamo di eseguire l'aggiornamento a Log manager v2.3.1 o versioni successive e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consultate i parametri di configurazione per la v2.1.x di questo componente.
componentName-
La configurazione del registro per il componentName
Ogni oggetto contiene le seguenti informazioni:
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass
registrazione su. GitHub
Scegli tra i seguenti livelli di log, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera la dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.
Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro per questo componente.
diskSpaceLimitUnit-
(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
logFileDirectoryPath-
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).
Default: /greengrass/v2
logFileRegex-
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log utilizza questa espressione regolare per identificare i file di registro nella cartella atlogFileDirectoryPath.
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare hello_world\\\\w*.log i log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:
Predefinito:componentName\\\\w*.logcomponentName dov'è il nome del componente per questa configurazione di registro.
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i CloudWatch log in Logs.
Impostazione predefinita: false
multiLineStartPattern-
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente di gestione dei log aggiunge la nuova riga al messaggio di registro per la riga precedente.
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.
-
periodicUploadIntervalSec
-
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.
Predefinito: 300 (5 minuti)
Minimo: 0.000001 (1 microsecondo)
updateToTlogIntervalSec-
(Facoltativo) Il periodo in secondi con cui il nucleo scrive i dettagli degli eventi di Amazon CloudWatch Events caricamento del log nel log delle transazioni locale (). config.tlog Il valore predefinito è il valore specificato in. periodicUploadIntervalSec È possibile modificare questo parametro per aumentare l'intervallo di scrittura.
Impostazione predefinita: periodicUploadIntervalSec
Minimo: periodicUploadIntervalSec
deprecatedVersionSupport-
Indica se il Log manager deve utilizzare i miglioramenti della velocità di registrazione introdotti in Log manager v2.3.5. Imposta il valore su per utilizzare false i miglioramenti.
Se si imposta questo valore su false quando si esegue l'aggiornamento da Log Manager v2.3.1 o versioni precedenti, è possibile che vengano caricate voci di registro duplicate.
Il valore predefinito è true.
Esempio Esempio: aggiornamento dell'unione delle configurazioni
La seguente configurazione di esempio specifica di caricare i log di sistema e i log dei com.example.HelloWorld componenti in Logs. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
Esempio Esempio: configurazione per caricare più file di registro attivi utilizzando Log manager v2.3.1
La seguente configurazione di esempio è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questa configurazione di esempio specifica in quali file di registro attivi si desidera caricare CloudWatch. L'utilizzo di questo esempio di configurazione caricherà anche tutti i file ruotati che corrispondono a. logFileRegex Questa configurazione di esempio è supportata su Log manager v2.3.1.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.3.6 – v2.3.9
-
logsUploaderConfiguration-
(Facoltativo) La configurazione per i log caricati dal componente Log manager. Questo oggetto contiene le seguenti informazioni:
-
systemLogsConfiguration
-
(Facoltativo) La configurazione per i log di sistema del software AWS IoT Greengrass principale, che includono i log del nucleo di Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:
uploadToCloudWatch-
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.
Impostazione predefinita: false
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima dei file di registro di sistema di Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.
Questo parametro è equivalente al parametro limite di dimensione del log (totalLogsSizeKB) del componente Greengrass nucleus. Nucleo di Greengrass Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.
diskSpaceLimitUnit-
(Facoltativo) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
-
componentLogsConfigurationMap
-
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti in CloudWatch Logs.
Consigliamo vivamente di utilizzare una singola chiave di configurazione per componente. Dovresti scegliere come target solo un gruppo di file che ha un solo file di registro su cui viene scritto attivamente quando usi illogFileRegex. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati su CloudWatch. Se hai come target più file di log attivi con una singola regex, ti consigliamo di eseguire l'aggiornamento a Log manager v2.3.1 o versioni successive e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consultate i parametri di configurazione per la v2.1.x di questo componente.
componentName-
La configurazione del registro per il componentName
Ogni oggetto contiene le seguenti informazioni:
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass
registrazione su. GitHub
Scegli tra i seguenti livelli di log, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera la dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.
Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del log per questo componente.
diskSpaceLimitUnit-
(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
logFileDirectoryPath-
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).
Default: /greengrass/v2
logFileRegex-
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log utilizza questa espressione regolare per identificare i file di registro nella cartella atlogFileDirectoryPath.
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare hello_world\\\\w*.log i log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:
Predefinito:componentName\\\\w*.logcomponentName dov'è il nome del componente per questa configurazione di registro.
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i CloudWatch log in Logs.
Impostazione predefinita: false
multiLineStartPattern-
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente di gestione dei log aggiunge la nuova riga al messaggio di registro per la riga precedente.
Per impostazione predefinita, il componente del gestore dei log controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.
-
periodicUploadIntervalSec
-
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.
Predefinito: 300 (5 minuti)
Minimo: 0.000001 (1 microsecondo)
deprecatedVersionSupport-
Indica se il Log manager deve utilizzare i miglioramenti della velocità di registrazione introdotti in Log manager v2.3.5. Imposta il valore su per utilizzare false i miglioramenti.
Se si imposta questo valore su false quando si esegue l'aggiornamento da Log Manager v2.3.1 o versioni precedenti, è possibile che vengano caricate voci di registro duplicate.
Il valore predefinito è true.
Esempio Esempio: aggiornamento dell'unione delle configurazioni
La seguente configurazione di esempio specifica di caricare i log di sistema e i log dei com.example.HelloWorld componenti in Logs. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
Esempio Esempio: configurazione per caricare più file di registro attivi utilizzando Log manager v2.3.1
La seguente configurazione di esempio è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questa configurazione di esempio specifica in quali file di registro attivi si desidera caricare CloudWatch. L'utilizzo di questo esempio di configurazione caricherà anche tutti i file ruotati che corrispondono a. logFileRegex Questa configurazione di esempio è supportata su Log manager v2.3.1.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.3.0 – 2.3.5
-
logsUploaderConfiguration-
(Facoltativo) La configurazione per i log caricati dal componente Log manager. Questo oggetto contiene le seguenti informazioni:
-
systemLogsConfiguration
-
(Facoltativo) La configurazione per i log di sistema del software AWS IoT Greengrass principale, che includono i log del nucleo di Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:
uploadToCloudWatch-
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.
Impostazione predefinita: false
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima dei file di registro di sistema di Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.
Questo parametro è equivalente al parametro limite di dimensione del log (totalLogsSizeKB) del componente Greengrass nucleus. Nucleo di Greengrass Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.
diskSpaceLimitUnit-
(Facoltativo) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
-
componentLogsConfigurationMap
-
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti in CloudWatch Logs.
Consigliamo vivamente di utilizzare una singola chiave di configurazione per componente. Dovresti scegliere come target solo un gruppo di file che ha un solo file di registro su cui viene scritto attivamente quando usi illogFileRegex. La mancata osservanza di questa raccomandazione può comportare il caricamento di log duplicati su CloudWatch. Se hai come target più file di log attivi con una singola regex, ti consigliamo di eseguire l'aggiornamento a Log manager v2.3.1 e di prendere in considerazione la possibilità di modificare la configurazione utilizzando la configurazione di esempio.
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consultate i parametri di configurazione per la v2.1.x di questo componente.
componentName-
La configurazione del registro per il componentName
Ogni oggetto contiene le seguenti informazioni:
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass
registrazione su. GitHub
Scegli tra i seguenti livelli di log, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera la dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.
Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del log per questo componente.
diskSpaceLimitUnit-
(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
logFileDirectoryPath-
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).
Default: /greengrass/v2
logFileRegex-
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log utilizza questa espressione regolare per identificare i file di registro nella cartella atlogFileDirectoryPath.
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare hello_world\\\\w*.log i log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:
Predefinito:componentName\\\\w*.logcomponentName dov'è il nome del componente per questa configurazione di registro.
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i CloudWatch log in Logs.
Impostazione predefinita: false
multiLineStartPattern-
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente di gestione dei log aggiunge la nuova riga al messaggio di registro per la riga precedente.
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.
-
periodicUploadIntervalSec
-
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.
Predefinito: 300 (5 minuti)
Minimo: 0.000001 (1 microsecondo)
Esempio Esempio: aggiornamento dell'unione delle configurazioni
La seguente configurazione di esempio specifica di caricare i log di sistema e i log dei com.example.HelloWorld componenti in Logs. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
Esempio Esempio: configurazione per caricare più file di registro attivi utilizzando Log manager v2.3.1
La seguente configurazione di esempio è l'esempio consigliato se si desidera indirizzare più file di registro attivi. Questa configurazione di esempio specifica in quali file di registro attivi si desidera caricare CloudWatch. L'utilizzo di questo esempio di configurazione caricherà anche tutti i file ruotati che corrispondono a. logFileRegex Questa configurazione di esempio è supportata su Log manager v2.3.1.
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
- v2.2.x
-
logsUploaderConfiguration-
(Facoltativo) La configurazione per i log caricati dal componente Log manager. Questo oggetto contiene le seguenti informazioni:
-
systemLogsConfiguration
-
(Facoltativo) La configurazione per i log di sistema del software AWS IoT Greengrass principale, che includono i log del nucleo di Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:
uploadToCloudWatch-
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.
Impostazione predefinita: false
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima dei file di registro di sistema di Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.
Questo parametro è equivalente al parametro limite di dimensione del log (totalLogsSizeKB) del componente Greengrass nucleus. Nucleo di Greengrass Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.
diskSpaceLimitUnit-
(Facoltativo) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
-
componentLogsConfigurationMap
-
(Facoltativo) Una mappa delle configurazioni dei log per i componenti del dispositivo principale. Ogni componentName oggetto in questa mappa definisce la configurazione del registro per il componente o l'applicazione. Il componente Log manager carica questi log dei componenti in CloudWatch Logs.
Se stai effettuando l'aggiornamento da una versione di Log manager precedente alla v2.2.0, puoi continuare a utilizzare l'elenco anziché. componentLogsConfiguration componentLogsConfigurationMap Tuttavia, consigliamo vivamente di utilizzare il formato mappa in modo da poter utilizzare gli aggiornamenti di unione e ripristino per modificare le configurazioni di componenti specifici. Per informazioni sul componentLogsConfiguration parametro, consultate i parametri di configurazione per la v2.1.x di questo componente.
componentName-
La configurazione del registro per il componentName
Ogni oggetto contiene le seguenti informazioni:
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass
registrazione su. GitHub
Scegli tra i seguenti livelli di log, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera la dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.
Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del log per questo componente.
diskSpaceLimitUnit-
(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
logFileDirectoryPath-
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).
Default: /greengrass/v2
logFileRegex-
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log utilizza questa espressione regolare per identificare i file di registro nella cartella atlogFileDirectoryPath.
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare hello_world\\\\w*.log i log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:
Predefinito:componentName\\\\w*.logcomponentName dov'è il nome del componente per questa configurazione di registro.
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i CloudWatch log in Logs.
Impostazione predefinita: false
multiLineStartPattern-
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente di gestione dei log aggiunge la nuova riga al messaggio di registro per la riga precedente.
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.
-
periodicUploadIntervalSec
-
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.
Predefinito: 300 (5 minuti)
Minimo: 0.000001 (1 microsecondo)
Esempio Esempio: aggiornamento dell'unione delle configurazioni
La seguente configurazione di esempio specifica di caricare i log di sistema e i log dei com.example.HelloWorld componenti in Logs. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
- v2.1.x
-
logsUploaderConfiguration-
(Facoltativo) La configurazione per i log caricati dal componente Log manager. Questo oggetto contiene le seguenti informazioni:
-
systemLogsConfiguration
-
(Facoltativo) La configurazione per i log di sistema del software AWS IoT Greengrass principale, che includono i log del nucleo di Greengrass e i componenti del plug-in. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:
uploadToCloudWatch-
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.
Impostazione predefinita: false
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima dei file di registro di sistema di Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.
Questo parametro è equivalente al parametro limite di dimensione del log (totalLogsSizeKB) del componente Greengrass nucleus. Nucleo di Greengrass Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.
diskSpaceLimitUnit-
(Facoltativo) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
-
componentLogsConfiguration
-
(Facoltativo) Un elenco di configurazioni di registro per i componenti del dispositivo principale. Ogni configurazione in questo elenco definisce la configurazione del registro per un componente o un'applicazione. Il componente Log manager carica questi log dei componenti in Logs CloudWatch
Ogni oggetto contiene le seguenti informazioni:
componentName-
Il nome del componente o dell'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass
registrazione su. GitHub
Scegli tra i seguenti livelli di log, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera la dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.
Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del log per questo componente.
diskSpaceLimitUnit-
(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
logFileDirectoryPath-
(Facoltativo) Il percorso della cartella che contiene i file di registro di questo componente.
Non è necessario specificare questo parametro per i componenti Greengrass che vengono stampati su standard output (stdout) e standard error (stderr).
Default: /greengrass/v2
logFileRegex-
(Facoltativo) Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente di gestione dei log utilizza questa espressione regolare per identificare i file di registro nella cartella atlogFileDirectoryPath.
Non è necessario specificare questo parametro per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).
Se il componente o l'applicazione ruota i file di registro, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare hello_world\\\\w*.log i log per un'applicazione Hello World. Il \\\\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il gestore dei log carica i seguenti file di registro:
Predefinito:componentName\\\\w*.logcomponentName dov'è il nome del componente per questa configurazione di registro.
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i CloudWatch log in Logs.
Impostazione predefinita: false
multiLineStartPattern-
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente di gestione dei log aggiunge la nuova riga al messaggio di registro per la riga precedente.
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.
-
periodicUploadIntervalSec
-
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.
Predefinito: 300 (5 minuti)
Minimo: 0.000001 (1 microsecondo)
Esempio Esempio: aggiornamento dell'unione delle configurazioni
La seguente configurazione di esempio specifica di caricare i log di sistema e i log dei com.example.HelloWorld componenti in Logs. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
- v2.0.x
-
logsUploaderConfiguration-
(Facoltativo) La configurazione per i log caricati dal componente Log manager. Questo oggetto contiene le seguenti informazioni:
systemLogsConfiguration-
(Facoltativo) La configurazione per i registri di sistema del software AWS IoT Greengrass principale. Specificate questa configurazione per consentire al componente Log manager di gestire i log di sistema. Questo oggetto contiene le seguenti informazioni:
uploadToCloudWatch-
(Facoltativo) È possibile caricare i log di sistema in CloudWatch Logs.
Impostazione predefinita: false
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se si configura il componente Greengrass nucleus per l'output di log in formato JSON. Per abilitare i log in formato JSON, specificate il parametro del formato JSON di registrazione (). logging.format
Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima dei file di registro di sistema di Greengrass, nell'unità specificata. diskSpaceLimitUnit Dopo che la dimensione totale dei file di registro di sistema Greengrass supera questa dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro di sistema Greengrass più vecchi.
Questo parametro è equivalente al parametro limite di dimensione del log (totalLogsSizeKB) del componente Greengrass nucleus. Nucleo di Greengrass Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del registro di sistema Greengrass.
diskSpaceLimitUnit-
(Facoltativo) L'unità per. diskSpaceLimit Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
componentLogsConfiguration-
(Facoltativo) Un elenco di configurazioni di registro per i componenti del dispositivo principale. Ogni configurazione in questo elenco definisce la configurazione del registro per un componente o un'applicazione. Il componente Log manager carica questi log dei componenti in Logs CloudWatch
Ogni oggetto contiene le seguenti informazioni:
componentName-
Il nome del componente o dell'applicazione per questa configurazione di registro. È possibile specificare il nome di un componente Greengrass o un altro valore per identificare questo gruppo di log.
minimumLogLevel-
(Facoltativo) Il livello minimo di messaggi di registro da caricare. Questo livello minimo si applica solo se i log di questo componente utilizzano un formato JSON specifico, disponibile nel repository del modulo di AWS IoT Greengrass
registrazione su. GitHub
Scegli tra i seguenti livelli di log, elencati qui in ordine di livello:
Impostazione predefinita: INFO
diskSpaceLimit-
(Facoltativo) La dimensione totale massima di tutti i file di registro per questo componente, nell'unità specificatadiskSpaceLimitUnit. Dopo che la dimensione totale dei file di registro di questo componente supera la dimensione totale massima, il software AWS IoT Greengrass Core elimina i file di registro più vecchi di questo componente.
Questo parametro è correlato al parametro limite di dimensione del registro (totalLogsSizeKB) del componente Greengrass nucleus. Il software AWS IoT Greengrass Core utilizza il minimo dei due valori come dimensione massima totale del log per questo componente.
diskSpaceLimitUnit-
(Facoltativo) L'unità perdiskSpaceLimit. Seleziona una delle opzioni seguenti:
-
KB— kilobyte
-
MB— megabyte
-
GB— gigabyte
Impostazione predefinita: KB
logFileDirectoryPath-
Il percorso della cartella che contiene i file di registro di questo componente.
Per caricare i log di un componente Greengrass/greengrass/v2/greengrass/v2
logFileRegex-
Un'espressione regolare che specifica il formato del nome del file di registro utilizzato dal componente o dall'applicazione. Il componente Log manager utilizza questa espressione regolare per identificare i file di registro nella cartella atlogFileDirectoryPath.
Per caricare i log di un componente Greengrass, specificate un'espressione regolare che corrisponda ai nomi dei file di registro ruotati. Ad esempio, potresti specificare di caricare com.example.HelloWorld\\w*.log i log per un componente Hello World. Il \\w* modello corrisponde a zero o più caratteri di parola, inclusi caratteri alfanumerici e trattini bassi. Questa espressione regolare corrisponde ai file di registro con e senza timestamp nel nome. In questo esempio, il Log manager carica i seguenti file di registro:
-
com.example.HelloWorld.log— Il file di registro più recente per il componente Hello World.
-
com.example.HelloWorld_2020_12_15_17_0.log— Un vecchio file di registro per il componente Hello World. Il nucleo di Greengrass aggiunge un timestamp rotante ai file di registro.
deleteLogFileAfterCloudUpload-
(Facoltativo) È possibile eliminare un file di registro dopo che il componente di gestione dei log ha caricato i log in Logs. CloudWatch
Impostazione predefinita: false
multiLineStartPattern-
(Facoltativo) Un'espressione regolare che identifica quando un messaggio di registro su una nuova riga è un nuovo messaggio di registro. Se l'espressione regolare non corrisponde alla nuova riga, il componente di gestione dei log aggiunge la nuova riga al messaggio di registro per la riga precedente.
Per impostazione predefinita, il componente log manager controlla se la riga inizia con uno spazio bianco, ad esempio una tabulazione o uno spazio. In caso contrario, il gestore dei log gestisce quella riga come un nuovo messaggio di registro. Altrimenti, aggiunge quella riga al messaggio di registro corrente. Questo comportamento garantisce che il componente del gestore dei log non divida i messaggi che si estendono su più righe, come le tracce dello stack.
periodicUploadIntervalSec-
(Facoltativo) Il periodo in secondi durante il quale il componente di gestione dei log verifica la presenza di nuovi file di registro da caricare.
Predefinito: 300 (5 minuti)
Minimo: 0.000001 (1 microsecondo)
Esempio Esempio: aggiornamento dell'unione delle configurazioni
La seguente configurazione di esempio specifica di caricare i log di sistema e i log dei com.example.HelloWorld componenti in Logs. CloudWatch
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"logFileDirectoryPath": "/greengrass/v2/logs",
"logFileRegex": "com.example.HelloWorld\\w*.log",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
Utilizzo
Il componente Log manager viene caricato nei seguenti gruppi di log e stream di log.
- 2.1.0 and later
-
- Nome del gruppo di log
-
/aws/greengrass/componentType/region/componentName
Il nome del gruppo di log utilizza le seguenti variabili:
-
componentType— Il tipo di componente, che può essere uno dei seguenti:
-
GreengrassSystemComponent— Questo gruppo di log include i log per i componenti del nucleo e del plugin, che vengono eseguiti nella stessa JVM del nucleo di Greengrass. Il componente fa parte del nucleo di Greengrass. Nucleo di Greengrass
-
UserComponent— Questo gruppo di log include i log per i componenti generici, i componenti Lambda e altre applicazioni sul dispositivo. Il componente non fa parte del nucleo di Greengrass.
Per ulteriori informazioni, consulta Tipi di componenti.
-
region— La AWS regione utilizzata dal dispositivo principale.
-
componentName— Il nome del componente. Per i log di sistema, questo valore èSystem.
- Nome del flusso di log
-
/date/thing/thingName
Il nome del flusso di log utilizza le seguenti variabili:
-
date— La data del registro, ad esempio2020/12/15. Il componente di gestione dei log utilizza il yyyy/MM/dd formato.
-
thingName— Il nome del dispositivo principale.
Se il nome di un oggetto contiene i due punti (:), il log manager sostituisce i due punti con un segno più (+).
- 2.0.x
-
- Nome del gruppo di log
-
/aws/greengrass/componentType/region/componentName
Il nome del gruppo di log utilizza le seguenti variabili:
-
componentType— Il tipo di componente, che può essere uno dei seguenti:
-
GreengrassSystemComponent— Il componente fa parte del nucleo di Greengrass.
-
UserComponent— Il componente non fa parte del nucleo di Greengrass. Il Log manager utilizza questo tipo per i componenti Greengrass e altre applicazioni sul dispositivo.
-
region— La AWS regione utilizzata dal dispositivo principale.
-
componentName— Il nome del componente. Per i log di sistema, questo valore èSystem.
- Nome del flusso di log
-
/date/deploymentTargets/thingName
Il nome del flusso di log utilizza le seguenti variabili:
-
date— La data del registro, ad esempio2020/12/15. Il componente Log manager utilizza il yyyy/MM/dd formato.
-
deploymentTargets— Le cose le cui implementazioni includono il componente. Il componente Log manager separa ogni destinazione con una barra. Se il componente viene eseguito sul dispositivo principale come risultato di una distribuzione locale, questo valore è. LOCAL_DEPLOYMENT
Considera un esempio in cui hai un dispositivo principale denominato MyGreengrassCore e il dispositivo principale ha due distribuzioni:
-
Una distribuzione destinata al dispositivo principale,. MyGreengrassCore
-
Una distribuzione destinata a un gruppo di oggetti denominatoMyGreengrassCoreGroup, che contiene il dispositivo principale.
deploymentTargetsPer questo dispositivo principale sonothing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup.
-
thingName— Il nome del dispositivo principale.
Formati per le voci di registro.
Il nucleo di Greengrass scrive i file di registro in formato stringa o JSON. Per i log di sistema, è possibile controllare il formato impostando il format campo della voce. logging La logging voce si trova nel file di configurazione del componente Greengrass nucleus. Per ulteriori informazioni, vedere la configurazione del nucleo di Greengrass.
Il formato di testo è in formato libero e accetta qualsiasi stringa. Il seguente messaggio di servizio sullo stato del parco veicoli è un esempio di registrazione in formato stringa:
2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published.
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService,
currentState=RUNNING}
È necessario utilizzare il formato JSON se si desidera visualizzare i log con il comando Greengrass CLI logs o interagire con i log a livello di programmazione. L'esempio seguente delinea la forma JSON:
{
"loggerName": <string>,
"level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
"eventType": <string, optional>,
"cause": <string, optional>,
"contexts": {},
"thread": <string>,
"message": <string>,
"timestamp": <epoch time> # Needs to be epoch time
}
Per controllare l'output dei log del componente, puoi utilizzare l'opzione di minimumLogLevel configurazione. Per utilizzare questa opzione, il componente deve scrivere le voci di registro in formato JSON. È necessario utilizzare lo stesso formato del file di registro di sistema.
File di registro locale
Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
Changelog
La tabella seguente descrive le modifiche in ciascuna versione del componente.
|
Versione
|
Modifiche
|
|
2.3.14
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.13
|
Aggiorna la versione del componente per la versione 2.18.0 di Greengrass nucleus.
|
|
2.3.12
|
Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus.
|
|
2.3.11
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.10
|
- Nuove funzionalità
-
- Correzioni di bug e miglioramenti
-
|
|
2.3.9
|
Versione aggiornata per la versione 2.14.0 di Greengrass nucleus.
|
|
2.3.8
|
Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.
|
|
2.3.7
|
Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.
|
|
2.3.6
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.5
|
- Miglioramenti
-
Migliora la velocità di caricamento dei log.
Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. |
|
2.3.4
|
- Correzioni di bug e miglioramenti
-
-
Aggiunge il supporto per l'impostazione del periodicUploadIntervalSec parametro su valori frazionari. Il valore minimo è 1 microsecondo.
-
Risolve un problema per cui il gestore dei log non rispetta i CloudWatch putLogEvents limiti.
|
|
2.3.3
|
Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.
|
|
2.3.2
|
- Correzioni di bug e miglioramenti
-
-
Migliora la gestione dello spazio in modo che i file di registro non vengano eliminati prima del caricamento.
-
Risolve i problemi relativi alla gestione della cache.
-
Miglioramenti e correzioni di bug minori aggiuntivi.
|
|
2.3.1
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.0
|
Si consiglia di eseguire l'aggiornamento a Greengrass nucleus 2.9.1 quando si esegue l'aggiornamento a Log manager 2.3.0.
- Nuove funzionalità
-
Riduce i ritardi nei log elaborando e caricando direttamente i file di log attivi invece di attendere la rotazione dei nuovi file.
- Correzioni di bug e miglioramenti
-
|
|
2.2.8
|
Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. |
|
2.2.7
|
Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. |
|
2.2.6
|
Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.
|
|
2.2.5
|
Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.
|
|
2.2.4
|
- Correzioni di bug e miglioramenti
-
|
|
2.2.3
|
- Correzioni di bug e miglioramenti
-
-
Migliora la stabilità in determinati scenari in cui il componente si riavvia o incontra errori.
-
Risolve i problemi a causa del mancato caricamento di messaggi e file di registro di grandi dimensioni in determinati scenari.
-
Risolve i problemi relativi al modo in cui questo componente gestisce gli aggiornamenti di ripristino della configurazione.
-
Risolve un problema a causa del quale un valore null diskSpaceLimit di configurazione impediva la distribuzione del componente.
|
|
2.2.2
|
- Correzioni di bug e miglioramenti
-
|
|
2.2.1
|
Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.
|
|
2.2.0
|
|
|
2.1.3
|
Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.
|
|
2.1.2
|
Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.
|
|
2.1.1
|
- Correzioni di bug e miglioramenti
-
|
|
2.1.0
|
- Correzioni di bug e miglioramenti
-
-
Usa i valori predefiniti per logFileDirectoryPath e logFileRegex che funzionano per i componenti Greengrass che stampano su standard output (stdout) e standard error (stderr).
-
Instrada correttamente il traffico attraverso un proxy di rete configurato durante il caricamento dei log su Logs. CloudWatch
-
Gestisci correttamente i due punti (:) nei nomi dei flussi di log. CloudWatch I nomi dei log stream non supportano i due punti.
-
Semplifica i nomi dei flussi di log rimuovendo i nomi dei gruppi di oggetti dal flusso di log.
-
Rimuovi un messaggio di registro degli errori che viene stampato durante il normale comportamento.
|
|
2.0.x
|
Versione iniziale.
|
