registros - AWS IoT Greengrass
getlista de palabras clavelist-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 su dispositivo principal.

Subcomandos

get

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 utilizar al menos uno de los siguientes --log-dir valores--log-file: También puede usar ambos argumentos en un solo comando.

  • --log-file,-lf. Las rutas a los directorios de registro que desea utilizar. Utilice un argumento diferente para cada directorio adicional que desee especificar. Debe utilizar al menos uno de los siguientes --log-dir valores--log-file: También puede usar ambos argumentos en un solo 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 supervisar 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 name clave que contenga 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 de tiempo exactas como compensaciones relativas. Debe proporcionar esta información en el formato. <begin-time>,<end-time> Si no especifica ni 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 ventana de tiempo adicional que desee especificar.

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

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

    Los desfases relativos especifican un desfase de período de tiempo 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. Muestra todos los campos de los mensajes de registro. No lo use con--syslog.

  • --no-color,-nc. Eliminar 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 en el RFC3164. No lo use con y. --log-dir --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 Greengrassactualmente 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. Use esta opción para optimizar el uso de la memoria. El valor predeterminado es 100.

Salida

El siguiente ejemplo muestra el resultado que se produce al ejecutar este 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

lista de palabras clave

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

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

Ninguna

Salida

Los ejemplos siguientes muestran el resultado que se produce al ejecutar este 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 ubicados en un 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 el resultado que se produce al ejecutar este 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.