log - AWS IoT Greengrass
getelenca-parole chiavelist-log-files

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à.

log

Usa il logs comando per analizzare i log di Greengrass sul tuo dispositivo principale.

Sottocomandi

get

Raccogli, filtra e visualizza i file di registro Greengrass. Questo comando supporta solo file di registro in formato JSON. È possibile specificare il formato di registrazione nella configurazione del nucleo.

Riepilogo
greengrass-cli logs get
    [--log-dir path/to/a/log/folder]
    [--log-file path/to/a/log/file]
    [--follow true | false ]
    [--filter <filter> ]
    [--time-window <start-time>,<end-time> ]
    [--verbose ]
    [--no-color ]
    [--before <value> ]
    [--after <value> ]
    [--syslog ]
    [--max-long-queue-size <value> ]
Arguments (Argomenti)

  • --log-dir,. -ld Il percorso della directory in cui verificare la presenza di file di registro, ad esempio/greengrass/v2/logs. Non utilizzare con--syslog. Utilizzate un argomento separato per ogni directory aggiuntiva da specificare. È necessario utilizzare almeno uno degli --log-dir o--log-file. È inoltre possibile utilizzare entrambi gli argomenti in un unico comando.

  • --log-file,-lf. I percorsi delle directory di registro che desideri utilizzare. Utilizzate un argomento separato per ogni directory aggiuntiva da specificare. È necessario utilizzare almeno uno degli --log-dir o--log-file. È inoltre possibile utilizzare entrambi gli argomenti in un unico comando.

  • --follow,-fol. Mostra gli aggiornamenti del registro man mano che si verificano. La CLI di Greengrass continua a funzionare e legge i log specificati. Se si specifica una finestra temporale, la CLI di Greengrass interrompe il monitoraggio dei log al termine di tutte le finestre temporali.

  • --filter,. -f La parola chiave, le espressioni regolari o la coppia chiave-valore da usare come filtro. Fornite questo valore come stringa, espressione regolare o coppia chiave-valore. Utilizzate un argomento separato per ogni filtro aggiuntivo da specificare.

    Quando vengono valutati, più filtri specificati in un singolo argomento vengono separati da operatori OR e i filtri specificati negli argomenti aggiuntivi vengono combinati con gli operatori AND. Ad esempio, se il comando include--filter "installed" --filter "name=alpha,name=beta", Greengrass CLI filtrerà e visualizzerà i messaggi di registro che contengono sia la parola chiave che una name chiave con installed i valori o. alpha beta

  • --time-window,. -t La finestra temporale per la quale mostrare le informazioni del registro. È possibile utilizzare sia i timestamp esatti che gli offset relativi. È necessario fornire queste informazioni nel formato. <begin-time>,<end-time> Se non si specifica né l'ora di inizio né l'ora di fine, il valore predefinito di tale opzione è la data e l'ora correnti del sistema. Utilizzate un argomento separato per ogni finestra temporale aggiuntiva da specificare.

    La CLI di Greengrass supporta i seguenti formati per i timestamp:

    • yyyy-MM-DD, ad esempio,. 2020-06-30 L'ora predefinita è 00:00:00 quando si utilizza questo formato.

      yyyyMMDD, ad esempio,. 20200630 L'ora predefinita è 00:00:00 quando si utilizza questo formato.

      HH:mm:ss, ad esempio,. 15:30:45 La data predefinita è la data di sistema corrente quando si utilizza questo formato.

      HH:mm:ssSSS, ad esempio,. 15:30:45 La data predefinita è la data corrente del sistema quando si utilizza questo formato.

      YYYY-MM-DD'T'HH:mm:ss'Z', ad esempio,. 2020-06-30T15:30:45Z

      YYYY-MM-DD'T'HH:mm:ss, ad esempio,2020-06-30T15:30:45.

      yyyy-MM-dd'T'HH:mm:ss.SSS, ad esempio,2020-06-30T15:30:45.250.

    Gli offset relativi specificano uno scostamento del periodo di tempo dall'ora corrente del sistema. La CLI di Greengrass supporta il seguente formato per gli offset relativi:. +|-[<value>h|hr|hours][valuem|min|minutes][value]s|sec|seconds

    Ad esempio, il seguente argomento per specificare una finestra temporale compresa tra 1 ora e 2 ore 15 minuti prima dell'ora corrente è. --time-window -2h15min,-1hr

  • --verbose. Mostra tutti i campi dei messaggi di registro. Non utilizzare con--syslog.

  • --no-color,-nc. Rimuovi la codifica a colori. La codifica a colori predefinita per i messaggi di registro utilizza il testo in grassetto rosso. Supporta solo terminali simili a Unix perché utilizza sequenze di escape ANSI.

  • --before,-b. Il numero di righe da mostrare prima di una voce di registro corrispondente. Il valore predefinito è 0.

  • --after,. -a Il numero di righe da mostrare dopo una voce di registro corrispondente. Il valore predefinito è 0.

  • --syslog. Elabora tutti i file di registro utilizzando il protocollo syslog definito da. RFC3164 Non utilizzare con --log-dir and. --verbose Il protocollo syslog utilizza il seguente formato:. "<$Priority>$Timestamp $Host $Logger ($Class): $Message" Se non si specifica un file di registro, la CLI di Greengrass legge i messaggi di registro dalle seguenti posizioni:/var/log/messages, o il. /var/log/syslog /var/log/system.log

    AWS IoT Greengrass attualmente non supporta questa funzionalità sui dispositivi Windows core.

  • --max-log-queue-size,-m. Il numero massimo di voci di registro da allocare alla memoria. Utilizzate questa opzione per ottimizzare l'utilizzo della memoria. L'impostazione predefinita è 100.

Output

L'esempio seguente mostra l'output prodotto quando si esegue questo comando.

$ sudo greengrass-cli logs get --verbose \
    --log-file /greengrass/v2/logs/greengrass.log \
    --filter deployment,serviceName=DeploymentService \
    --filter level=INFO \
    --time-window 2020-12-08T01:11:17,2020-12-08T01:11:22

2020-12-08T01:11:17.615Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.DeploymentService: Current deployment finished. {DeploymentId=44d89f46-1a29-4044-ad89-5151213dfcbc, serviceName=DeploymentService, currentState=RUNNING}
2020-12-08T01:11:17.675Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.IotJobsHelper: Updating status of persisted deployment. {Status=SUCCEEDED, StatusDetails={detailed-deployment-status=SUCCESSFUL}, ThingName=MyThing, JobId=22d89f46-1a29-4044-ad89-5151213dfcbc

elenca-parole chiave

Mostra le parole chiave suggerite che è possibile utilizzare per filtrare i file di registro.

Riepilogo
greengrass-cli logs list-keywords [arguments]
Arguments (Argomenti)

Nessuno

Output

Gli esempi seguenti mostrano l'output prodotto quando si esegue questo comando.

$ sudo greengrass-cli logs list-keywords

Here is a list of suggested keywords for Greengrass log:
level=$str
thread=$str
loggerName=$str
eventType=$str
serviceName=$str
error=$str
$ sudo greengrass-cli logs list-keywords --syslog

Here is a list of suggested keywords for syslog:
priority=$int
host=$str
logger=$str
class=$str

list-log-files

Mostra i file di registro che si trovano in una directory specificata.

Riepilogo
greengrass-cli logs list-log-files [arguments]
Arguments (Argomenti)

--log-dir,-ld. Il percorso della directory in cui verificare la presenza di file di registro.

Output

L'esempio seguente mostra l'output prodotto quando si esegue questo comando.

$ sudo greengrass-cli logs list-log-files -ld /greengrass/v2/logs/

/greengrass/v2/logs/aws.greengrass.Nucleus.log
/greengrass/v2/logs/main.log
/greengrass/v2/logs/greengrass.log
Total 3 files found.