Supervisar AWS IoT Greengrass registros - AWS IoT Greengrass
Acceda a los registros del sistema de archivosRegistros de acceso CloudWatch Acceda a los registros de servicios del sistemaHabilite el registro en los CloudWatch registrosConfiguración de registro en AWS IoT GreengrassRegistros de AWS CloudTrail

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.

Supervisar AWS IoT Greengrass registros

AWS IoT Greengrass consta del servicio de nube y el software de AWS IoT Greengrass Core. El software AWS IoT Greengrass Core puede escribir registros en Amazon CloudWatch Logs y en el sistema de archivos local del dispositivo principal. Los componentes de Greengrass que se ejecutan en el dispositivo principal también pueden escribir registros en Logs y en el sistema de archivos local. CloudWatch Puede utilizar registros para monitorizar eventos y solucionar problemas. Todas las entradas de registro de AWS IoT Greengrass incluyen una marca temporal, un nivel de registro e información sobre el evento.

De forma predeterminada, el software AWS IoT Greengrass Core escribe los registros únicamente en el sistema de archivos local. Puede ver los registros del sistema de archivos en tiempo real para poder depurar los componentes de Greengrass que desarrolle e implemente. También puede configurar un dispositivo principal para escribir registros en los CloudWatch registros, de modo que pueda solucionar los problemas del dispositivo principal sin acceso al sistema de archivos local. Para obtener más información, consulte Habilite el registro en los CloudWatch registros.

Acceda a los registros del sistema de archivos

El software AWS IoT Greengrass Core almacena los registros en la /greengrass/v2/logs carpeta de un dispositivo principal, donde /greengrass/v2 se encuentra la ruta a la carpeta AWS IoT Greengrass raíz. La carpeta de registros tiene la siguiente estructura.

/greengrass/v2
└── logs
    ├── greengrass.log
    ├── greengrass_2021_09_14_15_0.log
    ├── ComponentName.log
    ├── ComponentName_2021_09_14_15_0.log
    └── main.log

  • greengrass.log— El archivo de registro del software AWS IoT Greengrass principal. Utilice este archivo de registro para ver información en tiempo real sobre los componentes y las implementaciones. Este archivo de registro incluye los registros del núcleo de Greengrass, que es el núcleo del software principal, y los AWS IoT Greengrass componentes del complemento, como el administrador de registros y el administrador de secretos.

  • ComponentName.log— Archivos de registro de componentes de Greengrass. Utilice los archivos de registro de componentes para ver información en tiempo real sobre un componente de Greengrass que se ejecuta en el dispositivo principal. Los componentes genéricos y los componentes Lambda escriben la salida estándar (stdout) y el error estándar (stderr) en estos archivos de registro.

  • main.log— El archivo de registro del main servicio que gestiona los ciclos de vida de los componentes. Este archivo de registro siempre estará vacío.

Para obtener más información sobre las diferencias entre los componentes de complemento, genéricos y de Lambda, consulte. Tipos de componentes

Las siguientes consideraciones se aplican cuando se utilizan los registros del sistema de archivos:

  • Permisos de usuario root

    Debe tener permisos de raíz para leer registros de AWS IoT Greengrass en el sistema de archivos.

  • Rotación de archivos de registro

    El software AWS IoT Greengrass Core rota los archivos de registro cada hora o cuando superan un límite de tamaño de archivo. Los archivos de registro rotados contienen una marca de tiempo en el nombre del archivo. Por ejemplo, un archivo de registro del software AWS IoT Greengrass Core girado podría tener un nombre. greengrass_2021_09_14_15_0.log El límite de tamaño de archivo predeterminado es de 1024 KB (1 MB). Puede configurar el límite de tamaño de archivo en el componente núcleo de Greengrass.

  • Eliminación del archivo de registro

    El software AWS IoT Greengrass Core limpia los archivos de registro anteriores cuando el tamaño de los archivos de registro del software AWS IoT Greengrass Core o de los archivos de registro de los componentes de Greengrass, incluidos los archivos de registro rotados, supera el límite de espacio en disco. El límite de espacio en disco predeterminado para el registro del software AWS IoT Greengrass principal y para cada registro de componentes es de 10 240 KB (10 MB). Puede configurar el límite de espacio en disco de registro del software AWS IoT Greengrass principal en el componente núcleo de Greengrass o en el componente de administrador de registros. Puede configurar el límite de espacio en disco de registro de cada componente en el componente del administrador de registros.

Para ver el archivo de registro del software AWS IoT Greengrass principal

  • Ejecute el siguiente comando para ver el archivo de registro en tiempo real. /greengrass/v2Sustitúyalo por la ruta a la carpeta AWS IoT Greengrass raíz.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\com.example.HelloWorld.log

    El type comando escribe el contenido del archivo en la terminal. Ejecute este comando varias veces para observar los cambios en el archivo.

    PowerShell
    gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
Para ver el archivo de registro de un componente

  • Ejecute el siguiente comando para ver el archivo de registro en tiempo real. Sustituya /greengrass/v2 o C:\greengrass\v2 por la ruta de acceso a la carpeta AWS IoT Greengrass raíz y sustituya com.example. HelloWorldpor el nombre del componente.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait

También puede usar el logs comando de la CLI de Greengrass para analizar los registros de Greengrass en un dispositivo principal. Para usar el logs comando, debe configurar el núcleo de Greengrass para que genere archivos de registro en formato JSON. Para obtener más información, consulte Interfaz de línea de comandos Greengrass y registros.

Registros de acceso CloudWatch

Puede implementar el componente de administrador de registros para configurar el dispositivo principal para que escriba en CloudWatch los registros. Para obtener más información, consulte Habilite el registro en los CloudWatch registros. A continuación, puedes ver los registros en la página Logs de la CloudWatch consola de Amazon o mediante la API CloudWatch Logs.

Nombre del grupo de registros
/aws/greengrass/componentType/region/componentName

El nombre del grupo de registros utiliza las siguientes variables:

  • componentType— El tipo de componente, que puede ser uno de los siguientes:

    • GreengrassSystemComponent— Este grupo de registros incluye los registros de los componentes del núcleo y del complemento, que se ejecutan en la misma JVM que el núcleo de Greengrass. El componente forma parte del núcleo de Greengrass.

    • UserComponent— Este grupo de registros incluye registros de componentes genéricos, componentes de Lambda y otras aplicaciones del dispositivo. El componente no forma parte del núcleo de Greengrass.

    Para obtener más información, consulte Tipos de componentes.

  • region— La AWS región que utiliza el dispositivo principal.

  • componentName— El nombre del componente. Para los registros del sistema, este valor esSystem.

Nombre del flujo de registro
/date/thing/thingName

El nombre del flujo de registro utiliza las siguientes variables:

  • date— La fecha del registro, por ejemplo2020/12/15. El componente del administrador de registros usa el yyyy/MM/dd formato.

  • thingName— El nombre del dispositivo principal.

nota

Si el nombre de un elemento contiene dos puntos (:), el administrador de registros los sustituye por un signo más (+).

Cuando se utiliza el componente gestor de registros para escribir en los CloudWatch registros, se tienen en cuenta las siguientes consideraciones:

  • Retrasos de registro

    nota

    Le recomendamos que actualice a la versión 2.3.0 del administrador de registros, ya que reduce las demoras en el registro de los archivos de registro activos y rotados. Cuando actualice a log manager 2.3.0, le recomendamos que también actualice a Greengrass nucleus 2.9.1.

    La versión 2.2.8 (y anteriores) del componente gestor de registros procesa y carga los registros únicamente a partir de archivos de registro rotados. De forma predeterminada, el software AWS IoT Greengrass Core rota los archivos de registro cada hora o después de que ocupen 1024 KB. Como resultado, el componente del administrador de registros carga los registros solo después de que el software AWS IoT Greengrass Core o un componente de Greengrass hayan escrito registros con un valor superior a 1024 KB. Puede configurar un límite de tamaño de archivo de registro inferior para que los archivos de registro roten con más frecuencia. Esto hace que el componente del administrador de registros cargue registros en CloudWatch Logs con más frecuencia.

    La versión 2.3.0 (y posteriores) del componente gestor de registros procesa y carga todos los registros. Al escribir un registro nuevo, la versión 2.3.0 (y posteriores) del administrador de registros procesa y carga directamente el archivo de registro activo en lugar de esperar a que se rote. Esto significa que puede ver el nuevo registro en 5 minutos o menos.

    El componente del administrador de registros carga nuevos registros periódicamente. De forma predeterminada, el componente del administrador de registros carga nuevos registros cada 5 minutos. Puede configurar un intervalo de carga más bajo, de modo que el componente del administrador de registros cargue los registros en los CloudWatch registros con más frecuencia configurando el. periodicUploadIntervalSec Para obtener más información sobre cómo configurar este intervalo periódico, consulte Configuración.

    Los registros se pueden cargar prácticamente en tiempo real desde el mismo sistema de archivos de Greengrass. Si necesita observar los registros en tiempo real, considere la posibilidad de utilizar los registros del sistema de archivos.

    nota

    Si utiliza distintos sistemas de archivos para escribir los registros, el administrador de registros vuelve al comportamiento de las versiones 2.2.8 y anteriores de los componentes del administrador de registros. Para obtener información sobre cómo acceder a los registros del sistema de archivos, consulte Acceder a los registros del sistema de archivos.

  • Inclinación del reloj

    El componente de gestión de registros utiliza el proceso de firma estándar de la versión 4 de Signature para crear solicitudes de API a CloudWatch los registros. Si la hora del sistema en un dispositivo principal está desincronizada durante más de 15 minutos, CloudWatch Logs rechaza las solicitudes. Para obtener más información, consulte Proceso de firma Signature Version 4 en la Referencia general de AWS.

Acceda a los registros de servicios del sistema

Si configura el software AWS IoT Greengrass principal como un servicio del sistema, puede ver los registros de servicio del sistema para solucionar problemas, como el hecho de que el software no se inicie.

Para ver los registros de servicio del sistema (CLI)

  1. Ejecute el siguiente comando para ver los registros de servicio del sistema del software AWS IoT Greengrass principal.

    Linux or Unix (systemd)
    sudo journalctl -u greengrass.service
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.wrapper.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.wrapper.log

  2. En los dispositivos Windows, el software AWS IoT Greengrass Core crea un archivo de registro independiente para los errores del servicio del sistema. Ejecute el siguiente comando para ver los registros de errores del servicio del sistema.

    Windows Command Prompt (CMD)
    type C:\greengrass\v2\logs\greengrass.err.log
    PowerShell
    gc C:\greengrass\v2\logs\greengrass.err.log

En los dispositivos Windows, también puede utilizar la aplicación Event Viewer para ver los registros de servicio del sistema.

Para ver los registros de servicio de Windows (Visor de eventos)

  1. Abra la aplicación Event Viewer.

  2. Seleccione Registros de Windows para expandirlo.

  3. Elija Aplicación para ver los registros de servicio de la aplicación.

  4. Busque y abra los registros de eventos cuya fuente sea greengrass.

Habilite el registro en los CloudWatch registros

Puede implementar el componente de administrador de registros para configurar un dispositivo principal para escribir registros en los CloudWatch registros. Puede habilitar CloudWatch los registros para los registros del software AWS IoT Greengrass principal y puede habilitar CloudWatch los registros para componentes específicos de Greengrass.

nota

La función de intercambio de tokens del dispositivo principal de Greengrass debe permitir que el dispositivo principal escriba en los CloudWatch registros, como se muestra en el siguiente ejemplo de política de IAM. Si instaló el software AWS IoT Greengrass Core con el aprovisionamiento automático de recursos, su dispositivo principal tiene estos permisos.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}

Para configurar un dispositivo principal para que escriba los registros del software AWS IoT Greengrass principal en CloudWatch Logs, cree una implementación que especifique una actualización de configuración que se establezca uploadToCloudWatch true para el aws.greengrass.LogManager componente. AWS IoT Greengrass Los registros del software principal incluyen los registros del núcleo y los componentes del complemento de Greengrass.

{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true"
    }
  }
}

Para configurar un dispositivo principal para escribir los registros de un componente de Greengrass en Logs, cree una implementación que especifique una actualización de configuración que añada el componente a la lista de configuraciones de registro de componentes. CloudWatch Al agregar un componente a esta lista, el componente del administrador de registros escribe sus registros en CloudWatch Logs. Los registros de componentes incluyen registros de componentes genéricos y componentes Lambda.

{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
      
      }
    }
  }
}

Al implementar el componente de administrador de registros, también puede configurar los límites de espacio en disco y determinar si el dispositivo principal eliminará los archivos de registro después de escribirlos en los CloudWatch registros. Para obtener más información, consulte Configuración de registro en AWS IoT Greengrass.

Configuración de registro en AWS IoT Greengrass

Puede configurar las siguientes opciones para personalizar el registro de los dispositivos principales de Greengrass. Para configurar estas opciones, cree una implementación que especifique una actualización de configuración para los componentes del núcleo o del administrador de registros de Greengrass.

  • Escribir registros en registros CloudWatch

    Para solucionar los problemas de los dispositivos principales de forma remota, puede configurar los dispositivos principales para que escriban los registros AWS IoT Greengrass del software y los componentes principales en los CloudWatch registros. Para ello, implemente y configure el componente del administrador de registros. Para obtener más información, consulte Habilite el registro en los CloudWatch registros.

  • Eliminar los archivos de registro cargados

    Para reducir el uso del espacio en disco, puede configurar los dispositivos principales para que eliminen los archivos de registro después de escribirlos en los CloudWatch registros. Para obtener más información, consulte el deleteLogFileAfterCloudUpload parámetro del componente del administrador de registros, que puede especificar para los registros del software AWS IoT Greengrass principal y los registros de los componentes.

  • Límites de espacio en disco de registro

    Para limitar el uso del espacio en disco, puede configurar el espacio máximo en disco para cada registro, incluidos sus archivos de registro rotados, en un dispositivo principal. Por ejemplo, puede configurar el espacio máximo combinado en disco para los archivos rotados greengrass.log y para los archivos. greengrass.log Para obtener más información, consulte el parámetro del componente núcleo de Greengrass y el logging.totalLogsSizeKB parámetro del componente del diskSpaceLimit administrador de registros, que puede especificar para los registros del software AWS IoT Greengrass principal y los registros de los componentes.

  • Límite de tamaño de los archivos de registro

    Puede configurar el tamaño máximo de archivo para cada archivo de registro. Cuando un archivo de registro supera este límite de tamaño de archivo, el software AWS IoT Greengrass Core crea un nuevo archivo de registro. La versión 2.28 (y anteriores) del componente gestor de registros solo graba en los CloudWatch registros los archivos de registro rotados, por lo que puede especificar un límite de tamaño de archivo inferior para escribir los registros en los CloudWatch registros con más frecuencia. La versión 2.3.0 (y posteriores) del componente gestor de registros procesa y carga todos los registros en lugar de esperar a que se roten. Para obtener más información, consulte el parámetro límite de tamaño del archivo de registro del componente núcleo de Greengrass ()logging.fileSizeKB.

  • Niveles mínimos de registro

    Puede configurar el nivel de registro mínimo que el componente núcleo de Greengrass escribe en los registros del sistema de archivos. Por ejemplo, puede especificar registros de DEBUG nivel para facilitar la solución de problemas, o puede especificar registros de ERROR nivel para reducir la cantidad de registros que crea un dispositivo central. Para obtener más información, consulte el parámetro de nivel de registro del componente núcleo de Greengrass ()logging.level.

    También puede configurar el nivel de registro mínimo que el componente del administrador de CloudWatch registros escribe en Logs. Por ejemplo, puede especificar un nivel de registro superior para reducir los costes de registro. Para obtener más información, consulte el minimumLogLevel parámetro del componente del administrador de registros, que puede especificar para los registros del software AWS IoT Greengrass principal y los registros de los componentes.

  • Intervalo para comprobar si hay registros para escribirlos en los CloudWatch registros

    Para aumentar o reducir la frecuencia con la que el componente del administrador de registros escribe CloudWatch registros en los registros, puede configurar el intervalo en el que comprueba si hay nuevos archivos de registro que escribir. Por ejemplo, puede especificar un intervalo inferior para ver los registros en los CloudWatch registros antes de lo que lo haría con el intervalo predeterminado de 5 minutos. Puede especificar un intervalo mayor para reducir los costes, ya que el componente del administrador de registros agrupa los archivos de registro en menos solicitudes. Para obtener más información, consulte el parámetro de intervalo de carga del componente de administrador de registros (periodicUploadIntervalSec).

  • Formato de registro

    Puede elegir si el software AWS IoT Greengrass Core escribe los registros en formato de texto o JSON. Elija el formato de texto si lee los registros o el formato JSON si utiliza una aplicación para leer o analizar los registros. Para obtener más información, consulte el parámetro de formato de registro () logging.format del componente núcleo de Greengrass.

  • Carpeta de registros del sistema de archivos local

    Puede cambiar la carpeta de registros /greengrass/v2/logs por otra carpeta del dispositivo principal. Para obtener más información, consulte el parámetro del directorio de salida del componente núcleo de Greengrass ()logging.outputDirectory.

Registros de AWS CloudTrail

AWS IoT Greengrassse integra conAWS CloudTrail, un servicio que proporciona un registro de las acciones realizadas por un usuario, rol o elementoServicio de AWS. AWS IoT Greengrass Para obtener más información, consulte Registra las llamadas a la AWS IoT Greengrass V2 API con AWS CloudTrail.