Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CloudWatch Metriken
<a name="cloudwatch-metrics-rule-action"></a>

Die Aktion CloudWatch metric (`cloudwatchMetric`) erfasst eine CloudWatch Amazon-Metrik. Sie können den Namespace, den Namen, den Wert, die Einheit und den Zeitstempel der Metrik angeben. 

## Voraussetzungen
<a name="cloudwatch-metrics-rule-action-requirements"></a>

Diese Regelaktion hat die folgenden Anforderungen:
+ Eine IAM-Rolle, die die Ausführung des `cloudwatch:PutMetricData` Vorgangs übernehmen AWS IoT kann. Weitere Informationen finden Sie unter [Gewährung einer AWS IoT regeln Sie den Zugriff, den es benötigt](iot-create-role.md).

  In der AWS IoT Konsole können Sie eine Rolle auswählen oder erstellen, die AWS IoT die Ausführung dieser Regelaktion ermöglicht.

## Parameters
<a name="cloudwatch-metrics-rule-action-parameters"></a>

Wenn Sie eine AWS IoT Regel mit dieser Aktion erstellen, müssen Sie die folgenden Informationen angeben:

`metricName`  
Der Name der CloudWatch Metrik.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`metricNamespace`  
Der Name des CloudWatch Metrik-Namespaces.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`metricUnit`  
Die metrische Einheit, unterstützt von CloudWatch.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`metricValue`  
Eine Zeichenfolge, die den CloudWatch Metrikwert enthält.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`metricTimestamp`  
(Optional) Eine Zeichenfolge mit dem Zeitstempel, ausgedrückt in Sekunden der Unix-Epochenzeit. Standardmäßig wird die aktuelle Unix-Epochenzeit verwendet.  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Ja

`roleArn`  
Die IAM-Rolle, die den Zugriff auf die CloudWatch Metrik ermöglicht. Weitere Informationen finden Sie unter [Voraussetzungen](#cloudwatch-metrics-rule-action-requirements).  
Unterstützt [Ersatzvorlagen](iot-substitution-templates.md): Nein

## Beispiele
<a name="cloudwatch-metrics-rule-action-examples"></a>

Das folgende JSON-Beispiel definiert eine CloudWatch Metrikaktion in einer AWS IoT Regel.

```
{
    "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"
                }
            }
        ]
    }
}
```

Das folgende JSON-Beispiel definiert eine CloudWatch metrische Aktion mit Substitutionsvorlagen in einer AWS IoT Regel.

```
{
    "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"
                }
            }
        ]
    }
}
```

## Weitere Informationen finden Sie auch unter
<a name="cloudwatch-metrics-rule-action-see-also"></a>
+ [Was ist Amazon CloudWatch? ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)im * CloudWatch Amazon-Benutzerhandbuch *
+ [Verwendung von CloudWatch Amazon-Metriken ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) im * CloudWatch Amazon-Benutzerhandbuch *