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
L'azione CloudWatch metric (cloudwatchMetric
) acquisisce una metrica Amazon CloudWatch. È possibile specificare namespace, nome, valore, unità e timestamp per il parametro.
Requisiti
Questa operazione della regola presenta i seguenti requisiti:
-
Un IAM ruolo che AWS IoT può assumere per eseguire l'operazione.
cloudwatch:PutMetricData
Per ulteriori informazioni, consulta Concedere a qualsiasi AWS IoT regola l'accesso richiesto.Nella AWS IoT console, è possibile scegliere o creare un ruolo per consentire l'esecuzione di questa azione relativa AWS IoT alla regola.
Parametri
Quando si crea una AWS IoT regola con questa azione, è necessario specificare le seguenti informazioni:
metricName
-
Il nome della CloudWatch metrica.
Supporta modelli di sostituzione: sì
metricNamespace
-
Il nome dello spazio dei nomi della CloudWatch metrica.
Supporta modelli di sostituzione: sì
metricUnit
-
L'unità metrica supportata da. CloudWatch
Supporta modelli di sostituzione: sì
metricValue
-
Una stringa che contiene il valore CloudWatch metrico.
Supporta modelli di sostituzione: sì
metricTimestamp
-
(Facoltativo) Una stringa che contiene l’orario espresso in secondi nel tempo di epoca Unix. Il valore predefinito utilizzato è il tempo di epoca Unix corrente.
Supporta modelli di sostituzione: sì
roleArn
-
Il IAM ruolo che consente l'accesso alla CloudWatch metrica. Per ulteriori informazioni, consulta Requisiti.
Supporta modelli di sostituzione: no
Esempi
L'JSONesempio seguente definisce un'azione CloudWatch metrica in una AWS IoT regola.
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "cloudwatchMetric": { "metricName": "IotMetric", "metricNamespace": "IotNamespace", "metricUnit": "Count", "metricValue": "1", "metricTimestamp": "1456821314", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw" } } ] } }
L'JSONesempio seguente definisce un'azione CloudWatch metrica con modelli di sostituzione in una regola. AWS IoT
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "cloudwatchMetric": { "metricName": "${topic()}", "metricNamespace": "${namespace}", "metricUnit": "${unit}", "metricValue": "${value}", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw" } } ] } }
Consulta anche
-
Che cos'è Amazon CloudWatch? nella Amazon CloudWatch User Guide
-
Utilizzo dei CloudWatch parametri di Amazon nella Amazon CloudWatch User Guide