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.

Verkaufte Logs und Metriken

Sie können Ihre Agentenbereiche und Servicebetriebe anhand der von Amazon angebotenen CloudWatch Kennzahlen und Protokolle überwachen. In diesem Thema werden die CloudWatch Metriken beschrieben, die der AWS DevOps Agent automatisch auf Ihrem Konto veröffentlicht, und die versendeten Protokolle, die Sie für die Lieferung an Ihre bevorzugten Ziele konfigurieren können.

CloudWatch Verkaufte Metriken

AWS DevOps Der Agent veröffentlicht automatisch Metriken auf Amazon CloudWatch in Ihrem Konto. Diese Metriken sind ohne Konfiguration verfügbar. Sie können sie verwenden, um die Nutzung zu überwachen, betriebliche Aktivitäten zu verfolgen und Alarme zu erstellen.

Serviceverknüpfte Rolle

Damit CloudWatch Amazon-Metriken in Ihrem Konto für diesen Service veröffentlicht werden, erstellt der AWS DevOps Agent automatisch die serviceverknüpfte Rolle AWSServiceRoleForAIDevOps Service-Linked Role für Sie. Wenn die IAM-Rolle, die die API aufruft, nicht über die entsprechenden Berechtigungen verfügt, schlägt die Ressourcenerstellung mit einem fehl. InvalidParameterException

Manuell eine serviceverknüpfte Rolle erstellen (für Bestandskunden)

Führen Sie eine der folgenden Aktionen aus:

aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com

Namespace

Alle Metriken werden unter dem AWS/AIDevOps Namespace veröffentlicht.

Dimensionen

Alle Metriken enthalten die folgende Dimension.

Referenz zu den Metriken

Metriken in der CloudWatch Konsole anzeigen

Voraussetzungen

Bevor Sie die Protokollzustellung konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:

Vended-Protokolle

AWS DevOps Der Agent unterstützt versendete Logs, die Einblick in Ereignisse bieten, die in Ihren Agenten-Spaces und Service-Registrierungen verarbeitet werden. Verkaufte Logs verwenden die Amazon CloudWatch Logs-Infrastruktur, um Logs an Ihr bevorzugtes Ziel zu liefern.

Um verkaufte Logs verwenden zu können, müssen Sie ein Lieferziel konfigurieren. Die folgenden Ziele werden unterstützt:

Unterstützte Protokolltypen

Ein einziger Protokolltyp wird unterstützt:. APPLICATION_LOGS Dieser Protokolltyp deckt alle Betriebsereignisse ab, die der Dienst ausgibt.

Ereignistypen protokollieren

In der folgenden Tabelle sind die Ereignisse zusammengefasst, die der AWS DevOps Agent protokolliert.

Berechtigungen

AWS DevOps Der Agent verwendet CloudWatch verkaufte Protokolle (V2-Berechtigungen), um Protokolle zu übermitteln. Um die Protokollzustellung einzurichten, muss die IAM-Rolle, die die Übermittlung konfiguriert, über die folgenden Berechtigungen verfügen:

Die vollständige IAM-Richtlinie, die für jeden Zieltyp erforderlich ist, finden Sie in den folgenden Themen im Amazon CloudWatch Logs-Benutzerhandbuch:

Konfigurieren Sie die Protokollzustellung (Konsole)

AWS DevOps Der Agent stellt in der AWS Management Console zwei Speicherorte für die Konfiguration der Protokollzustellung zur Verfügung:

Um die Protokollzustellung für eine Dienstregistrierung zu konfigurieren

Um die Protokollzustellung für einen Agentbereich zu konfigurieren

Konfigurieren Sie die Protokollzustellung (CloudWatch API)

Sie können die CloudWatch Logs-API auch verwenden, um die Protokollzustellung programmgesteuert zu konfigurieren. Eine funktionierende Protokollzustellung besteht aus drei Elementen:

Schritt 1: Erstellen Sie eine Lieferquelle

Verwenden Sie den PutDeliverySourceVorgang, um eine Lieferquelle zu erstellen. Übergeben Sie den ARN Ihrer AWS DevOps Agent-Space-Ressource und geben Sie APPLICATION_LOGS ihn als Protokolltyp an.

Im folgenden Beispiel wird eine Zustellungsquelle für einen Agentenbereich erstellt:

{
    "name": "my-agent-space-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id",
    "logType": "APPLICATION_LOGS"
}

Im folgenden Beispiel wird eine Zustellungsquelle für den Service erstellt:

{
    "name": "my-service-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service",
    "logType": "APPLICATION_LOGS"
}

Schritt 2: Erstellen Sie ein Lieferziel

Verwenden Sie den PutDeliveryDestinationVorgang, um zu konfigurieren, wo Protokolle gespeichert werden. Sie können Amazon CloudWatch Logs, Amazon S3 oder Amazon Data Firehose wählen.

Im folgenden Beispiel wird ein CloudWatch Logs-Ziel erstellt:

{
    "name": "my-cwl-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space"
    },
    "outputFormat": "json"
}

Das folgende Beispiel erstellt ein Amazon S3 S3-Ziel:

{
    "name": "my-s3-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket"
    },
    "outputFormat": "json"
}

Im folgenden Beispiel wird ein Amazon Data Firehose erstellt:

{
    "name": "my-firehose-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream"
    },
    "outputFormat": "json"
}

Wenn Sie verwenden möchten CloudFormation, können Sie Folgendes verwenden:

Der ResourceArn ist der AgentSpaceArn und LogType muss APPLICATION_LOGS als unterstützten Protokolltyp aufweisen.

Schritt 3: Eine Lieferung erstellen

Verwenden Sie den CreateDeliveryVorgang, um die Lieferquelle mit dem Lieferziel zu verknüpfen.

{
    "deliverySourceName": "my-agent-space-delivery-source",
    "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination"
}

AWS CloudFormation

Sie können die Protokollzustellung auch AWS CloudFormation mithilfe der folgenden Ressourcen konfigurieren:

Stellen Sie ResourceArn den AWS DevOps Agent-Bereich oder den Dienst-ARN ein und legen Sie ihn LogType auf festAPPLICATION_LOGS.

Referenz zum Protokollschema

AWS DevOps Der Agent verwendet ein gemeinsames Protokollschema für alle Ereignistypen. Nicht jedes Protokollereignis verwendet jedes Feld.

In der folgenden Tabelle werden die Felder im Protokollschema beschrieben.

Verwaltung und Deaktivierung der Protokollzustellung

Sie können die Protokollzustellung jederzeit über die AWS DevOps Agentenkonsole in der AWS Management Console oder mithilfe der CloudWatch Logs-API ändern oder entfernen.

Protokollzustellung verwalten (Konsole)

Deaktivieren Sie die Protokollzustellung (Konsole)

Deaktivieren Sie die Protokollzustellung (API)

Um eine Protokollzustellung mithilfe der API zu entfernen, löschen Sie die Ressourcen in der folgenden Reihenfolge:

Preisgestaltung

Der AWS DevOps Agent berechnet keine Gebühren für die Aktivierung von versendeten Protokollen. Je nach dem von Ihnen ausgewählten Ziel für die Protokollbereitstellung können jedoch Gebühren für die Bereitstellung, Erfassung, Speicherung oder den Zugriff anfallen. Preisinformationen finden Sie unter Verkaufte Logs auf der Registerkarte Logs bei Amazon CloudWatch Pricing.

Die länderspezifischen Preise finden Sie im Folgenden: