Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1 Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Raccolta di dati di telemetria sanitaria del sistema dai dispositivi principali AWS IoT Greengrass I dati di telemetria sullo stato del sistema sono dati diagnostici che possono aiutarti a monitorare le prestazioni delle operazioni critiche sui tuoi dispositivi principali Greengrass. L'agente di telemetria sul core di Greengrass raccoglie dati di telemetria locali e li pubblica su Amazon senza richiedere alcuna interazione con il cliente. EventBridge I dispositivi principali pubblicano i dati di telemetria con la massima diligenza possibile. EventBridge Ad esempio, i dispositivi principali potrebbero non riuscire a fornire dati di telemetria mentre sono offline. **Nota** Amazon EventBridge è un servizio di bus di eventi che puoi utilizzare per connettere le tue applicazioni con dati provenienti da diverse fonti, come i dispositivi principali Greengrass e le notifiche di [distribuzione](deployment-notifications.md). Per ulteriori informazioni, consulta [What is Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) nella *Amazon EventBridge User Guide*. Puoi creare progetti e applicazioni per recuperare, analizzare, trasformare e generare report sui dati di telemetria dai tuoi dispositivi periferici. Gli esperti del settore, come gli ingegneri di processo, possono utilizzare queste applicazioni per ottenere informazioni sullo stato della flotta. Per garantire il corretto funzionamento dei componenti Greengrass Edge, AWS IoT Greengrass utilizza i dati per scopi di sviluppo e miglioramento della qualità. Questa funzionalità aiuta anche a sviluppare nuove e migliorate funzionalità edge. AWS IoT Greengrass conserva i dati di telemetria solo per un massimo di sette giorni. Questa funzionalità è disponibile nel software AWS IoT Greengrass Core v1.11.0 ed è abilitata per impostazione predefinita per tutti i core Greengrass, inclusi i core esistenti. L'utente inizia automaticamente a ricevere dati non appena si esegue l'aggiornamento al software Core v1.11.0 o versione successiva AWS IoT Greengrass . Per informazioni su come accedere o gestire i dati di telemetria pubblicati, vedere. [Iscrizione per ricevere dati di telemetria](#subscribe-for-telemetry-data) L'agente di telemetria raccoglie e pubblica le seguenti metriche di sistema. **Metriche di telemetria** | Nome | Description | Origine | | --- | --- | --- | | `SystemMemUsage` | La quantità di memoria attualmente utilizzata da tutte le applicazioni sul dispositivo principale Greengrass, incluso il sistema operativo. | Sistema | | `CpuUsage` | La quantità di CPU attualmente utilizzata da tutte le applicazioni sul dispositivo principale Greengrass, incluso il sistema operativo. | Sistema | | `TotalNumberOfFDs` | Il numero di descrittori di file memorizzati dal sistema operativo del dispositivo principale Greengrass. Un descrittore di file identifica in modo univoco un file aperto. | Sistema | | `LambdaOutOfMemory` | Il numero di esecuzioni che determinano l'esaurimento della memoria della funzione Lambda. | Sistema | | `DroppedMessageCount` | Il numero di messaggi eliminati a cui sono destinati. AWS IoT Core | `GGCloudSpooler`componente di sistema | | `LambdaTimeout` | Il numero di timeout per l'esecuzione della funzione Lambda definita dall'utente. | Funzione Cloud AWS e sistema Lambda definiti dall'utente | | `LambdaUngracefullyKilled` | Il numero di esecuzioni che la funzione Lambda definita dall'utente non riesce a completare. | Funzione Cloud AWS e sistema Lambda definiti dall'utente | | `LambdaError` | Il numero di esecuzioni che determinano la scrittura dei log degli errori da parte della funzione Lambda definita dall'utente. | Funzione Cloud AWS e sistema Lambda definiti dall'utente | | `BytesAppended` | Il numero di byte di dati aggiunti allo stream manager. | `GGStreamManager`componente di sistema | | `BytesUploadedToIoTAnalytics` | Il numero di byte di dati che Stream Manager esporta nei canali in AWS IoT Analytics cui vengono esportati. | `GGStreamManager`componente di sistema | | `BytesUploadedToKinesis` | Il numero di byte di dati che Stream Manager esporta in flussi in Amazon Kinesis Data Streams. | `GGStreamManager`componente di sistema | | `BytesUploadedToIoTSiteWise` | Il numero di byte di dati in cui lo stream manager esporta nelle AWS IoT SiteWise proprietà degli asset. | `GGStreamManager`componente di sistema | | `BytesUploadedToS3ExportTaskExecutor` | Il numero di byte di dati che Stream Manager esporta in oggetti in Amazon S3. | `GGStreamManager`componente di sistema | | `BytesUploadedToHTTP` | Il numero di byte di dati che lo stream manager esporta in HTTP. | `GGStreamManager`componente di sistema | ## Configurazione delle impostazioni di telemetria La telemetria Greengrass utilizza le seguenti impostazioni: + L'agente di telemetria aggrega i dati di telemetria ogni ora. + L'agente di telemetria pubblica un messaggio di telemetria ogni 24 ore. **Nota** Le impostazioni sono immutabili. È possibile abilitare o disabilitare la funzione di telemetria per un dispositivo principale Greengrass. AWS IoT Greengrass utilizza le [ombre per gestire](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) la configurazione della telemetria. Le modifiche hanno effetto immediato quando il core è connesso a. AWS IoT Core L'agente di telemetria pubblica i dati utilizzando il protocollo MQTT con un livello di qualità del servizio (QoS) pari a 0. Ciò significa che non conferma la consegna né riprova i tentativi di pubblicazione. I messaggi di telemetria condividono una connessione MQTT con altri messaggi per gli abbonamenti a cui sono destinati. AWS IoT Core Oltre ai costi di collegamento dati, il trasferimento dei dati dal core all'altro è gratuito. AWS IoT Core Questo perché l'agente pubblica su un argomento AWS riservato. Tuttavia, a seconda del caso d'uso, potrebbero verificarsi dei costi quando si ricevono o si elaborano i dati. ### Requisiti Quando si configurano le impostazioni di telemetria, si applicano i seguenti requisiti: + È necessario utilizzare il software AWS IoT Greengrass Core v1.11.0 o versione successiva. **Nota** Se utilizzi una versione precedente e non desideri utilizzare la telemetria, non devi fare nulla. + È necessario fornire le autorizzazioni IAM per aggiornare il core (thing) shadow e chiamare la configurazione APIs prima di aggiornare le impostazioni di telemetria. Il seguente esempio di policy IAM consente di gestire la configurazione shadow e runtime di un core specifico: ------ #### [ 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" ] } ] } ``` ------ Puoi concedere un accesso granulare o condizionale alle risorse, ad esempio utilizzando uno schema di denominazione con caratteri jolly`*`. *Per ulteriori informazioni, consulta [Aggiungere e rimuovere le policy IAM nella IAM User](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) Guide.* ### Configura le impostazioni di telemetria (console) Di seguito viene illustrato come aggiornare le impostazioni di telemetria di un core Greengrass nella console. AWS IoT Greengrass 1. Nel riquadro di navigazione della AWS IoT console, in **Gestione**, espandi **i dispositivi Greengrass**, quindi scegli **Gruppi (V1**). 1. In **Gruppi Greengrass**, scegli il tuo gruppo target. 1. Nella pagina di configurazione del gruppo, nella sezione **Panoramica**, scegli il tuo core **Greengrass**. 1. Nella pagina di configurazione del core, scegli la scheda **Telemetria**. 1. **Nella sezione **Telemetria dello stato del sistema, scegli Configura**.** 1. In **Configura telemetria, seleziona Telemetria** per abilitare o disabilitare lo stato della telemetria. **Importante** Per impostazione predefinita, la funzionalità di telemetria è abilitata per il software Core v1.11.0 o versione successiva. AWS IoT Greengrass Le modifiche hanno effetto in fase di esecuzione. Non è necessario distribuire il gruppo. ### Configurazione delle impostazioni di telemetria (CLI) Nell' AWS IoT Greengrass API, l'`TelemetryConfiguration`oggetto rappresenta le impostazioni di telemetria di un core Greengrass. Questo oggetto fa parte dell'`RuntimeConfiguration`oggetto associato al core. Puoi utilizzare l' AWS IoT Greengrass API o l' AWS SDK per gestire la telemetria di Greengrass. AWS CLI Gli esempi in questa sezione utilizzano il. AWS CLI **Per controllare le impostazioni di telemetria** Il comando seguente ottiene le impostazioni di telemetria di un core Greengrass. + Sostituisci *core-thing-name* con il nome del core di destinazione. Per ottenere il nome della cosa, si usa il [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. Il comando restituisce l'ARN dell'oggetto che contiene il nome dell'oggetto. ``` aws greengrass get-thing-runtime-configuration --thing-name core-thing-name ``` Il comando restituisce un `GetCoreRuntimeConfigurationResponse` oggetto nella risposta JSON. Esempio: ``` { "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "OutOfSync", "Telemetry": "On" } } } ``` **Per configurare le impostazioni di telemetria** Il comando seguente aggiorna le impostazioni di telemetria per un core Greengrass. + Sostituisci *core-thing-name* con il nome del core di destinazione. Per ottenere il nome della cosa, si usa il [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. Il comando restituisce l'ARN dell'oggetto che contiene il nome dell'oggetto. ``` 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\"}}" ``` Le modifiche alle impostazioni di telemetria sono state applicate se lo è. `ConfigurationSyncStatus` `InSync` Le modifiche hanno effetto in fase di esecuzione. Non è necessario distribuire il gruppo. #### TelemetryConfiguration oggetto L'`TelemetryConfiguration`oggetto ha le seguenti proprietà: `ConfigurationSyncStatus` Verifica se le impostazioni di telemetria sono sincronizzate. È possibile che non sia possibile apportare modifiche a questa proprietà. Tipo: stringa Valori validi: `InSync` o `OutOfSync` `Telemetry` Attiva o disattiva la telemetria. Il valore predefinito è `On`. Tipo: stringa Valori validi: `On` o `Off` ## Iscrizione per ricevere dati di telemetria Puoi creare regole in Amazon EventBridge che definiscono come elaborare i dati di telemetria pubblicati dal dispositivo principale Greengrass. Quando EventBridge riceve i dati, richiama le azioni mirate definite nelle regole. Ad esempio, è possibile creare regole relative agli eventi che inviano notifiche, archiviano informazioni sugli eventi, intraprendono azioni correttive o richiamano altri eventi. ### Evento di telemetria L'evento per una modifica dello stato di distribuzione, inclusi i dati di telemetria, utilizza il formato seguente: ``` { "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" } ] } ] } } ``` L'`ADP`array contiene un elenco di punti dati aggregati con le seguenti proprietà: `TS` Obbligatorio. Il timestamp di quando i dati sono stati aggregati. `NS` Obbligatorio. Lo spazio dei nomi del sistema. `M` Obbligatorio. L'elenco delle metriche. Una metrica contiene le seguenti proprietà: `N` Il nome della [metrica](#telemetry-metrics). `Sum` Il valore metrico aggregato. L'agente di telemetria aggiunge nuovi valori al totale precedente, quindi la somma è un valore sempre crescente. È possibile utilizzare il timestamp per trovare il valore di un'aggregazione specifica. Ad esempio, per trovare l'ultimo valore aggregato, sottrai il valore con data e ora precedente dall'ultimo valore con data e ora. `U` L'unità del valore metrico. `ThingName` Obbligatorio. Il nome del dispositivo oggetto scelto come target. ### Prerequisiti per la creazione di regole EventBridge Prima di creare una EventBridge regola per AWS IoT Greengrass, è necessario effettuare le seguenti operazioni: + Acquisisci familiarità con eventi, regole e obiettivi in. EventBridge + Crea e configura gli [obiettivi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html) richiamati dalle tue regole. EventBridge Le regole possono richiamare molti tipi di destinazioni, ad esempio stream Amazon Kinesis, funzioni AWS Lambda , argomenti Amazon SNS e code Amazon SQS. La tua EventBridge regola e gli obiettivi associati devono trovarsi nello stesso luogo in Regione AWS cui hai creato le tue risorse Greengrass. Per ulteriori informazioni, consulta [Service endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) in. *Riferimenti generali di AWS* Per ulteriori informazioni, consulta [What is Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) e [Guida introduttiva ad Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) nella *Amazon EventBridge User Guide*. ### Crea una regola di evento per ottenere dati di telemetria (console) Utilizza i seguenti passaggi per Console di gestione AWS creare una EventBridge regola che riceva i dati di telemetria pubblicati dal core Greengrass. Ciò consente a server Web, indirizzi e-mail e altri sottoscrittori di argomenti di rispondere all'evento. Per ulteriori informazioni, consulta [Creazione di una EventBridge regola che si attiva su un evento da una AWS risorsa](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) nella *Amazon EventBridge User Guide*. 1. Apri la [ EventBridgeconsole Amazon](https://console.aws.amazon.com/events/) e scegli **Crea regola**. 1. In **Nome e descrizione**, immettere un nome e una descrizione per la regola. 1. Scegli **Event bus** e abilita la regola sul bus di eventi selezionato. 1. Seleziona il **tipo di regola** e scegli **Regola con uno schema di eventi**. 1. Scegli **Next (Successivo)**. 1. Per **Origine dell'evento**, scegli **AWS eventi o eventi EventBridge partner**. 1. Per **Evento di esempio**, scegli **AWS eventi** e seleziona **Greengrass Telemetry** Data. 1. In **Event pattern, effettuate** le seguenti selezioni: 1. Per **Origine evento**, scegli **Servizi AWS **. 1. Per l'**AWS assistenza**, scegli **Greengrass**. 1. Per **Tipo di evento**, scegli **Greengrass Telemetry** Data. 1. Scegli **Next (Successivo)**. 1. **Per **Target 1**, scegli il servizio.AWS ** 1. Per **Seleziona una destinazione**, scegli la **coda SQS.** 1. Per **Queue**, scegli la tua funzione. ### Crea una regola di evento per ottenere dati di telemetria (CLI) Utilizza i seguenti passaggi per AWS CLI creare una EventBridge regola che riceva i dati di telemetria pubblicati dal core Greengrass. Ciò consente a server Web, indirizzi e-mail e altri sottoscrittori di argomenti di rispondere all'evento. 1. Crea la regola. + Sostituisci *thing-name* con il nome dell'oggetto del core. Per ottenere il nome della cosa, si usa il [get-core-definition-version](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-core-definition-version.html)comando. Il comando restituisce l'ARN dell'oggetto che contiene il nome dell'oggetto. ``` aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"ThingName\": [\"thing-name\"]}}" ``` Le proprietà omesse dal modello vengono ignorate. 1. Aggiungi l'argomento come destinazione della regola. L'esempio seguente utilizza Amazon SQS ma puoi configurare altri tipi di destinazione. + Sostituisci *queue-arn* con l'ARN della tua coda Amazon SQS. ``` aws events put-targets \ --rule TestRule \ --targets "Id"="1","Arn"="queue-arn" ``` **Nota** Per consentire EventBridge ad Amazon di richiamare la tua coda di destinazione, devi aggiungere una politica basata sulle risorse all'argomento. Per ulteriori informazioni, consulta le [autorizzazioni di Amazon SQS](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sqs-permissions) nella *Amazon EventBridge * User Guide. Per ulteriori informazioni, consulta la sezione [Eventi e modelli di eventi EventBridge nella](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) *Amazon EventBridge User Guide*. ## Risoluzione dei problemi di AWS IoT Greengrass telemetria Utilizza le seguenti informazioni per risolvere i problemi relativi alla configurazione della telemetria. AWS IoT Greengrass ### Errore: la risposta contiene "ConfigurationStatus«:" "dopo l'esecuzione del comando OutOfSync get-thing-runtime-configuration **Soluzioni:** + Il servizio AWS IoT Device Shadow richiede tempo per elaborare gli aggiornamenti della configurazione di runtime e per fornire gli aggiornamenti al dispositivo principale Greengrass. Potresti attendere e verificare se le impostazioni di telemetria sono sincronizzate in un secondo momento. + Assicurati che il tuo dispositivo principale sia online. + Abilita [Amazon CloudWatch Logs in AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html#viewing-logs) per monitorare lo shadow. + Usa le [AWS IoT metriche](https://docs.aws.amazon.com/iot/latest/developerguide/monitoring-cloudwatch.html) per monitorare le tue attività.