Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CloudWatch Exemplos do Observability Access Monitor usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o CloudWatch Observability Access Monitor.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
Tópicos
Ações
O código de exemplo a seguir mostra como usar create-link
.
- AWS CLI
-
Para criar um link
O
create-link
exemplo a seguir cria um link entre uma conta de origem e um coletor que você criou em uma conta de monitoramento.aws oam create-link \ --label-template
sourceAccount
\ --resource-typesAWS::CloudWatch::Metric
\ --sink-identifierarn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Saída:
{ "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": {} }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte CreateLink
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-sink
.
- AWS CLI
-
Para criar uma pia
O
create-sink
exemplo a seguir cria um coletor na conta corrente, para que possa ser usado como uma conta de monitoramento na observabilidade CloudWatch entre contas.aws oam create-sink \ --name
DemoSink
Saída:
{ "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte CreateSink
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-link
.
- AWS CLI
-
Para excluir um link
O
delete-link
exemplo a seguir exclui um link entre um coletor de contas de monitoramento e uma conta de origem.aws oam delete-link \ --identifier
arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111
Este comando não produz saída.
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte DeleteLink
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-sink
.
- AWS CLI
-
Para excluir um coletor
O
delete-sink
exemplo a seguir exclui um coletor. Você deve excluir todos os links para um coletor antes de excluir esse coletor.aws oam delete-sink \ --identifier
arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Este comando não produz saída.
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte DeleteSink
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-link
.
- AWS CLI
-
Para retornar informações completas sobre um link
O
get-link
exemplo a seguir retorna informações completas sobre um link.aws oam get-link \ --identifier
arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111
Saída:
{ "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": {} }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte GetLink
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-sink-policy
.
- AWS CLI
-
Para retornar a política de coletor atual anexada ao coletor
O
get-sink-policy
exemplo a seguir retorna a política de coletor atual anexada ao coletor.aws oam get-sink-policy \ --sink-identifier
arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Saída:
{ "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\"]}}}]}" }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte GetSinkPolicy
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-sink
.
- AWS CLI
-
Para retornar informações completas sobre um coletor de contas de monitoramento
O
get-sink
exemplo a seguir retorna informações completas sobre um coletor de contas de monitoramento.aws oam get-sink \ --identifier
arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Saída:
{ "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte GetSink
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-attached-links
.
- AWS CLI
-
Para retornar uma lista dos links da conta de origem vinculados a esse coletor de contas de monitoramento
O
list-attached-links
exemplo a seguir retorna uma lista dos links da conta de origem vinculados a esse coletor de contas de monitoramento.aws oam list-attached-links \ --sink-identifier
arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Saída:
{ "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" ] }] }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte ListAttachedLinks
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-links
.
- AWS CLI
-
Para retornar uma lista de links para um coletor de contas de monitoramento
O
list-links
exemplo a seguir retorna uma lista de links para um coletor de contas de monitoramento. Execute essa operação em uma conta de origem para retornar uma lista de links para coletores de contas de monitoramento que essa conta de origem tem.aws oam list-links
Saída:
{ "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" }] }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte ListLinks
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-sinks
.
- AWS CLI
-
Para retornar a lista de coletores criados na conta de monitoramento
O
list-sinks
exemplo a seguir retorna uma lista de coletores criados na conta de monitoramento. Execute essa operação em uma conta de monitoramento.aws oam list-sinks
Saída:
{ "Items": [ { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink" } ] }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte ListSinks
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-tags-for-resource
.
- AWS CLI
-
Para exibir as tags associadas a um recurso
O
list-tags-for-resource
exemplo a seguir exibe as tags associadas a um coletor.aws oam list-tags-for-resource \ --resource-arn
arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Saída:
{ "Tags": { "Team": "Devops" } }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte ListTagsForResource
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar put-sink-policy
.
- AWS CLI
-
Para criar ou atualizar a política de recursos
O
put-sink-policy
exemplo a seguir cria a política de recursos que concede permissões às contas de origem para serem vinculadas ao coletor da conta de monitoramento.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-identifierarn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
Saída:
{ "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\"]}}}]}" }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte PutSinkPolicy
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar tag-resource
.
- AWS CLI
-
Para atribuir uma ou mais tags ao recurso especificado
O
tag-resource
exemplo a seguir marca um coletorarn: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
\ --tagsteam=Devops
Este comando não produz saída.
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte TagResource
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar untag-resource
.
- AWS CLI
-
Para remover uma ou mais tags do recurso especificado.
O
untag-resource
exemplo a seguir remove uma tag com a chaveteam
do coletorarn: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-keysteam
Este comando não produz saída.
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte UntagResource
em Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-link
.
- AWS CLI
-
Para alterar quais tipos de dados são compartilhados de uma conta de origem para o coletor de contas de monitoramento vinculadas
O
update-link
exemplo a seguir atualiza o linkarn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0
com os tipos de recursosAWS::CloudWatch::Metric
AWS::Logs::LogGroup
e.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"
Saída:
{ "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": {} }
Para obter mais informações, consulte a observabilidade CloudWatch entre contas no Guia CloudWatch do usuário da Amazon.
-
Para obter detalhes da API, consulte UpdateLink
em Referência de AWS CLI Comandos.
-