Zum Hauptinhalt springen
Verwenden Sie eine AWS CloudFormation-Vorlage, um das Streaming von CloudWatch-Metriken zu AppSignal einzurichten. Die Vorlage erstellt alle erforderlichen Ressourcen in einer einzigen Bereitstellung, anstatt jede einzelne manuell über die AWS-Konsole zu konfigurieren. Eine Übersicht über CloudWatch-Metriken in AppSignal, einschließlich Magic Dashboards und Metrikbenennung, finden Sie unter AWS CloudWatch-Metriken. Wenn Sie jede Ressource lieber manuell einrichten möchten, lesen Sie den Leitfaden zur Konsolen-Einrichtung.

​
Bevor Sie beginnen

Halten Sie 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, in der Sie den Stack bereitstellen möchten.

​
Was die Vorlage erstellt

Die CloudFormation-Vorlage erstellt die folgenden Ressourcen:
  1. Ein S3-Bucket zum Speichern von Datensätzen, deren Zustellung fehlschlägt, mit einer 30-tägigen Lifecycle-Expiration und einer Retain-on-Delete-Richtlinie.
  2. Eine IAM-Rolle, die es Amazon Data Firehose ermöglicht, fehlgeschlagene Datensätze in den S3-Bucket zu schreiben.
  3. Einen Firehose Delivery Stream, der Metriken über HTTPS an den AppSignal-Endpunkt sendet.
  4. Eine IAM-Rolle, die es CloudWatch Metric Streams ermöglicht, in den Firehose Delivery Stream zu schreiben.
  5. Einen CloudWatch Metric Stream, der Metriken im OpenTelemetry 1.0-Format exportiert.

​
CloudFormation-Vorlage

Kopieren Sie die folgende Vorlage und speichern Sie sie als appsignal-cloudwatch-metrics.yaml:
YAML
AWSTemplateFormatVersion: "2010-09-09"
Description: >
  Stream CloudWatch metrics to AppSignal using Amazon Data Firehose.

Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups:
      - Label:
          default: AppSignal Configuration
        Parameters:
          - AppLevelPushApiKey
    ParameterLabels:
      AppLevelPushApiKey:
        default: "App-level Push API Key (find at https://appsignal.com/redirect-to/app?to=api_keys&key_tab=app)"

Parameters:
  AppLevelPushApiKey:
    Type: String
    NoEcho: true
    Description: >
      Your App-level Push API key from AppSignal.

Resources:
  # 1. S3 bucket for failed deliveries
  FailedDeliveryBucket:
    Type: AWS::S3::Bucket
    DeletionPolicy: Retain
    Properties:
      BucketName: !Sub "appsignal-firehose-${AWS::StackName}-${AWS::AccountId}-${AWS::Region}"
      PublicAccessBlockConfiguration:
        BlockPublicAcls: true
        BlockPublicPolicy: true
        IgnorePublicAcls: true
        RestrictPublicBuckets: true
      BucketEncryption:
        ServerSideEncryptionConfiguration:
          - ServerSideEncryptionByDefault:
              SSEAlgorithm: AES256
      LifecycleConfiguration:
        Rules:
          - Id: ExpireFailedDeliveries
            Status: Enabled
            ExpirationInDays: 30

  # 2. IAM role for Firehose to write to S3
  FirehoseS3Role:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service: firehose.amazonaws.com
            Action: "sts:AssumeRole"
      Policies:
        - PolicyName: FirehoseS3Access
          PolicyDocument:
            Version: "2012-10-17"
            Statement:
              - Effect: Allow
                Action:
                  - "s3:AbortMultipartUpload"
                  - "s3:GetBucketLocation"
                  - "s3:GetObject"
                  - "s3:ListBucket"
                  - "s3:ListBucketMultipartUploads"
                  - "s3:PutObject"
                Resource:
                  - !GetAtt FailedDeliveryBucket.Arn
                  - !Sub "${FailedDeliveryBucket.Arn}/*"

  # 3. Firehose delivery stream
  MetricsDeliveryStream:
    Type: AWS::KinesisFirehose::DeliveryStream
    Properties:
      DeliveryStreamType: DirectPut
      HttpEndpointDestinationConfiguration:
        EndpointConfiguration:
          Url: "https://appsignal-endpoint.net/metrics/aws-cloudwatch"
          AccessKey: !Ref AppLevelPushApiKey
          Name: AppSignal
        RequestConfiguration:
          ContentEncoding: GZIP
        BufferingHints:
          IntervalInSeconds: 60
          SizeInMBs: 1
        S3BackupMode: FailedDataOnly
        S3Configuration:
          BucketARN: !GetAtt FailedDeliveryBucket.Arn
          RoleARN: !GetAtt FirehoseS3Role.Arn
        RoleARN: !GetAtt FirehoseS3Role.Arn

  # 4. IAM role for CloudWatch Metric Streams to write to Firehose
  MetricStreamRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service: streams.metrics.cloudwatch.amazonaws.com
            Action: "sts:AssumeRole"
      Policies:
        - PolicyName: MetricStreamFirehoseAccess
          PolicyDocument:
            Version: "2012-10-17"
            Statement:
              - Effect: Allow
                Action:
                  - "firehose:PutRecord"
                  - "firehose:PutRecordBatch"
                Resource: !GetAtt MetricsDeliveryStream.Arn

  # 5. CloudWatch metric stream
  CloudWatchMetricStream:
    Type: AWS::CloudWatch::MetricStream
    Properties:
      FirehoseArn: !GetAtt MetricsDeliveryStream.Arn
      RoleArn: !GetAtt MetricStreamRole.Arn
      OutputFormat: "opentelemetry1.0"

Outputs:
  DeliveryStreamName:
    Description: Name of the Firehose delivery stream.
    Value: !Ref MetricsDeliveryStream

  MetricStreamName:
    Description: Name of the CloudWatch metric stream.
    Value: !Ref CloudWatchMetricStream

  FailedDeliveryBucketName:
    Description: S3 bucket for failed delivery records.
    Value: !Ref FailedDeliveryBucket

​
Stack bereitstellen

  1. Öffnen Sie die AWS CloudFormation-Konsole.
  2. Wählen Sie Create stack und wählen Sie With new resources (standard).
  3. Wählen Sie unter Specify template Upload a template file und laden Sie appsignal-cloudwatch-metrics.yaml hoch.
  4. Wählen Sie Next.
  5. Geben Sie einen Stack-Namen ein, z. B. appsignal-cloudwatch-metrics.
  6. Geben Sie für AppLevelPushApiKey den App-level Push API-Schlüssel Ihrer App ein.
  7. Wählen Sie zweimal Next, markieren Sie dann I acknowledge that AWS CloudFormation might create IAM resources und wählen Sie Submit.
Die Erstellung des Stacks dauert einige Minuten. Sobald der Status CREATE_COMPLETE anzeigt, beginnt CloudWatch mit dem Streamen von Metriken zu AppSignal.

​
Bestimmte AWS-Dienste filtern

Standardmäßig streamt die Vorlage Metriken von allen AWS-Diensten im Konto. Um nur bestimmte Dienste zu streamen, fügen Sie IncludeFilters zur CloudWatchMetricStream-Ressource hinzu:
YAML
CloudWatchMetricStream:
  Type: AWS::CloudWatch::MetricStream
  Properties:
    FirehoseArn: !GetAtt MetricsDeliveryStream.Arn
    RoleArn: !GetAtt MetricStreamRole.Arn
    OutputFormat: "opentelemetry1.0"
    IncludeFilters:
      - Namespace: AWS/EC2
      - Namespace: AWS/RDS
      - Namespace: AWS/ELB
Ersetzen Sie die Namespaces durch die AWS-Dienste, die Sie überwachen möchten. Eine vollständige Liste der verfügbaren Namespaces finden Sie unter AWS-Dienste, die CloudWatch-Metriken veröffentlichen.

​
Bereitstellung überprüfen

  1. Suchen Sie in der AWS-Konsole nach „CloudFormation” und wählen Sie Stacks. Öffnen Sie Ihren Stack und wählen Sie den Resources-Tab, um zu bestätigen, dass alle Ressourcen CREATE_COMPLETE anzeigen.
  2. Suchen Sie in der AWS-Konsole nach „CloudWatch”. Gehen Sie in der linken Seitenleiste zu Metrics > Streams und bestätigen Sie, dass der Status des Metric Streams Running ist.
  3. Suchen Sie in der AWS-Konsole nach „Firehose”. Öffnen Sie den Delivery Stream und nutzen Sie die Funktion Test with demo data, um die Konnektivität zu überprüfen.
  4. Öffnen Sie in AppSignal das Dashboard Ihrer App und prüfen Sie, ob CloudWatch-Metriken auf Ihrem benutzerdefinierten Dashboard erscheinen.
Wenn nach einigen Minuten keine Metriken erscheinen, überprüfen Sie den S3-Bucket auf fehlgeschlagene Zustellungsdatensätze. Wenn Sie Hilfe benötigen, kontaktieren Sie uns.

​
Multi-Region-Bereitstellungen

Die Vorlage stellt alle Ressourcen in einer einzigen AWS-Region bereit. Wenn Sie Workloads in mehreren Regionen ausführen, stellen Sie in jeder Region eine separate Kopie dieses Stacks bereit. Dies hält die Datenübertragung innerhalb jeder Region und vermeidet Gebühren für regionsübergreifende Übertragungen.

​
Aufräumen

Um alle von dieser Vorlage erstellten Ressourcen zu entfernen, löschen Sie den Stack in der CloudFormation-Konsole. Der S3-Bucket für fehlgeschlagene Zustellungen hat eine DeletionPolicy von Retain, daher wird er beim Löschen des Stacks beibehalten, um zu vermeiden, dass fehlgeschlagene Zustellungsdatensätze verloren gehen. Fehlgeschlagene Zustellungsdatensätze im Bucket werden durch die Lifecycle-Regel automatisch nach 30 Tagen gelöscht. Sie können den Bucket manuell löschen, sobald Sie ihn nicht mehr benötigen.