> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS CloudWatch-Metriken über die AWS-Konsole streamen

Dieser Leitfaden führt durch die Einrichtung des Streamings von CloudWatch-Metriken zu AppSignal, indem jede Ressource manuell in der AWS-Konsole erstellt wird. Für eine automatisierte Alternative siehe [AWS CloudWatch-Metriken mit CloudFormation streamen](/metrics/cloudwatch-cloudformation).

Eine Übersicht über CloudWatch-Metriken in AppSignal, einschließlich Magic Dashboards und Metrikbenennung, finden Sie unter [AWS CloudWatch-Metriken](/metrics/cloudwatch-overview).

Führen Sie die folgenden Schritte aus, um CloudWatch-Metriken über Amazon Data Firehose an AppSignal zu senden:

1. [Einen S3-Bucket für fehlgeschlagene Zustellungen einrichten](#set-up-an-s3-bucket-for-failed-deliveries)
2. [Eine IAM-Rolle für Data Firehose einrichten](#set-up-an-iam-role-for-data-firehose)
3. [Einen Firehose Stream erstellen](#create-a-firehose-stream)
4. [Einen CloudWatch Metric Stream erstellen](#create-a-cloudwatch-metric-stream)

Halten Sie vor Beginn die folgenden Informationen bereit:

* Den App-level Push API-Schlüssel Ihrer App. Um ihn zu finden, öffnen Sie die [API-Schlüssel-Einstellungsseite](https://appsignal.com/redirect-to/app?to=api_keys\&key_tab=app) oder navigieren Sie zu Ihren Organisationseinstellungen und wählen Sie **Dev zone > API keys**.
* Die AWS-Region, aus der Sie Metriken streamen möchten.
* AWS-Berechtigungen zum Erstellen von Firehose Streams, CloudWatch Metric Streams, S3-Buckets und IAM-Rollen.

## Einen S3-Bucket für fehlgeschlagene Zustellungen einrichten

Amazon Data Firehose benötigt einen S3-Bucket, um Datensätze zu speichern, deren Zustellung fehlschlägt. Erstellen Sie einen S3-Bucket über die AWS-Konsole oder die CLI, bevor Sie fortfahren.

## Eine IAM-Rolle für Data Firehose einrichten

Erstellen Sie eine IAM-Rolle, die es Data Firehose erlaubt, in den S3-Bucket zu schreiben. Verwenden Sie die folgende Trust Policy:

```json JSON theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "firehose.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
```

Weisen Sie der Rolle die folgende Berechtigungsrichtlinie als Inline-Policy zu.

<Note>
  Siehe [Hinzufügen von IAM-Identitäts-Berechtigungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)
  für Anweisungen zur Erstellung von Inline-Richtlinien für IAM-Rollen.
</Note>

```json JSON theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:GetBucketLocation",
        "s3:GetObject",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:PutObject"
      ],
      "Resource": [
        "arn:aws:s3:::<FIREHOSE_S3_BUCKET>",
        "arn:aws:s3:::<FIREHOSE_S3_BUCKET>/*"
      ]
    }
  ]
}
```

Ersetzen Sie `<FIREHOSE_S3_BUCKET>` durch den Namen des S3-Buckets, den Sie im vorherigen Schritt erstellt haben.

## Einen Firehose Stream erstellen

1. Öffnen Sie die Amazon Data Firehose-Konsole und wählen Sie **Create Firehose stream**.
2. Wählen Sie **Direct PUT** als Quelle.
3. Wählen Sie **HTTP Endpoint** als Ziel.
4. Lassen Sie unter „Transform records" die Datentransformation ausgeschaltet. Die Daten müssen so geliefert werden, wie sie sind.
5. Geben Sie die folgende URL als **HTTP endpoint URL** ein:

```shell Shell theme={null}
https://appsignal-endpoint.net/metrics/aws-cloudwatch
```

6. Geben Sie den App-level Push API-Schlüssel Ihrer App als **Access key** ein. Dies ist kein AWS-Access-Key. Es ist der Schlüssel, den AppSignal verwendet, um Ihre App zu identifizieren.
7. Wählen Sie unter „Content encoding" **GZIP** aus.
8. Setzen Sie unter „Buffer hints" die Puffergröße auf **1 MB** und das Pufferintervall auf **60 Sekunden** für die niedrigste Latenz. Höhere Werte reduzieren die Kosten, erhöhen aber die Zustellungsverzögerung.
9. Setzen Sie unter „Backup settings" das Source Record Backup auf **Failed data only** und wählen Sie den S3-Bucket aus, den Sie in den vorherigen Schritten erstellt haben.
10. Wählen Sie unter „Advanced settings > Service access" **Choose existing IAM role** und wählen Sie die IAM-Rolle, die Sie in den vorherigen Schritten erstellt haben.
11. Wählen Sie **Create Firehose stream**.

## Einen CloudWatch Metric Stream erstellen

1. Gehen Sie in der CloudWatch-Konsole zu **Metrics > Streams**.
2. Wählen Sie **Create metric stream**.
3. Wählen Sie **Custom setup with Firehose**. Wählen Sie unter **Select your Amazon Data Firehose stream** den Firehose Stream aus, den Sie im vorherigen Schritt erstellt haben.
4. Wählen Sie, welche Metriken gestreamt werden sollen:
   * **All metrics** streamt alles von allen AWS-Diensten. Dies ist die einfachste Option, kann aber die Kosten erhöhen.
   * **Selected namespaces** ermöglicht es Ihnen, bestimmte Namespaces einzuschließen oder auszuschließen, z. B. `AWS/EC2`, `AWS/Lambda` oder `AWS/RDS`. Siehe die [Magic Dashboards](/metrics/aws-dashboards)-Seite für die von AppSignal unterstützten Dienste.
5. Wählen Sie **OpenTelemetry 1.0** als Ausgabeformat.
6. Lassen Sie für **Service access** die AWS-Konsole die IAM-Rolle für Sie erstellen oder aktualisieren, oder wählen Sie eine bestehende Rolle mit Berechtigung, in den Firehose Stream zu schreiben.
7. Wählen Sie **Create metric stream**.

Sie können mehrere Metric Streams erstellen, wenn Sie Metriken an verschiedene Ziele senden oder Metriken für separate Anwendungsfälle unterschiedlich filtern müssen.

## Einrichtung überprüfen

Nach Abschluss der Einrichtung lassen Sie 5 bis 10 Minuten verstreichen, bis Metriken in AppSignal erscheinen.

So überprüfen Sie, ob Daten fließen:

1. Überprüfen Sie den **Monitoring**-Tab Ihres Firehose Streams in der AWS-Konsole. Suchen Sie nach Werten ungleich null für die Metriken **Incoming records** und **HTTP endpoint - Success**.
2. Bestätigen Sie, dass der Metric Stream-Status in der CloudWatch-Konsole unter **Metrics > Streams** als **Running** angezeigt wird.

Wenn keine Daten erscheinen, aktivieren Sie das CloudWatch Logs-Error-Logging am Firehose Stream und prüfen Sie auf Zustellungsfehler.

<Note>
  Einige AWS-Metriken, z. B. tägliche S3-Speichermetriken, werden mit
  Zeitstempeln gemeldet, die älter als zwei Stunden sind, und erscheinen nicht
  in Metric Streams. Siehe die [AWS-Dokumentation zu CloudWatch Metric
  Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html)
  für Details zu Metrik-Berichtsfrequenzen.
</Note>

## CloudWatch-Metriken in AppSignal

Nach der Einrichtung empfängt AppSignal Metriken von jedem AWS-Dienst, der Metriken über CloudWatch ausgibt.

AppSignal erstellt automatisch [Magic Dashboards](/metrics/aws-dashboards) für unterstützte AWS-Dienste, sobald deren Metriken erkannt werden. Diese Dashboards erscheinen unter **Dashboards** mit vorgefertigten Charts für die wichtigsten Metriken jedes Dienstes.

Sie können auch eigene Ansichten mit [benutzerdefinierten Dashboards](/metrics/dashboards) erstellen. Geben Sie im Feld **Metric** `aws_` ein, um die von AppSignal empfangenen CloudWatch-Metriken zu durchsuchen. AppSignal normalisiert CloudWatch-Metriknamen zu Kleinbuchstaben mit Unterstrichen. Beispielsweise wird `AWS/Firehose` `DeliveryToS3.Success` zu `aws_firehose_delivery_to_s3_success`.

Es kann nach der Einrichtung einige Minuten dauern, bis die ersten Metriken erscheinen. Wenn die Liste leer ist, warten Sie einige Minuten und aktualisieren Sie.

Wenn Sie Hilfe benötigen, [kontaktieren Sie uns](mailto:support@appsignal.com).