registros - AWS IoT Greengrass
introducciónlist-keywordslist-log-files

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

registros

Utilice el logs comando para analizar los registros de Greengrass en el dispositivo principal.

Subcomandos

introducción

Recopile, filtre y visualice los archivos de registro de Greengrass. Este comando solo admite archivos de registro con formato JSON. Puede especificar el formato de registro en la configuración del núcleo.

Sinopsis
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

  • --log-dir, -ld. La ruta al directorio para comprobar si hay archivos de registro, por ejemplo, /greengrass/v2/logs. No lo use con --syslog. Utilice un argumento diferente para cada directorio adicional que desee especificar. Debe especificar al menos una opción entre --log-dir o --log-file. También puede utilizar ambos argumentos en un único comando.

  • --log-file, -lf. Las rutas de los directorios de registro que desee utilizar. Utilice un argumento diferente para cada directorio adicional que desee especificar. Debe especificar al menos una opción entre --log-dir o --log-file. También puede utilizar ambos argumentos en un único comando.

  • --follow, -fol. Muestra las actualizaciones de registro a medida que se producen. La CLI de Greengrass continúa ejecutándose y lee los registros especificados. Si especifica un intervalo de tiempo, la CLI de Greengrass deja de inspeccionar los registros una vez finalizados todos los intervalos de tiempo.

  • --filter, -f. La palabra clave, las expresiones regulares o el par clave-valor que se va a utilizar como filtro. Proporcione este valor como cadena, expresión regular o par clave-valor. Utilice un argumento diferente para cada filtro adicional que desee especificar.

    Cuando se evalúan, los filtros múltiples especificados en un único argumento se separan mediante operadores OR y los filtros especificados en argumentos adicionales se combinan con los operadores AND. Por ejemplo, si su comando incluye --filter "installed" --filter "name=alpha,name=beta", la CLI de Greengrass filtrará y mostrará los mensajes de registro que contengan tanto la palabra clave installed como una clave name que incluya los valores alpha o beta.

  • --time-window, -t. El intervalo de tiempo durante el que se mostrará la información del registro. Puede utilizar tanto marcas temporales exactas como compensaciones relativas. Debe proporcionar la información con el formato <begin-time>,<end-time>. Si no especifica la hora de inicio ni la hora de finalización, el valor de esa opción se establece de forma predeterminada en la fecha y hora actuales del sistema. Utilice un argumento diferente para cada intervalo de tiempo adicional que desee especificar.

    La CLI de Greengrass admite los siguientes formatos para las marcas temporales:

    • yyyy-MM-DD, por ejemplo, 2020-06-30. La hora predeterminada es 00:00:00 cuando se utiliza este formato.

      yyyyMMDD, por ejemplo, 20200630. La hora predeterminada es 00:00:00 cuando se utiliza este formato.

      HH:mm:ss, por ejemplo, 15:30:45. La fecha por defecto es la fecha actual del sistema cuando se utiliza este formato.

      HH:mm:ssSSS, por ejemplo, 15:30:45. La fecha establece de forma predeterminada la fecha actual del sistema cuando se utiliza este formato.

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

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

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

    Las compensaciones relativas especifican un desfase del periodo con respecto a la hora actual del sistema. La CLI de Greengrass admite el siguiente formato para las compensaciones relativas: +|-[<value>h|hr|hours][valuem|min|minutes][value]s|sec|seconds.

    Por ejemplo, el siguiente argumento para especificar un intervalo de tiempo entre 1 hora y 2 horas y 15 minutos antes de la hora actual es --time-window -2h15min,-1hr.

  • --verbose. Muestre todos los campos de los mensajes de registro. No lo use con --syslog.

  • --no-color, -nc. Elimine el código de colores. El código de colores predeterminado para los mensajes de registro utiliza texto rojo en negrita. Solo admite terminales tipo UNIX porque utiliza secuencias de escape ANSI.

  • --before, -b. El número de líneas que se deben mostrar antes de una entrada de registro coincidente. El valor predeterminado es 0.

  • --after, -a. El número de líneas que se muestran después de una entrada de registro coincidente. El valor predeterminado es 0.

  • --syslog. Procese todos los archivos de registro mediante el protocolo syslog definido por. RFC3164 No lo use con --log-dir y --verbose. El protocolo syslog usa el siguiente formato: "<$Priority>$Timestamp $Host $Logger ($Class): $Message". Si no especifica un archivo de registro, la CLI de Greengrass lee los mensajes de registro de las siguientes ubicaciones: /var/log/messages, /var/log/syslog o /var/log/system.log.

    AWS IoT Greengrass actualmente no admite esta función en los dispositivos principales de Windows.

  • --max-log-queue-size, -m. El número máximo de entradas de registro que se van a asignar a la memoria. Utilice esta opción para optimizar el uso de la memoria. El valor predeterminado es 100.

Salida

El siguiente ejemplo muestra los resultados del 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

list-keywords

Muestra las palabras clave sugeridas que puede usar para filtrar los archivos de registro.

Sinopsis
greengrass-cli logs list-keywords [arguments]
Arguments

Ninguno

Salida

Los siguientes ejemplos muestran los resultados del 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

Muestra los archivos de registro que se encuentran en el directorio especificado.

Sinopsis
greengrass-cli logs list-log-files [arguments]
Arguments

--log-dir, -ld. La ruta al directorio para comprobar los archivos de registro.

Salida

El siguiente ejemplo muestra los resultados del 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.