CloudWatch Esempi di Observability Access Monitor utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with CloudWatch Observability Access Monitor.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-link.

AWS CLI

Come creare un link

L’esempio create-link seguente crea un link tra un account di origine e un sink creato in un account di monitoraggio.


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

Output:


{
    "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": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command CreateLinkReference.

Il seguente esempio di codice mostra come utilizzarecreate-sink.

AWS CLI

Come creare un sink

L'create-sinkesempio seguente crea un sink nell'account corrente, in modo che possa essere utilizzato come account di monitoraggio nell'osservabilità CloudWatch tra account.


aws oam create-sink \
    --name DemoSink

Output:


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

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command CreateSinkReference.

Il seguente esempio di codice mostra come utilizzaredelete-link.

AWS CLI

Come eliminare un link

L’esempio delete-link seguente elimina un link tra un sink dell’account di monitoraggio e un account di origine.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command DeleteLinkReference.

Il seguente esempio di codice mostra come utilizzaredelete-sink.

AWS CLI

Come eliminare un sink

L’esempio delete-sink seguente elimina un sink. È necessario eliminare tutti i link a un sink prima di poterlo eliminare.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command DeleteSinkReference.

Il seguente esempio di codice mostra come utilizzareget-link.

AWS CLI

Come restituire informazioni complete su un link

L’esempio get-link seguente recupera le informazioni relative a un link.


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

Output:


{
    "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": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command GetLinkReference.

Il seguente esempio di codice mostra come utilizzareget-sink-policy.

AWS CLI

Come restituire l’attuale policy di sink allegata al sink

L’esempio get-sink-policy seguente restituisce la policy di sink corrente associata al sink.


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

Output:


{
    "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\"]}}}]}"
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command GetSinkPolicyReference.

Il seguente esempio di codice mostra come utilizzareget-sink.

AWS CLI

Come recuperare informazioni complete su un sink di monitoraggio tra account

L’esempio get-sink seguente restituisce informazioni complete su un sink dell’account di monitoraggio.


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

Output:


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

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command GetSinkReference.

Il seguente esempio di codice mostra come utilizzarelist-attached-links.

AWS CLI

Come restituire un elenco di link agli account di origine collegati a questo sink di account di monitoraggio

L’esempio list-attached-links seguente restituisce un elenco di link dell’account di origine collegati al sink corrente dell’account di monitoraggio.


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

Output:


{
    "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"
        ]
    }]
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command ListAttachedLinksReference.

Il seguente esempio di codice mostra come utilizzarelist-links.

AWS CLI

Come restituire un elenco di link per un sink dell’account di monitoraggio

L’esempio list-links seguente restituisce un elenco di link per un sink dell’account di monitoraggio. Esegui questa operazione in un account di origine per restituire un elenco di link ai sink degli account di monitoraggio di questo account di origine.


aws oam list-links

Output:


{
    "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"
    }]
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command ListLinksReference.

Il seguente esempio di codice mostra come utilizzarelist-sinks.

AWS CLI

Come restituire l’elenco dei sink creati nell’account di monitoraggio

L’esempio list-sinks seguente restituisce un elenco di sink creati nell’account di monitoraggio. Esegui questa operazione in un account di monitoraggio.


aws oam list-sinks

Output:


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

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command ListSinksReference.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come visualizzare i tag associati a una risorsa

L’esempio list-tags-for-resource seguente visualizza i tag associati a un sink.


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

Output:


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

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command ListTagsForResourceReference.

Il seguente esempio di codice mostra come utilizzareput-sink-policy.

AWS CLI

Come creare o aggiornare una policy delle risorse

L’esempio put-sink-policy seguente crea la policy di risorse che concede le autorizzazioni agli account di origine per il link al sink dell’account di monitoraggio.


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

Output:


{
    "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\"]}}}]}"
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command PutSinkPolicyReference.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come assegnare uno o più tag a una risorsa specificata

L’esempio tag-resource seguente tagga un sink denominato arn: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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command TagResourceReference.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere uno o più tag dalla risorsa specificata.

L’esempio untag-resource seguente rimuove un tag con la chiave team dal sink arn: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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command UntagResourceReference.

Il seguente esempio di codice mostra come utilizzareupdate-link.

AWS CLI

Come modificare i tipi di dati condivisi da un account di origine al relativo sink dell’account di monitoraggio collegato

L’esempio update-link seguente aggiorna il link arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0 con i tipi di risorsa AWS::CloudWatch::Metric e AWS::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"

Output:


{
    "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": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta AWS CLI Command UpdateLinkReference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CloudWatch Monitoraggio della rete

CloudWatch Observability Admin