Beispiele für die Verwendung von CloudWatch Observability Access Monitor mit AWS CLI

So erstellen Sie einen Link

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

So erstellen Sie einen Sink

Im folgenden Beispiel für create-sink wird ein Sink im aktuellen Konto erstellt, sodass dieses als Überwachungskonto für die kontoübergreifende Beobachtbarkeit von CloudWatch 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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

So löschen Sie einen Link

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

So geben Sie die vollständigen Informationen zu einem einzelnen Link ab

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 von 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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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

Im folgenden Beispiel für list-links wird eine Liste von 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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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

Im folgenden Beispiel für list-sinks wird eine Liste von 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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

So weisen Sie der angegebenen Ressource einen 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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

So entfernen Sie einen 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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.

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 Kontoübergreifende Beobachtbarkeit von CloudWatch im Benutzerhandbuch zu Amazon CloudWatch.