CloudWatch Beispiele für Observability Access Monitor mit AWS CLI - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

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 Szenarios anzeigen.

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

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungcreate-link.

AWS CLI

Um einen Link zu erstellen

Im folgenden create-link Beispiel wird eine Verknüpfung zwischen einem Quellkonto und einer Senke erstellt, die 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

Um eine Senke zu erstellen

Im folgenden create-sink Beispiel wird eine Senke in der Leistungsbilanz erstellt, sodass sie als Überwachungskonto für die CloudWatch kontenübergreifende Beobachtbarkeit 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 delete-link Beispiel wird eine Verknüpfung zwischen einer Monitoring-Kontosenke 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

Um eine Senke zu löschen

Im folgenden delete-sink Beispiel wird eine Senke gelöscht. Sie müssen alle Links zu einer Senke löschen, bevor Sie diese Senke 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

Um vollständige Informationen zu einem Link zurückzugeben

Das folgende get-link Beispiel gibt vollständige Informationen zu einem Link zurück.

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

Um die aktuelle Senkenrichtlinie zurückzugeben, die der Senke zugeordnet ist

Das folgende get-sink-policy Beispiel gibt die aktuelle Senkenrichtlinie zurück, die der Senke zugeordnet 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

Um vollständige Informationen zu einer Monitoring-Account-Senke zurückzugeben

Das folgende get-sink Beispiel gibt vollständige Informationen über eine Monitoring-Kontosenke zurück.

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

Um eine Liste von Quellkonto-Links zurückzugeben, die mit dieser Monitoring-Kontosenke verknüpft sind

Im folgenden list-attached-links Beispiel wird eine Liste von Quellkontenlinks zurückgegeben, die mit dieser Überwachungskontensenke 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

Um eine Liste von Links für eine Monitoring-Account-Senke zurückzugeben

Das folgende list-links Beispiel gibt eine Liste von Links für eine Monitoring-Kontosenke zurück. Führen Sie diesen Vorgang in einem Quellkonto aus, um eine Liste der Links zu den Überwachungskontensenken dieses Quellkontos zurückzugeben.

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

Um die Liste der Senken zurückzugeben, die im Monitoring-Konto erstellt wurden

Das folgende list-sinks Beispiel gibt eine Liste von Senken zurück, die im Überwachungskonto erstellt wurden. Führen Sie diesen Vorgang 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

Um die mit einer Ressource verknüpften Tags anzuzeigen

Im folgenden list-tags-for-resource Beispiel werden die Tags angezeigt, die einer Senke 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

Um die Ressourcenrichtlinie zu erstellen oder zu aktualisieren

Im folgenden put-sink-policy Beispiel wird die Ressourcenrichtlinie erstellt, die Quellkonten die Erlaubnis erteilt, eine Verbindung zur Überwachungskontensenke 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

Um der angegebenen Ressource ein oder mehrere Tags zuzuweisen

Das folgende tag-resource Beispiel kennzeichnet eine Senkearn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345.

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

Um ein oder mehrere Tags aus der angegebenen Ressource zu entfernen.

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

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

Um zu ändern, welche Datentypen von einem Quellkonto zur zugehörigen Monitoringkontosenke gemeinsam genutzt werden

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

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.