CloudWatch metriche - AWS IoT Greengrass

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

CloudWatch metriche

Il componente Amazon CloudWatch metrics (aws.greengrass.Cloudwatch) pubblica metriche personalizzate dai dispositivi core Greengrass su Amazon. CloudWatch Il componente consente ai componenti di pubblicare CloudWatch metriche, che possono essere utilizzate per monitorare e analizzare l'ambiente del dispositivo principale Greengrass. Per ulteriori informazioni, consulta Using Amazon CloudWatch metrics nella Amazon CloudWatch User Guide.

Per pubblicare una CloudWatch metrica con questo componente, pubblica un messaggio su un argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente sottoscrive l'argomento di pubblicazione/sottoscrizione cloudwatch/metric/put locale. È possibile specificare altri argomenti, inclusi gli AWS IoT Core MQTT argomenti, quando si distribuisce questo componente.

Questo componente raggruppa in batch le metriche che si trovano nello stesso spazio dei nomi e le pubblica a intervalli regolari. CloudWatch

Nota

Questo componente offre funzionalità simili al connettore Metrics in V1. CloudWatch AWS IoT Greengrass Per ulteriori informazioni, consulta CloudWatch Metrics Connector nella AWS IoT Greengrass V1 Developer Guide.

Versioni

Questo componente ha le seguenti versioni:

  • 3.1.x

  • 3.0.x

  • 2.1.x

  • 2,0x

Per informazioni sulle modifiche apportate a ciascuna versione del componente, consulta il changelog.

Type

v3.x

Questo componente è un componente generico () aws.greengrass.generic. Il nucleo Greengrass esegue gli script del ciclo di vita del componente.

v2.x

Questo componente è un componente Lambda () aws.greengrass.lambda. Il nucleo Greengrass esegue la funzione Lambda di questo componente utilizzando il componente di avvio Lambda.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

v3.x

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

v2.x

Questo componente può essere installato solo sui dispositivi principali di Linux.

Requisiti

Questo componente ha i seguenti requisiti:

3.x
  • Python versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente. PATH

  • Il ruolo del dispositivo Greengrass deve consentire l'cloudwatch:PutMetricDataazione, come illustrato nella politica di esempio IAM seguente.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }

    Per ulteriori informazioni, consulta il riferimento CloudWatch alle autorizzazioni di Amazon nella Amazon CloudWatch User Guide.

2.x
  • Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta Requisiti della funzione Lambda.

  • Python versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente. PATH

  • Il ruolo del dispositivo Greengrass deve consentire l'cloudwatch:PutMetricDataazione, come illustrato nella politica di esempio IAM seguente.

    { "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudwatch:PutMetricData" ], "Effect": "Allow", "Resource": "*" } ] }

    Per ulteriori informazioni, consulta il riferimento CloudWatch alle autorizzazioni di Amazon nella Amazon CloudWatch User Guide.

  • Per ricevere i dati di output da questo componente, devi unire il seguente aggiornamento di configurazione per il componente legacy del router di abbonamento (aws.greengrass.LegacySubscriptionRouter) quando distribuisci questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

    Legacy subscription router v2.1.xLegacy subscription router v2.0.x
    Legacy subscription router v2.1.x
    { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "component:aws.greengrass.Cloudwatch", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } }
    Legacy subscription router v2.0.x
    { "subscriptions": { "aws-greengrass-cloudwatch": { "id": "aws-greengrass-cloudwatch", "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version", "subject": "cloudwatch/metric/put/status", "target": "cloud" } } }
    • Replace (Sostituisci) region con quello Regione AWS che usi.

    • Replace (Sostituisci) version con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella AWS IoT Greengrass console e cerca la coppia chiave-valore della funzione Lambda. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

    Importante

    È necessario aggiornare la versione della funzione Lambda sul router di sottoscrizione legacy ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione corretta della funzione Lambda per la versione del componente che si distribuisce.

    Per ulteriori informazioni, consulta Creare distribuzione.

Endpoint e porte

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Endpoint Porta Richiesto Descrizione

monitoring.region.amazonaws.com

443

Metriche di caricamento. CloudWatch

Dipendenze

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

3.0.0 - 3.1.0

La tabella seguente elenca le dipendenze per le versioni da 3.0.0 a 3.1.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <3.0.0 Flessibili
Servizio di scambio di token >=0.0.0 Rigidi
2.1.4 - 2.1.8

La tabella seguente elenca le dipendenze per le versioni 2.1.4 e 2.1.8 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <3.0.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.1.2 - 2.1.3

La tabella seguente elenca le dipendenze per le versioni 2.1.2 e 2.1.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.8.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.1.1

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.7.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.0.8 - 2.1.0

La tabella seguente elenca le dipendenze per le versioni da 2.0.8 a 2.1.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.6.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.0.7

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.5.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.0.6

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.4.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.0.5

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.3.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.0.4

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.0 <2.2.0 Rigidi
Lanciatore Lambda ^2.0.0 Rigidi
Runtime Lambda ^2,0,0 Flessibili
Servizio di scambio di token ^2.0.0 Rigidi
2.0.3

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.3 <2.1.0 Rigidi
Lanciatore Lambda >=1.0.0 Rigidi
Runtime Lambda >=1.0.0 Flessibili
Servizio di scambio di token >=1.0.0 Rigidi

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

v3.x
PublishInterval

(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi le metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, ovvero senza raggruppamento in batch, specificate. 0

Il componente viene pubblicato CloudWatch dopo aver ricevuto 20 metriche nello stesso spazio dei nomi o dopo l'intervallo specificato.

Nota

Il componente non specifica l'ordine di pubblicazione degli eventi.

Questo valore può essere al massimo di 900 secondi.

Impostazione predefinita: 10 secondi

MaxMetricsToRetain

(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.

Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato spazio dei nomi sostituiscono solo le metriche nello stesso spazio dei nomi.

Nota

Se il processo host per il componente viene interrotto, il componente non salva le metriche. Ciò può accadere, ad esempio, durante una distribuzione o al riavvio del dispositivo principale.

Questo valore deve essere almeno 2.000 parametri.

Impostazione predefinita: 5.000 metriche

InputTopic

(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica true forPubSubToIoTCore, è possibile utilizzare i caratteri MQTT jolly (+ e #) in questo argomento.

Impostazione predefinita: cloudwatch/metric/put

OutputTopic

(Facoltativo) L'argomento in cui il componente pubblica le risposte sullo stato.

Impostazione predefinita: cloudwatch/metric/put/status

PubSubToIoTCore

(Facoltativo) Valore di stringa che definisce se pubblicare e sottoscrivere AWS IoT Core MQTT gli argomenti. I valori supportati sono true e false.

Impostazione predefinita: false

UseInstaller

(Facoltativo) Valore booleano che definisce se utilizzare lo script di installazione in questo componente per installare le dipendenze di questo componente. SDK

Imposta questo valore su false se desideri utilizzare uno script personalizzato per installare le dipendenze o se desideri includere le dipendenze di runtime in un'immagine Linux predefinita. Per utilizzare questo componente, è necessario installare le seguenti librerie, comprese le eventuali dipendenze, e renderle disponibili all'utente predefinito del sistema Greengrass.

Impostazione predefinita: true

PublishRegion

(Facoltativo) L'oggetto Regione AWS su cui pubblicare CloudWatch le metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

accessControl

(Facoltativo) L'oggetto che contiene la politica di autorizzazione che consente al componente di pubblicare e sottoscrivere gli argomenti specificati. Se si specificano valori personalizzati per InputTopic eOutputTopic, è necessario aggiornare i valori delle risorse in questo oggetto.

Impostazione predefinita:

{ "aws.greengrass.ipc.pubsub": { "aws.greengrass.Cloudwatch:pubsub:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToTopic" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:pubsub:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToTopic" ], "resources": [ "cloudwatch/metric/put/status" ] } }, "aws.greengrass.ipc.mqttproxy": { "aws.greengrass.Cloudwatch:mqttproxy:1": { "policyDescription": "Allows access to subscribe to input topics.", "operations": [ "aws.greengrass#SubscribeToIoTCore" ], "resources": [ "cloudwatch/metric/put" ] }, "aws.greengrass.Cloudwatch:mqttproxy:2": { "policyDescription": "Allows access to publish to output topics.", "operations": [ "aws.greengrass#PublishToIoTCore" ], "resources": [ "cloudwatch/metric/put/status" ] } } }
Esempio: fusione e aggiornamento della configurazione
{ "PublishInterval": 0, "PubSubToIoTCore": true }
v2.x
Nota

La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

lambdaParams

Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:

EnvironmentVariables

Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:

PUBLISH_INTERVAL

(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi le metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, ovvero senza raggruppamento in batch, specificate. 0

Il componente viene pubblicato CloudWatch dopo aver ricevuto 20 metriche nello stesso spazio dei nomi o dopo l'intervallo specificato.

Nota

Il componente non garantisce l'ordine di pubblicazione degli eventi.

Questo valore può essere al massimo di 900 secondi.

Impostazione predefinita: 10 secondi

MAX_METRICS_TO_RETAIN

(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.

Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato spazio dei nomi sostituiscono solo le metriche nello stesso spazio dei nomi.

Nota

Se il processo host per il componente viene interrotto, il componente non salva le metriche. Ciò può accadere, ad esempio, durante una distribuzione o al riavvio del dispositivo principale.

Questo valore deve essere di almeno 2.000 parametri.

Impostazione predefinita: 5.000 metriche

PUBLISH_REGION

(Facoltativo) L'oggetto Regione AWS su cui pubblicare le CloudWatch metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

containerMode

(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:

  • NoContainer— Il componente non viene eseguito in un ambiente di runtime isolato.

  • GreengrassContainer— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.

Impostazione predefinita: GreengrassContainer

containerParams

(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se si specifica GreengrassContainer percontainerMode.

Questo oggetto contiene le seguenti informazioni:

memorySize

(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.

Il valore predefinito è 64 MB (65.535 KB).

pubsubTopics

(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente sottoscrive la sottoscrizione per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive gli argomenti AWS IoT Core o gli MQTT argomenti di pubblicazione/sottoscrizione locali.

Questo oggetto contiene le seguenti informazioni:

0— Si tratta di un indice di matrice sotto forma di stringa.

Un oggetto che contiene le seguenti informazioni:

type

(Facoltativo) Il tipo di messaggi di pubblicazione/sottoscrizione utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:

  • PUB_SUB: iscriviti ai messaggi di pubblicazione/sottoscrizione locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly. MQTT Per ulteriori informazioni su come inviare messaggi dal componente personalizzato quando si specifica questa opzione, vederePubblicare/sottoscrivere messaggi locali.

  • IOT_CORE— AWS IoT Core MQTT Sottoscrivi ai messaggi. Se scegli questa opzione, l'argomento può contenere caratteri MQTT jolly. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedereAWS IoT Core MQTTPubblicare/sottoscrivere messaggi.

Impostazione predefinita: PUB_SUB

topic

(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica IotCore fortype, è possibile utilizzare i caratteri MQTT jolly (+e#) in questo argomento.

Esempio: aggiornamento basato sull'unione della configurazione (modalità contenitore)
{ "containerMode": "GreengrassContainer" }
Esempio: aggiornamento tramite fusione della configurazione (nessuna modalità contenitore)
{ "containerMode": "NoContainer" }

Dati di input

Questo componente accetta le metriche sul seguente argomento e le pubblica su. CloudWatch Per impostazione predefinita, questo componente sottoscrive i messaggi di pubblicazione/sottoscrizione locali. Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, consulta. Pubblicare/sottoscrivere messaggi locali

A partire dalla versione del componente v3.0.0, puoi facoltativamente configurare questo componente per la sottoscrizione a un MQTT argomento impostando il PubSubToIoTCore parametro di configurazione su. true Per ulteriori informazioni sulla pubblicazione di messaggi relativi a un MQTT argomento nei componenti personalizzati, consulta. AWS IoT Core MQTTPubblicare/sottoscrivere messaggi

Argomento predefinito: cloudwatch/metric/put

Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in JSON formato.

request

La metrica in questo messaggio.

L'oggetto della richiesta contiene i dati metrici su cui pubblicare. CloudWatch I valori delle metriche devono soddisfare le specifiche dell'PutMetricDataoperazione.

Tipo: object che contiene le seguenti informazioni:

namespace

Lo spazio dei nomi definito dall'utente per i dati metrici in questa richiesta. CloudWatch utilizza i namespace come contenitori per i punti dati metrici.

Nota

Non è possibile specificare uno spazio dei nomi che inizi con la stringa riservata. AWS/

Tipo: string

Modello valido: [^:].*

metricData

I dati del parametro.

Tipo: object che contiene le seguenti informazioni:

metricName

Nome del parametro.

Tipo: string

value

Il valore del parametro.

Nota

CloudWatch rifiuta valori troppo piccoli o troppo grandi. Il valore deve essere compreso tra 8.515920e-109 e 1.174271e+108 (Base 10) o 2e-360 e 2e360 (Base 2). CloudWatch non supporta valori speciali come NaN+Infinity, e-Infinity.

Tipo: double

dimensions

(Facoltativo) Le dimensioni della metrica. Le dimensioni forniscono ulteriori informazioni sul parametro e sui relativi dati. Un parametro è in grado di definire fino a 10 dimensioni.

Questo componente include automaticamente una dimensione denominatacoreName, dove il valore è il nome del dispositivo principale.

Tipo: array di oggetti che contengono ciascuno le seguenti informazioni:

name

(Facoltativo) Il nome della dimensione.

Tipo: string

value

(Facoltativo) Il valore della dimensione.

Tipo: string

timestamp

(Facoltativo) L'ora in cui sono stati ricevuti i dati metrici, espressa in secondi nell'epoca Unix.

Il valore predefinito è l'ora in cui il componente riceve il messaggio.

Tipo: double

Nota

Se utilizzi tra le versioni 2.0.3 e 2.0.7 di questo componente, ti consigliamo di recuperare il timestamp separatamente per ogni metrica quando invii più metriche da un'unica fonte. Non utilizzare una variabile per memorizzare il timestamp.

unit

(Facoltativo) L'unità della metrica.

Tipo: string

Valori validi: SecondsMicroseconds,Milliseconds,Bytes,Kilobytes,Megabytes,Gigabytes,Terabytes,Bits,Kilobits,Megabits,,Gigabits,Terabits,Percent,Count,Bytes/Second,Kilobytes/Second,Megabytes/Second,Gigabytes/Second,Terabytes/Second,Bits/Second,Kilobits/Second,Megabits/Second,Gigabits/Second,Terabits/Second, Count/Second None

L'impostazione predefinita è None.

Nota

Tutte le quote che si applicano a si CloudWatch PutMetricData API applicano alle metriche pubblicate con questo componente. Le seguenti quote sono particolarmente importanti:

  • Limite di 40 KB per il payload API

  • 20 parametri per richiesta API

  • 150 transazioni al secondo (TPS) per PutMetricData API

Per ulteriori informazioni, consulta le quote CloudWatch di servizio nella Guida per l'CloudWatch utente.

Esempio Input di esempio
{ "request": { "namespace": "Greengrass", "metricData": { "metricName": "latency", "dimensions": [ { "name": "hostname", "value": "test_hostname" } ], "timestamp": 1539027324, "value": 123.0, "unit": "Seconds" } } }

Dati di output

Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente argomento di pubblicazione/sottoscrizione locale. Per ulteriori informazioni su come sottoscrivere i messaggi relativi a questo argomento nei componenti personalizzati, consulta. Pubblicare/sottoscrivere messaggi locali

Facoltativamente, puoi configurare questo componente per la pubblicazione su un MQTT argomento impostando il parametro di PubSubToIoTCore configurazione sutrue. Per ulteriori informazioni sulla sottoscrizione ai messaggi relativi a un MQTT argomento nei componenti personalizzati, consulta. AWS IoT Core MQTTPubblicare/sottoscrivere messaggi

Nota

Per impostazione predefinita, le versioni dei componenti 2.0.x pubblicano le risposte come dati di output su un MQTT argomento. È necessario specificare l'argomento come contenuto subject nella configurazione del componente legacy del router di abbonamento.

Argomento predefinito: cloudwatch/metric/put/status

Esempio Output di esempio: Operazione riuscita

La risposta include lo spazio dei nomi dei dati metrici e il RequestId campo della risposta. CloudWatch

{ "response": { "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE", "namespace": "Greengrass", "status": "success" } }
Esempio di output: Errore
{ "response" : { "namespace": "Greengrass", "error": "InvalidInputException", "error_message": "cw metric is invalid", "status": "fail" } }
Nota

Se il componente rileva un errore che può essere riprovato, ad esempio un errore di connessione, riprova la pubblicazione nel batch successivo.

Licenze

Questo componente include i seguenti software/licenze di terze parti:

Questo componente è rilasciato in base al contratto di licenza del software Greengrass Core.

File di registro locale

Questo componente utilizza il seguente file di registro.

Linux
/greengrass/v2/logs/aws.greengrass.Cloudwatch.log
Windows
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log
Per visualizzare i log di questo componente
  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait

Changelog

La tabella seguente descrive le modifiche in ogni versione del componente.

v3.x

Versione

Modifiche

3.1.0

Correzioni di bug e miglioramenti

3.0.0

Questa versione del componente CloudWatch metrics prevede parametri di configurazione diversi rispetto alla versione 2.x. Se utilizzi una configurazione non predefinita per la versione 2.x e desideri eseguire l'aggiornamento dalla v2.x alla v3.x, devi aggiornare la configurazione del componente. Per ulteriori informazioni, consulta Configurazione del componente metrics. CloudWatch

Nuove funzionalità
  • Aggiunge il supporto per i dispositivi principali che eseguono Windows.

  • Cambia il tipo di componente da componente Lambda a componente generico. Questo componente ora non dipende più dal componente legacy del router di sottoscrizione per la creazione di abbonamenti.

  • Aggiunge un nuovo parametro di InputTopic configurazione per specificare l'argomento a cui il componente si iscrive per ricevere messaggi.

  • Aggiunge un nuovo parametro di OutputTopic configurazione per specificare l'argomento in cui il componente pubblica le risposte di stato.

  • Aggiunge un nuovo parametro di PubSubToIoTCore configurazione per specificare se pubblicare e sottoscrivere AWS IoT Core MQTT gli argomenti.

  • Aggiunge il nuovo parametro UseInstaller di configurazione che consente di disabilitare facoltativamente lo script di installazione che installa le dipendenze dei componenti.

Correzioni di bug e miglioramenti

Aggiunge il supporto per timestamp duplicati nei dati di input.

v2.x

Versione

Modifiche

2.1.8

Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.

2.1.3

Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.

2.1.2

Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.

2.1.1

Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.

2.1.0

Nuove funzionalità

2.0.8

Correzioni di bug e miglioramenti
  • Aggiunge il supporto per timestamp duplicati nei dati di input.

  • Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.

2.0.7

Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.

2.0.6

Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.

2.0.5

Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.

2.0.4

Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.

2.0.3

Versione iniziale.

Consulta anche