AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no publicará actualizaciones que proporcionen características, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten en AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes características nuevas y es compatible con más plataformas.

Monitorización con registros de AWS IoT Greengrass

AWS IoT Greengrass consta del servicio de nube y el software de AWS IoT Greengrass Core. El software de AWS IoT Greengrass Core puede escribir registros en Amazon CloudWatch y en el sistema de archivos local del dispositivo del núcleo. Las funciones de Lambda y los conectores que se ejecutan en el núcleo también pueden escribir registros en CloudWatch Logs y en el sistema de archivos local. 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. Los cambios en la configuración de registro surten efecto después de implementar el grupo.

El registro está configurado en el nivel de grupo. Para ver los pasos que muestran cómo configurar el registro para un grupo de Greengrass, consulte Configuración de registro en AWS IoT Greengrass.

Acceso a registros de CloudWatch

Si configura el registro de CloudWatch, puede ver los registros en la página Registros de la consola de Amazon CloudWatch. Los grupos de registros de AWS IoT Greengrass utilizan las siguientes convenciones de nomenclatura:

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

Cada grupo de registros contiene flujos de registros que utilizan la siguiente convención de nomenclatura:

date/account-id/greengrass-group-id/name-of-core-that-generated-log

Las siguientes consideraciones se aplican cuando utilice CloudWatch Logs:

Acceso a los registros del sistema de archivos

Si configura el registro del sistema de archivos, los archivos de registro se almacenan en greengrass-root/ggc/var/log en el dispositivo del núcleo. A continuación, se muestra la estructura de directorios de alto nivel:

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

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

Configuración de registro predeterminada

Si las opciones de registro no se configuran de forma explícita, AWS IoT Greengrass utiliza la siguiente configuración de registro predeterminada después de la implementación del primer grupo.

Configuración de registro en AWS IoT Greengrass

Puede utilizar la consola de AWS IoT o las API de AWS IoT Greengrass para configurar el registro de AWS IoT Greengrass.

Configuración de registro (consola)

Puede configurar el registro en la página Configuración del grupo.

Configuración de registro (API)

Puede utilizar API de registrador de AWS IoT Greengrass para configurar el registro mediante programación. Por ejemplo, utilice la acción CreateLoggerDefinition para crear una definición de registradores basada en una carga LoggerDefinitionVersion, que utiliza la sintaxis siguiente:

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion es una matriz de uno o varios objetos Logger que tienen las propiedades siguientes:

Ejemplo de configuración

En el siguiente ejemplo de LoggerDefinitionVersion se especifica una configuración de registro que:

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

Una vez que se haya creado una versión de la definición de registradores, puede utilizar su ARN de la versión para crear una versión del grupo antes de implementar este.

Limitaciones de registro

AWS IoT Greengrass tiene las siguientes limitaciones de registro.

Transacciones por segundo

Cuando esté activada la opción de registro en CloudWatch, el componente de registro crea lotes de eventos de registro en el nivel local antes de enviarlos a CloudWatch para poder realizar el registro a una velocidad superior a cinco solicitudes por segundo por flujo de registro.

Memoria

Si se ha configurado AWS IoT Greengrass para que envíe los registros a CloudWatch y una función de Lambda registra más de 5 MB/segundo durante un periodo de tiempo prolongado, la canalización de procesamiento interno acaba por llenarse. El peor caso teórico es 6 MB por función de Lambda.

Desfase del reloj

Cuando se activa la opción de registro en CloudWatch, el componente de registro firma solicitudes para CloudWatch utilizando el proceso de firma Signature Version 4 normal. Si la hora del sistema del dispositivo principal de AWS IoT Greengrass no está sincronizada en más de 15 minutos, las solicitudes se rechazan.

Consumo de disco

Utilice la siguiente fórmula para calcular la cantidad máxima total de consumo de disco para la actividad de registro.

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

Donde:

Pérdida de registros

Si el dispositivo principal de AWS IoT Greengrass está configurado para iniciar sesión únicamente en CloudWatch y no hay conexión a Internet, no hay manera de recuperar los registros que se encuentren en la memoria.

Cuando las funciones de Lambda se terminan (por ejemplo, durante la implementación), hay unos segundos de los registros que no se escriben en Cloudwatch.

Registros de CloudTrail

AWS IoT Greengrass se ejecuta con AWS CloudTrail, un servicio que proporciona un registro de las acciones hechas por un usuario, un rol o un servicio de AWS en AWS IoT Greengrass. Para obtener más información, consulte Registro de llamadas a la API de AWS IoT Greengrass con AWS CloudTrail.