AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

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 sullo stato del sistema dai dispositiviAWS IoT Greengrass principali

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 i dati di telemetria locali e li pubblica su Amazon EventBridge senza richiedere alcuna interazione con il cliente. I dispositivi principali pubblicano i dati di telemetria EventBridge sulla base del miglior tentativo. Ad esempio, i dispositivi principali potrebbero non riuscire a fornire dati di telemetria in modalità offline.

Puoi creare progetti e applicazioni per recuperare, analizzare, trasformare e riportare i 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 perimetrali Greengrass,AWS IoT Greengrass utilizza i dati per scopi di sviluppo e miglioramento della qualità. Questa funzionalità aiuta anche a fornire nuove e migliorate funzionalità edge. AWS IoT Greengrassconserva i dati di telemetria per un massimo di sette giorni.

Questa funzionalità è disponibile nel softwareAWS IoT Greengrass Core v1.11.0 ed è abilitata di default per tutti i core Greengrass, inclusi i core esistenti. Si inizia a ricevere dati automaticamente non appena si esegue l'aggiornamento al softwareAWS IoT Greengrass Core v1.11.0 o successivo.

Per informazioni su come accedere ai dati di telemetria pubblicati, consultaSottoscrizione ai dati di telemetria.

L'agente di telemetria raccoglie e pubblica le seguenti metriche di sistema.

Configurazione delle impostazioni di telemetria

La telemetria Greengrass utilizza le seguenti impostazioni:

Puoi abilitare o disabilitare la funzionalità di telemetria per un dispositivo core Greengrass. AWS IoT Greengrassutilizza le ombre per gestire la configurazione della telemetria. Le modifiche hanno effetto immediato quando il core è connesso aAWS 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é ritenta i tentativi di pubblicazione. I messaggi di telemetria condividono una connessione MQTT con altri messaggi per gli abbonamenti destinati aAWS IoT Core.

A parte i costi di collegamento dati, il trasferimento dei dati dal core alAWS IoT Core server è gratuito. Questo perché l'agente pubblica su un argomentoAWS riservato. Tuttavia, a seconda del caso d'uso, potresti instrada i costi quando ricevi o instrada i dati nelle destinazioni come.

Requisiti

Quando si configurano le impostazioni di telemetria, si applicano i seguenti requisiti:

Configurare le impostazioni di telemetria (console)) (console))

Quanto segue mostra come aggiornare le impostazioni di telemetria di un core Greengrass nellaAWS IoT Greengrass console.

Le modifiche diventano diventano diventano diventano diventano diventano diventano diventano diventano diventano diventano diventano diventano Non è necessario distribuire il gruppo.

Configurazione delle impostazioni di telemetria (CLI)

Nell'AWS IoT GreengrassAPI, l'TelemetryConfigurationoggetto rappresenta le impostazioni di telemetria di un core Greengrass. Questo oggetto fa parte dell'RuntimeConfigurationoggetto associato al nucleo. Puoi utilizzare l'AWS IoT GreengrassAPI o l'AWSSDK per gestire la telemetria di Greengrass.AWS CLI Gli esempi in questa sezione utilizzano ilAWS CLI.

TelemetryConfiguration oggetto

L'TelemetryConfigurationoggetto ha le seguenti proprietà:

Sottoscrizione ai dati di telemetria

Puoi creare regole in Amazon EventBridge che definiscono come elaborare i dati di telemetria pubblicati dal dispositivo principale di Greengrass. Quando EventBridge riceve i dati, invoca le operazioni di destinazione definite nelle regole. Ad esempio, puoi creare regole di eventi per inviare notifiche, archiviare informazioni sugli eventi, eseguire un'operazione correttiva o invocano altri eventi.

Evento di telemetria

L'evento per una modifica dello stato di distribuzione, inclusi i dati di telemetria, utilizza il seguente 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"
                    }
                ]
            }
        ]
    }
}

L'ADParray contiene un elenco di punti dati aggregati con le seguenti proprietà:

Prerequisiti per la creazione di EventBridge regole

Prima di creare una EventBridge regola perAWS IoT Greengrass, dovresti assicurarti di:

Per ulteriori informazioni, consulta Che cos'è Amazon EventBridge? e Guida introduttiva ad Amazon EventBridge nella Amazon EventBridge User Guide.

Crea una regola di evento per ottenere dati di telemetria (console)

Utilizza i seguenti passaggi perAWS Management Console creare una EventBridge regola che riceva i dati di telemetria pubblicati dal core di 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 unaAWS risorsa nella Guida per l' EventBridge utente di Amazon.

Crea una regola di evento per ottenere dati di telemetria (CLI)

Utilizza i seguenti passaggi perAWS CLI creare una EventBridge regola che riceva i dati di telemetria pubblicati dal core di Greengrass. Ciò consente a server Web, indirizzi e-mail e altri sottoscrittori di argomenti di rispondere all'evento.

Per ulteriori informazioni, consulta Eventi e modelli di eventi EventBridge nella Guida per l' EventBridge utente di Amazon.

Risoluzione dei problemi diAWS IoT Greengrass telemetria

Utilizza le informazioni seguenti per risolvere i problemi relativi alla configurazione dellaAWS IoT Greengrass telemetria.

Errore: la risposta contiene "ConfigurationStatus«:"OutOfSync "dopo l'esecuzione del get-thing-runtime-configuration comando

Soluzioni: