CloudWatch Beispiele für Observability Access Monitor mit AWS CLI - AWS Command Line Interface
Aktionen

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 Beispiele für Observability Access Monitor mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit CloudWatch Observability Access Monitor Aktionen ausführen und allgemeine Szenarien implementieren.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendung create-link von.

AWS CLI

Um einen Link zu erstellen

Im folgenden Beispiel für create-link wird eine Verknüpfung zwischen einem Quellkonto und einem Sink hergestellt, den Sie in einem Überwachungskonto erstellt haben.

aws oam create-link \
    --label-template sourceAccount \
    --resource-types AWS::CloudWatch::Metric \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Ausgabe:

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie CreateLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-sink.

AWS CLI

So erstellen Sie einen Sink

Im folgenden create-sink Beispiel wird eine Senke in der Leistungsbilanz erstellt, sodass sie als Überwachungskonto für die CloudWatch kontenübergreifende Observability verwendet werden kann.

aws oam create-sink \
    --name DemoSink

Ausgabe:

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie CreateSinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-link.

AWS CLI

Um einen Link zu löschen

Im folgenden Beispiel für delete-link wird eine Verknüpfung zwischen einem Überwachungskonto-Sink und einem Quellkonto gelöscht.

aws oam delete-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-sink.

AWS CLI

So löschen Sie einen Sink

Im folgenden Beispiel für delete-sink wird ein Sink gelöscht. Sie müssen alle Links zu einem Sink löschen, bevor Sie diesen löschen können.

aws oam delete-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie DeleteSinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-link.

AWS CLI

So geben Sie die vollständigen Informationen zu einem einzelnen Link zurück

Im folgenden Beispiel für get-link werden komplette Informationen zu einem Link zurückgegeben.

aws oam get-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Ausgabe:

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-sink-policy.

AWS CLI

So geben Sie die aktuelle Sink-Richtlinie zurück, die an den Sink angehängt ist

Im folgenden Beispiel für get-sink-policy wird die aktuelle Sink-Richtlinie zurückgegeben, die an den Sink angehängt ist

aws oam get-sink-policy \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Ausgabe:

{
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetSinkPolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-sink.

AWS CLI

So geben Sie die vollständigen Informationen über einen einzelnen Überwachungskonto-Sink zurück

Im folgenden Beispiel für get-sink werden komplette Informationen zu einem Überwachungskonto-Sink zurückgegeben.

aws oam get-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Ausgabe:

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie GetSinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-attached-links.

AWS CLI

So geben Sie eine Liste der Quellkonto-Links zurück, die mit diesem Überwachungskonto-Sink verknüpft sind

Im folgenden Beispiel für list-attached-links wird eine Liste mit Quellkonten-Links zurückgegeben, die mit diesem Überwachungskonto-Sink verknüpft sind.

aws oam list-attached-links \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Ausgabe:

{
    "Items": [{
        "Label": "Monitoring account",
        "LinkArn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
        "ResourceTypes": [
            "AWS::ApplicationInsights::Application",
            "AWS::Logs::LogGroup",
            "AWS::CloudWatch::Metric",
            "AWS::XRay::Trace"
        ]
    }]
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-links.

AWS CLI

So geben Sie eine Liste mit Links für einen Überwachungskonto-Sink zurück

Im folgenden Beispiel für list-links wird eine Liste mit Links für einen Überwachungskonto-Sink zurückgegeben. Führen Sie diese Operation in einem Quellkonto aus, um eine Liste der Links zu Überwachungskonto-Sinks zurückzugeben, die dieses Quellkonto besitzt.

aws oam list-links

Ausgabe:

{
    "Items": [{
        "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
        "Label": "sourceAccount",
        "ResourceTypes": [
            "AWS::CloudWatch::Metric"
        ],
        "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345"
    }]
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ListLinksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-sinks.

AWS CLI

So geben Sie die Liste der Sinks zurück, die im Überwachungskonto erstellt wurden

Im folgenden Beispiel für list-sinks wird eine Liste mit Sinks zurückgegeben, die im Überwachungskonto erstellt wurden. Führen Sie diese Operation in einem Überwachungskonto aus.

aws oam list-sinks

Ausgabe:

{
    "Items": [
        {
            "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
            "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
            "Name": "DemoSink"
        }
    ]
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie ListSinksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

So zeigen Sie die Tags an, die einer Ressource zugeordnet sind

Im folgenden Beispiel für list-tags-for-resource werden die Tags angezeigt, die einem Sink zugeordnet sind.

aws oam list-tags-for-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Ausgabe:

{
    "Tags": {
        "Team": "Devops"
    }
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-sink-policy.

AWS CLI

So erstellen oder aktualisieren Sie eine Ressourcenrichtlinie

Im folgenden Beispiel für put-sink-policy wird die Ressourcenrichtlinie erstellt, die Quellkonten berechtigt, eine Verbindung zum Überwachungskonto-Sink herzustellen.

aws oam put-sink-policy \
    --policy '{"Version":"2012-10-17",		 	 	 "Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789111:root"},"Action":["oam:CreateLink","oam:UpdateLink"],"Resource":"*","Condition":{"ForAllValues:StringEquals":{"oam:ResourceTypes":["AWS::Logs::LogGroup","AWS::CloudWatch::Metric","AWS::XRay::Trace","AWS::ApplicationInsights::Application"]}}}]}' \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Ausgabe:

{
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie PutSinkPolicyin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

So weisen Sie der angegebenen Ressource einzelne oder mehrere Tags zu

Im folgenden Beispiel für tag-resource wird ein Sink arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 mit einem Tag versehen.

aws oam tag-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 \
    --tags team=Devops

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource

Im folgenden Beispiel für untag-resource wird ein Tag mit dem Schlüssel team aus dem Sink arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 entfernt.

aws oam untag-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/f3f42f60-f0f2-425c-1234-12347bdd821f \
    --tag-keys team

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-link.

AWS CLI

So ändern Sie, welche Datentypen von einem Quellkonto an den zugehörigen Überwachungskonto-Sink weitergegeben werden

Im folgenden Beispiel für update-link wird der Link arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0 mit den Ressourcentypen AWS::CloudWatch::Metric und AWS::Logs::LogGroup aktualisiert.

aws oam update-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 \
    --resource-types "AWS::CloudWatch::Metric" "AWS::Logs::LogGroup"

Ausgabe:

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric",
        "AWS::Logs::LogGroup"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Weitere Informationen finden Sie unter CloudWatch kontoübergreifende Beobachtbarkeit im CloudWatch Amazon-Benutzerhandbuch.

  • Einzelheiten zur API finden Sie UpdateLinkin der AWS CLI Befehlsreferenz.