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à.
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 una varietà di fonti, come i dispositivi principali Greengrass e le notifiche di distribuzione. Per ulteriori informazioni, consulta What is Amazon EventBridge? 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, consulta. Iscrizione per ricevere dati di telemetria
L'agente di telemetria raccoglie e pubblica le seguenti metriche di sistema.
| Nome | Descrizione | Origine |
|---|---|---|
|
|
La quantità di memoria attualmente utilizzata da tutte le applicazioni sul dispositivo principale Greengrass, incluso il sistema operativo. |
System (Sistema) |
|
|
La quantità di CPU attualmente utilizzata da tutte le applicazioni sul dispositivo principale Greengrass, incluso il sistema operativo. |
System (Sistema) |
|
|
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. |
System (Sistema) |
|
|
Il numero di esecuzioni che determinano l'esaurimento della memoria della funzione Lambda. |
System (Sistema) |
|
|
Il numero di messaggi eliminati a cui sono destinati. AWS IoT Core |
|
|
|
Il numero di timeout per l'esecuzione della funzione Lambda definita dall'utente. |
Funzione Cloud AWS e sistema Lambda definiti dall'utente |
|
|
Il numero di esecuzioni che la funzione Lambda definita dall'utente non riesce a completare. |
Funzione Cloud AWS e sistema Lambda definiti dall'utente |
|
|
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 |
|
|
Il numero di byte di dati aggiunti allo stream manager. |
|
|
|
Il numero di byte di dati che Stream Manager esporta nei canali in AWS IoT Analytics cui vengono esportati. |
|
|
|
Il numero di byte di dati che Stream Manager esporta in flussi in Amazon Kinesis Data Streams. |
|
|
|
Il numero di byte di dati in cui lo stream manager esporta nelle AWS IoT SiteWise proprietà degli asset. |
|
|
|
Il numero di byte di dati che Stream Manager esporta in oggetti in Amazon S3. |
|
|
|
Il numero di byte di dati che lo stream manager esporta in HTTP. |
|
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 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:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowManageShadow", "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow", "iot:DescribeThing" ], "Resource": [ "arn:aws:iot:region:account-id:thing/core-name-*" ] }, { "Sid": "AllowManageRuntimeConfig", "Effect": "Allow", "Action": [ "greengrass:GetCoreRuntimeConfiguration", "greengrass:UpdateCoreRuntimeConfiguration" ], "Resource": [ "arn:aws:iot:region:account-id:thing/core-name" ] } ] }È possibile 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 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
-
Nel riquadro di navigazione della AWS IoT console, in Gestione, espandi i dispositivi Greengrass, quindi scegli Gruppi (V1).
-
In Gruppi Greengrass, scegli il tuo gruppo target.
-
Nella pagina di configurazione del gruppo, nella sezione Panoramica, scegli il tuo core Greengrass.
-
Nella pagina di configurazione del core, scegli la scheda Telemetria.
-
Nella sezione Telemetria dello stato del sistema, scegli Configura.
-
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'TelemetryConfigurationoggetto rappresenta le impostazioni di telemetria di un core Greengrass. Questo oggetto fa parte dell'RuntimeConfigurationoggetto 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-namecon il nome del core di destinazione.Per ottenere il nome della cosa, si usa il get-core-definition-versioncomando. Il comando restituisce l'ARN dell'oggetto che contiene il nome dell'oggetto.
aws greengrass get-thing-runtime-configuration --thing-namecore-thing-nameIl comando restituisce un
GetCoreRuntimeConfigurationResponseoggetto nella risposta JSON. Per 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-namecon il nome del core di destinazione.Per ottenere il nome della cosa, si usa il get-core-definition-versioncomando. Il comando restituisce l'ARN dell'oggetto che contiene il nome dell'oggetto.
aws greengrass update-thing-runtime-configuration --thing-namecore-thing-name--telemetry-configuration '{ "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "InSync", "Telemetry": "Off" } } }Le modifiche alle impostazioni di telemetria sono state applicate se lo è.
ConfigurationSyncStatusInSyncLe modifiche hanno effetto in fase di esecuzione. Non è necessario distribuire il gruppo. -
TelemetryConfiguration oggetto
L'TelemetryConfigurationoggetto 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:
InSyncoOutOfSync
Telemetry-
Attiva o disattiva la telemetria. Il valore predefinito è
On.Tipo: stringa
Valori validi:
OnoOff
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'ADParray 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.
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 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 in. Riferimenti generali di AWS
Per ulteriori informazioni, consulta What is 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 per AWS Management Console 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 nella Amazon EventBridge User Guide.
-
Apri la EventBridgeconsole Amazon
e scegli Crea regola. -
In Nome e descrizione, immettere un nome e una descrizione per la regola.
-
Scegli Event bus e abilita la regola sul bus di eventi selezionato.
-
Seleziona il tipo di regola e scegli Regola con uno schema di eventi.
-
Scegli Next (Successivo).
-
Per Origine dell'evento, scegli AWS eventi o eventi EventBridge partner.
-
Per Evento di esempio, scegli AWS eventi e seleziona Greengrass Telemetry Data.
-
In Event pattern, effettuate le seguenti selezioni:
-
Per Origine evento, scegli Servizi AWS .
-
Per l'AWS assistenza, scegli Greengrass.
-
Per Tipo di evento, scegli Greengrass Telemetry Data.
-
-
Scegli Next (Successivo).
-
Per Target 1, scegli il servizio.AWS
-
Per Seleziona una destinazione, scegli la coda SQS.
-
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.
-
Crea la regola.
-
thing-nameSostituiscilo con il nome dell'oggetto del core.Per ottenere il nome della cosa, si usa il get-core-definition-versioncomando. 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.
-
-
Aggiungi l'argomento come destinazione della regola. L'esempio seguente utilizza Amazon SQS ma puoi configurare altri tipi di destinazione.
-
Sostituisci
queue-arncon 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 nella Amazon EventBridge User Guide.
-
Per ulteriori informazioni, consulta la sezione Eventi e modelli di eventi EventBridge nella 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 per monitorare lo shadow.
-
Usa le AWS IoT metriche per monitorare le tue attività.
