Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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. # Recopilación de datos de telemetría del estado del sistema desde los dispositivos principales AWS IoT Greengrass Los datos de telemetría del estado del sistema son datos de diagnóstico que pueden ayudarlo a monitorear el rendimiento de las operaciones críticas en sus dispositivos principales de Greengrass. El agente de telemetría del núcleo de Greengrass recopila datos de telemetría locales y los publica en Amazon EventBridge sin necesidad de ninguna interacción con el cliente. Los dispositivos principales publican los datos de telemetría haciendo todo lo posible. EventBridge Por ejemplo, es posible que los dispositivos principales no entreguen los datos de telemetría cuando están fuera de línea. **nota** Amazon EventBridge es un servicio de bus de eventos que puede utilizar para conectar sus aplicaciones con datos de diversas fuentes, como los dispositivos principales de Greengrass y las notificaciones de [implementación](deployment-notifications.md). Para obtener más información, consulta [¿Qué es Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) en la *Guía del EventBridge usuario de Amazon*. Puede crear proyectos y aplicaciones para recuperar, analizar, transformar y generar informes sobre los datos de telemetría de sus dispositivos periféricos. Los expertos de dominio, como los ingenieros de procesos, pueden utilizar estas aplicaciones para obtener información sobre el estado de la flota. Para garantizar que los componentes perimetrales de Greengrass funcionen correctamente, AWS IoT Greengrass utiliza los datos con fines de desarrollo y mejora de la calidad. Esta función también ayuda a informar sobre las capacidades perimetrales nuevas y mejoradas. AWS IoT Greengrass solo conserva los datos de telemetría durante un máximo de siete días. Esta función está disponible en la versión 1.11.0 del software AWS IoT Greengrass Core y está habilitada de forma predeterminada para todos los núcleos de Greengrass, incluidos los núcleos existentes. Empezará a recibir datos automáticamente en cuanto se actualice a la versión 1.11.0 AWS IoT Greengrass o posterior del software Core. Para obtener información sobre cómo acceder o administrar datos de telemetría publicados, consulte [Suscripción para recibir datos de telemetría](#subscribe-for-telemetry-data). El agente de telemetría recopila y publica las siguientes métricas del sistema. **Métricas de telemetría** | Name | Description (Descripción) | origen | | --- | --- | --- | | `SystemMemUsage` | La cantidad de memoria que utilizan actualmente todas las aplicaciones del dispositivo principal de Greengrass, incluido el sistema operativo. | Sistema | | `CpuUsage` | La cantidad de CPU que utilizan actualmente todas las aplicaciones del dispositivo principal de Greengrass, incluido el sistema operativo. | Sistema | | `TotalNumberOfFDs` | El número de descriptores de archivos almacenados por el sistema operativo del dispositivo principal de Greengrass. Un descriptor de archivo identifica exclusivamente un archivo abierto. | Sistema | | `LambdaOutOfMemory` | El número de ejecuciones que provocan que la función de Lambda se quede sin memoria. | Sistema | | `DroppedMessageCount` | El número de mensajes descartados que están destinados a AWS IoT Core. | Componente del sistema de `GGCloudSpooler` | | `LambdaTimeout` | Número de tiempos de espera para ejecutar la función de Lambda definida por el usuario. | Función Nube de AWS Lambda y sistema definidos por el usuario | | `LambdaUngracefullyKilled` | El número de ejecuciones que la función de Lambda definida por el usuario no completa. | Función Nube de AWS Lambda y sistema definidos por el usuario | | `LambdaError` | El número de ejecuciones que dan como resultado los registros de errores de escritura de la función de Lambda definida por el usuario. | Función Nube de AWS Lambda y sistema definidos por el usuario | | `BytesAppended` | El número de bytes de datos anexos al administrador de flujos. | Componente del sistema de `GGStreamManager` | | `BytesUploadedToIoTAnalytics` | El número de bytes de datos que el administrador de transmisiones exporta a los canales. AWS IoT Analytics | Componente del sistema de `GGStreamManager` | | `BytesUploadedToKinesis` | El número de bytes de datos que el administrador de flujos exporta a los flujos de Amazon Kinesis Data Streams. | Componente del sistema de `GGStreamManager` | | `BytesUploadedToIoTSiteWise` | El número de bytes de datos que Stream Manager exporta a las propiedades de los activos AWS IoT SiteWise. | Componente del sistema de `GGStreamManager` | | `BytesUploadedToS3ExportTaskExecutor` | El número de bytes de datos que el administrador de flujos exporta a objetos de Amazon S3. | Componente del sistema de `GGStreamManager` | | `BytesUploadedToHTTP` | El número de bytes de datos que el administrador de flujos exporta a HTTP. | Componente del sistema de `GGStreamManager` | ## Configuración de los ajustes de telemetría La telemetría de Greengrass utiliza los siguientes ajustes: + El agente de telemetría agrega los datos de telemetría cada hora. + El agente de telemetría publica un mensaje de telemetría cada 24 horas. **nota** Los ajustes no se pueden cambiar. Puede habilitar o deshabilitar la característica de telemetría para un dispositivo principal de Greengrass. AWS IoT Greengrass usa [sombras](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) para administrar la configuración de telemetría. Los cambios se aplican inmediatamente cuando el núcleo tiene una conexión a AWS IoT Core. El agente de telemetría publica los datos mediante el protocolo MQTT con un nivel de calidad de servicio (QoS) de 0. Esto significa que no confirma la entrega ni reintenta publicar los intentos. Los mensajes de telemetría comparten una conexión MQTT con otros mensajes para las suscripciones destinadas para AWS IoT Core. Además de los costes de enlace de datos, la transferencia de datos desde el núcleo hasta AWS IoT Core ella es gratuita. Esto se debe a que el agente publica en un tema AWS reservado. Sin embargo, en función de su caso de uso, es posible que incurra en costes cuando reciba o procese los datos. ### Requisitos Se aplican los siguientes requisitos al configurar los ajustes de telemetría: + Debe utilizar el software AWS IoT Greengrass Core v1.11.0 o posterior. **nota** Si está ejecutando una versión anterior y no desea usar telemetría, no tiene que realizar ninguna acción. + Debe proporcionar permisos de IAM para actualizar la sombra principal y para llamar a la configuración APIs antes de actualizar los ajustes de telemetría. El siguiente ejemplo de política de IAM le permite administrar la configuración oculta y el tiempo de ejecución de un núcleo específico: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowManageShadow", "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow", "iot:DescribeThing" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:thing/core-name-*" ] }, { "Sid": "AllowManageRuntimeConfig", "Effect": "Allow", "Action": [ "greengrass:GetCoreRuntimeConfiguration", "greengrass:UpdateCoreRuntimeConfiguration" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:thing/core-name" ] } ] } ``` ------ Puede conceder acceso granular o condicional a recursos (por ejemplo, utilizando un esquema de nomenclatura con comodín `*`) Para obtener más información, consulte [Adición y eliminación de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) en la *Guía del usuario de IAM*. ### Configurar los ajustes de telemetría (consola) A continuación se muestra cómo actualizar la configuración de telemetría de un núcleo de Greengrass en la consola. AWS IoT Greengrass 1. En el panel de navegación de la AWS IoT consola, en **Administrar**, expanda **los dispositivos Greengrass** y, a continuación, elija **Grupos (V1)**. 1. En **Grupos de Greengrass**, elija su grupo objetivo. 1. En la página de configuración del grupo, en la sección **Descripción general**, elija su **Greengrass core**. 1. En la página de configuración del núcleo, elija la pestaña **Telemetría**. 1. **En la sección **Telemetría del estado del sistema**, seleccione Configurar**. 1. En **Configurar telemetría**, seleccione Telemetría para activar o desactivar el estado de Telemetría. **importante** De forma predeterminada, la función de telemetría está habilitada para el software AWS IoT Greengrass Core v1.11.0 o posterior. Los cambios surten efecto durante el tiempo de ejecución. No es necesario implementar el grupo. ### Configurar los ajustes de telemetría (CLI) En la AWS IoT Greengrass API, el `TelemetryConfiguration` objeto representa la configuración de telemetría de un núcleo de Greengrass. Este objeto forma parte del objeto `RuntimeConfiguration` asociado al núcleo. Puede usar la AWS IoT Greengrass API o el AWS SDK para administrar la telemetría de Greengrass. AWS CLI En los ejemplos de esta sección se utiliza la AWS CLI. **Para comprobar los ajustes de telemetría** El siguiente comando obtiene los ajustes de telemetría de un Greengrass core. + *core-thing-name*Sustitúyalo por el nombre del núcleo de destino. Para obtener el nombre de la cosa, se usa el [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. El comando devuelve el ARN de la cosa que contiene el nombre de la cosa. ``` aws greengrass get-thing-runtime-configuration --thing-name core-thing-name ``` El comando `GetCoreRuntimeConfigurationResponse` devuelve los datos en un objeto JSON. Por ejemplo: ``` { "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "OutOfSync", "Telemetry": "On" } } } ``` **Para configurar los ajustes de telemetría** El siguiente comando actualiza los ajustes de telemetría de un Greengrass core. + *core-thing-name*Sustitúyalo por el nombre del núcleo objetivo. Para obtener el nombre de la cosa, se usa el [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. El comando devuelve el ARN de la cosa que contiene el nombre de la cosa. ``` aws greengrass update-thing-runtime-configuration --thing-name core-thing-name --telemetry-configuration '{ "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "InSync", "Telemetry": "Off" } } } ``` ``` aws greengrass update-thing-runtime-configuration --thing-name core-thing-name --telemetry-configuration "{\"TelemetryConfiguration\":{\"ConfigurationSyncStatus\":\"InSync\",\"Telemetry\":\"Off\"}}" ``` Se han aplicado cambios en la configuración a la telemetría si el `ConfigurationSyncStatus` es `InSync`. Los cambios surten efecto durante el tiempo de ejecución. No es necesario implementar el grupo. #### TelemetryConfiguration objeto El objeto de `TelemetryConfiguration` incluye las siguientes propiedades: `ConfigurationSyncStatus` Comprueba si los ajustes de telemetría están sincronizados. Es posible que no realice cambios en esta propiedad. Tipo: cadena Valores válidos: `InSync` o `OutOfSync` `Telemetry` Activa o desactiva la telemetría. El valor predeterminado es `On`. Tipo: String Valores válidos: `On` o `Off` ## Suscripción para recibir datos de telemetría Puede crear reglas en Amazon EventBridge que definan cómo procesar los datos de telemetría publicados desde el dispositivo principal de Greengrass. Cuando EventBridge recibe los datos, invoca las acciones objetivo definidas en sus reglas. Por ejemplo, puede crear reglas de eventos que envíen notificaciones, almacenen información sobre eventos, adopten medidas correctivas o invoquen otros eventos. ### Evento de telemetría El evento de un cambio de estado de la implementación, incluidos los datos de telemetría, tiene el siguiente formato: ``` { "version": "0", "id": "f70f943b-9ae2-e7a5-fec4-4c22178a3e6a", "detail-type": "Greengrass Telemetry Data", "source": "aws.greengrass", "account": "123456789012", "time": "2020-07-28T20:45:53Z", "region": "us-west-1", "resources": [], "detail": { "ThingName": "CoolThing", "Schema": "2020-06-30", "ADP": [ { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToKinesis", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToS3ExportTaskExecutor", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToHTTP", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToIoTAnalytics", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "StreamManager", "M": [ { "N": "BytesAppended|BytesUploadedToIoTSiteWise", "Sum": 11, "U": "Bytes" } ] }, { "TS": 123231546, "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function", "M": [ { "N": "LambdaTimeout", "Sum": 15, "U": "Count" } ] }, { "TS": 123231546, "NS": "CloudSpooler", "M": [ { "N": "DroppedMessageCount", "Sum": 15, "U": "Count" } ] }, { "TS": 1593727692, "NS": "SystemMetrics", "M": [ { "N": "SystemMemUsage", "Sum": 11.23, "U": "Megabytes" }, { "N": "CpuUsage", "Sum": 35.63, "U": "Percent" }, { "N": "TotalNumberOfFDs", "Sum": 416, "U": "Count" } ] }, { "TS": 1593727692, "NS": "arn:aws:lambda:us-west-1:123456789012:function:my-function", "M": [ { "N": "LambdaOutOfMemory", "Sum": 12, "U": "Count" }, { "N": "LambdaUngracefullyKilled", "Sum": 100, "U": "Count" }, { "N": "LambdaError", "Sum": 7, "U": "Count" } ] } ] } } ``` La matriz `ADP` contiene una lista de puntos de datos agregados que tienen las siguientes propiedades: `TS` Obligatorio. Marca temporal del momento en que se agregaron los datos. `NS` Obligatorio. El espacio de nombre del sistema de archivos. `M` Obligatorio. Lista de métricas Una métrica contiene las siguientes propiedades: `N` El nombre de la [métrica](#telemetry-metrics). `Sum` El valor métrico agregado. El agente de telemetría añade nuevos valores al total anterior, por lo que la suma es un valor cada vez mayor. Puede usar la marca de tiempo para encontrar el valor de una agregación específica. Por ejemplo, para encontrar el último valor agregado, reste el valor de la marca de tiempo anterior del último valor de marca de tiempo. `U` La unidad del valor métrico. `ThingName` Obligatorio. El nombre del dispositivo al que apunta. ### Requisitos previos para crear reglas EventBridge Antes de crear una EventBridge regla para AWS IoT Greengrass, debe hacer lo siguiente: + Familiarícese con los eventos, las reglas y los objetivos en EventBridge. + Cree y configure los [objetivos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) invocados por sus EventBridge reglas. Las reglas pueden invocar muchos tipos de objetivos, como transmisiones de Amazon Kinesis AWS Lambda , funciones, temas de Amazon SNS y colas de Amazon SQS. Tu EventBridge regla y los objetivos asociados deben estar en el Región de AWS lugar donde creaste tus recursos de Greengrass. Para obtener más información, consulte [Puntos de enlace y cuotas](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) en la *Referencia general de AWS*. Para obtener más información, consulta [¿Qué es Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) y [Primeros pasos con Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) en la *Guía del EventBridge usuario de Amazon*. ### Cree una regla de eventos para obtener datos de telemetría (consola) Siga los siguientes pasos para crear una EventBridge regla que reciba los Consola de administración de AWS datos de telemetría publicados por el núcleo de Greengrass. De este modo, los servidores web, las direcciones de correo electrónico y otros suscriptores del tema podrán responder al evento. Para obtener más información, consulta [Crear una EventBridge regla que se active en un evento desde un AWS recurso](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) en la *Guía del EventBridge usuario de Amazon*. 1. Abre la [ EventBridgeconsola de Amazon](https://console.aws.amazon.com/events/) y selecciona **Crear regla**. 1. En **Name and description (Nombre y descripción)**, escriba un nombre y descripción para la regla. 1. Elija **bus de eventos** y active la regla en el bus de eventos seleccionado. 1. Seleccione **Tipo de regla** y luego **Regla con un patrón de evento**. 1. Elija **Siguiente**. 1. **En Origen del evento**, selecciona **AWS eventos o eventos EventBridge asociados**. 1. En **Evento de muestra**, elija **eventos AWS ** y seleccione **Datos de telemetría de Greengrass**. 1. En **Patrón de eventos**, seleccione las siguientes opciones: 1. En **Origen de evento**, seleccione **Servicios de AWS **. 1. En **Servicio de AWS **, elija **Greengrass**. 1. En **Tipo de evento**, elija **Datos de telemetría de Greengrass**. 1. Elija **Siguiente**. 1. En **Target 1** elija **AWS service**. 1. En **Seleccione un objetivo**, elija la **cola de SQS.** 1. En **Cola**, elija su función. ### Cree una regla de eventos para obtener datos de telemetría (CLI) Siga los siguientes pasos para crear una EventBridge regla que reciba los AWS CLI datos de telemetría publicados por el núcleo de Greengrass. De este modo, los servidores web, las direcciones de correo electrónico y otros suscriptores del tema podrán responder al evento. 1. Crear la regla. + *thing-name*Sustitúyala por el nombre del núcleo. Para obtener el nombre de la cosa, se usa el [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. El comando devuelve el ARN de la cosa que contiene el nombre de la cosa. ``` aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` Las propiedades que se omiten en el patrón no se tienen en cuenta. 1. Agregue el tema como destino de la regla. El siguiente ejemplo usa Amazon SQS, pero puede configurar otros tipos de objetivos. + *queue-arn*Sustitúyalo por el ARN de la cola de Amazon SQS. ``` aws events put-targets \ --rule TestRule \ --targets "Id"="1","Arn"="queue-arn" ``` **nota** Para permitir que Amazon EventBridge invoque tu cola de destino, debes añadir a tu tema una política basada en recursos. Para obtener más información, consulte los [permisos de Amazon SQS](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sqs-permissions) en la Guía * EventBridge del usuario de Amazon*. Para obtener más información, consulta [Eventos y patrones de eventos EventBridge en](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) la *Guía del EventBridge usuario de Amazon*. ## Solución de problemas de AWS IoT Greengrass telemetría Utilice la siguiente información para solucionar problemas relacionados con la configuración de la telemetría. AWS IoT Greengrass ### Error: la respuesta contiene "ConfigurationStatus«:" OutOfSync "después de ejecutar el comando get-thing-runtime-configuration **Soluciones:** + El servicio AWS IoT Device Shadow tarda en procesar las actualizaciones de configuración en tiempo de ejecución y en entregar las actualizaciones al dispositivo principal de Greengrass. Puede esperar y comprobar si los ajustes de telemetría están sincronizados más adelante. + Asegúrese de que el dispositivo del núcleo esté en línea. + Activa [Amazon CloudWatch Logs in AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html#viewing-logs) para monitorear la sombra. + Utilice las [métricas de AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/monitoring-cloudwatch.html) para monitorizar su objeto.