Esempi per CloudWatch Observability Access Monitor con AWS CLI

Gli esempi di codice seguente mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con CloudWatch Observability Access Monitor.

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

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

Operazioni

L’esempio di codice seguente mostra come utilizzare create-link.

AWS CLI

Come creare un collegamento

Nell’esempio seguente create-link 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta CreateLink in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-sink.

AWS CLI

Come creare un sink

Nell’esempio seguente create-sink crea un sink nell’account corrente in modo che possa essere utilizzato come account di monitoraggio nell’osservabilità tra account CloudWatch.


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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta CreateSink in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-link.

AWS CLI

Come eliminare un collegamento

Nell’esempio seguente delete-link 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta DeleteLink in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-sink.

AWS CLI

Come eliminare un sink

Nell’esempio seguente delete-sink mostra come eliminare 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta DeleteSink in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-link.

AWS CLI

Come restituire informazioni complete su un link

Nell’esempio seguente get-link 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta GetLink in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-sink-policy.

AWS CLI

Come restituire l’attuale policy sink allegata al sink

Nell’esempio seguente get-sink-policy 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta GetSinkPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-sink.

AWS CLI

Come recuperare informazioni complete su un sink di monitoraggio tra account

Nell’esempio seguente get-sink 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta GetSink in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-attached-links.

AWS CLI

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

Nell’esempio seguente list-attached-links 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta ListAttachedLinks in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-links.

AWS CLI

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

Nell’esempio seguente list-links 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 collegamenti ai link 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta ListLinks in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-sinks.

AWS CLI

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

Nell’esempio seguente list-sinks 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta ListSinks in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come visualizzare i tag associati a una risorsa

Nell’esempio seguente list-tags-for-resource 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare put-sink-policy.

AWS CLI

Come creare o aggiornare una policy delle risorse

Nell’esempio seguente put-sink-policy crea la policy di risorse che concede le autorizzazioni agli account di origine per il collegamento 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta PutSinkPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come assegnare uno o più tag a una risorsa specificata

Nell’esempio seguente tag-resource 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere uno o più tag dalla risorsa specificata.

Nell’esempio seguente untag-resource 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-link.

AWS CLI

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

Nell’esempio seguente update-link 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 CloudWatch cross-account observability nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta UpdateLink in AWS CLI Command Reference.

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

Monitoraggio di rete CloudWatch

CloudWatch Observability Admin