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à.

Raccogli 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. È possibile creare progetti e applicazioni per recuperare, analizzare, trasformare e generare report sui dati di telemetria dai 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 del software AWS IoT Greengrass Core, 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 Greengrassconserva i dati di telemetria per un massimo di sette giorni.

Questa sezione descrive come configurare e utilizzare l'agente di telemetria. Per informazioni sulla configurazione del componente dell'emettitore di telemetria Nucleus, vedere. Emettitore di telemetria Nucleus

Metriche di telemetria

La tabella seguente descrive le metriche pubblicate dall'agente di telemetria.

Configura le impostazioni dell'agente di telemetria

L'agente di telemetria pubblica i dati utilizzando il protocollo MQTT con un livello di qualità del servizio (QoS) pari a 0, il che 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 del 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.

È possibile abilitare o disabilitare la funzionalità dell'agente di telemetria per ogni dispositivo principale Greengrass. È inoltre possibile configurare gli intervalli in base ai quali il dispositivo principale aggrega e pubblica i dati. Per configurare la telemetria, personalizza il parametro di configurazione della telemetria quando distribuisci il componente Greengrass nucleus.

Iscriviti ai dati di telemetria in EventBridge

Puoi creare regole in Amazon EventBridge che definiscono come elaborare i dati di telemetria pubblicati dall'agente di telemetria sul 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.

Eventi di telemetria

Gli eventi di telemetria utilizzano il formato seguente.

{
  "version": "0",
  "id": "a09d303e-2f6e-3d3c-a693-8e33f4fe3955",
  "detail-type": "Greengrass Telemetry Data",
  "source": "aws.greengrass",
  "account": "123456789012",
  "time": "2020-11-30T20:45:53Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "ThingName": "MyGreengrassCore",
    "Schema": "2020-07-30",
    "ADP": [
      {
        "TS": 1602186483234,
        "NS": "SystemMetrics",
        "M": [
          {
            "N": "TotalNumberOfFDs",
            "Sum": 6447.0,
            "U": "Count"
          },
          {
            "N": "CpuUsage",
            "Sum": 15.458333333333332,
            "U": "Percent"
          },
          {
            "N": "SystemMemUsage",
            "Sum": 10201.0,
            "U": "Megabytes"
          }
        ]
      },
      {
        "TS": 1602186483234,
        "NS": "GreengrassComponents",
        "M": [
          {
            "N": "NumberOfComponentsStopping",
            "Sum": 0.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsStarting",
            "Sum": 0.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsBroken",
            "Sum": 0.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsFinished",
            "Sum": 1.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsInstalled",
            "Sum": 0.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsRunning",
            "Sum": 7.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsNew",
            "Sum": 0.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsErrored",
            "Sum": 0.0,
            "U": "Count"
          },
          {
            "N": "NumberOfComponentsStateless",
            "Sum": 0.0,
            "U": "Count"
          }
        ]
      },
      {
        "TS": 1602186483234,
        "NS": "aws.greengrass.ClientDeviceAuth",
        "M": [
          {
            "N": "VerifyClientDeviceIdentity.Success",
            "Sum": 3.0,
            "U": "Count"
          },
          {
            "N": "VerifyClientDeviceIdentity.Failure",
            "Sum": 1.0,
            "U": "Count"
          },
          {
            "N": "AuthorizeClientDeviceActions.Success",
            "Sum": 20.0,
            "U": "Count"
          },
          {
            "N": "AuthorizeClientDeviceActions.Failure",
            "Sum": 5.0,
            "U": "Count"
          },
          {
            "N": "GetClientDeviceAuthToken.Success",
            "Sum": 5.0,
            "U": "Count"
          },
          {
            "N": "GetClientDeviceAuthToken.Failure",
            "Sum": 2.0,
            "U": "Count"
          },
          {
            "N": "SubscribeToCertificateUpdates.Success",
            "Sum": 10.0,
            "U": "Count"
          },
          {
            "N": "SubscribeToCertificateUpdates.Failure",
            "Sum": 1.0,
            "U": "Count"
          },
          {
            "N": "ServiceError",
            "Sum": 3.0,
            "U": "Count"
          }
        ]
      },
      {
        "TS": 1602186483234,
        "NS": "aws.greengrass.StreamManager",
        "M": [
          {
            "N": "BytesAppended",
            "Sum": 157745524.0,
            "U": "Bytes"
          },
          {
            "N": "BytesUploadedToIoTAnalytics",
            "Sum": 149012.0,
            "U": "Bytes"
          },
          {
            "N": "BytesUploadedToKinesis",
            "Sum": 12192.0,
            "U": "Bytes"
          },
          {
            "N": "BytesUploadedToIoTSiteWise",
            "Sum": 13321.0,
            "U": "Bytes"
          },
          {
            "N": "BytesUploadedToS3",
            "Sum": 12213.0,
            "U": "Bytes"
          }
        ]
      }
    ]
  }
}

Per ulteriori informazioni su ciascuna metrica, consulta. Metriche di telemetria

Prerequisiti per creare regole EventBridge

Prima di creare una EventBridge regola perAWS IoT Greengrass, è necessario effettuare le seguenti operazioni:

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 dispositivo principale 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.

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 dai dispositivi principali di Greengrass. Ciò consente a server Web, indirizzi e-mail e altri sottoscrittori di argomenti di rispondere all'evento.

Per ulteriori informazioni, consulta la sezione Eventi e modelli di eventi EventBridge nella Amazon EventBridge User Guide.