Zum Hauptinhalt springen
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. Eine Übersicht über CloudWatch-Metriken in AppSignal, einschließlich Magic Dashboards und Metrikbenennung, finden Sie unter AWS CloudWatch-Metriken. 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
  2. Eine IAM-Rolle für Data Firehose einrichten
  3. Einen Firehose Stream erstellen
  4. Einen CloudWatch Metric Stream erstellen
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 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
{
  "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.
Siehe Hinzufügen von IAM-Identitäts-Berechtigungen für Anweisungen zur Erstellung von Inline-Richtlinien für IAM-Rollen.
JSON
{
  "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
https://appsignal-endpoint.net/metrics/aws-cloudwatch
  1. 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.
  2. Wählen Sie unter „Content encoding” GZIP aus.
  3. 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.
  4. 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.
  5. 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.
  6. 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-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.
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 für Details zu Metrik-Berichtsfrequenzen.

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