Exemplos do CloudWatch Logs usando o 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 Logs.
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-log-group.
- AWS CLI
-
O seguinte comando cria um grupo de logs chamado
my-logs:aws logs create-log-group --log-group-namemy-logs-
Para obter detalhes da API, consulte CreateLogGroup
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-log-stream.
- AWS CLI
-
O seguinte comando cria um fluxo de logs
20150601no grupo de logsmy-logs:aws logs create-log-stream --log-group-namemy-logs--log-stream-name20150601-
Para obter detalhes da API, consulte CreateLogStream
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-log-group.
- AWS CLI
-
O seguinte comando exclui um grupo de logs chamado
my-logs:aws logs delete-log-group --log-group-namemy-logs-
Para obter detalhes da API, consulte DeleteLogGroup
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-log-stream.
- AWS CLI
-
O seguinte comando exclui um fluxo de logs chamado
20150531de um grupo de logs chamadomy-logs:aws logs delete-log-stream --log-group-namemy-logs--log-stream-name20150531-
Para ver detalhes da API, consulte DeleteLogStream
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-retention-policy.
- AWS CLI
-
O comando a seguir remove a política de retenção que foi aplicada anteriormente a um grupo de logs chamado
my-logs:aws logs delete-retention-policy --log-group-namemy-logs-
Para ver detalhes da API, consulte DeleteRetentionPolicy
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-log-groups.
- AWS CLI
-
O seguinte comando descreve um grupo de logs chamado
my-logs:aws logs describe-log-groups --log-group-name-prefixmy-logsSaída:
{ "logGroups": [ { "storedBytes": 0, "metricFilterCount": 0, "creationTime": 1433189500783, "logGroupName": "my-logs", "retentionInDays": 5, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*" } ] }-
Para obter detalhes da API, consulte DescribeLogGroups
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-log-streams.
- AWS CLI
-
O comando a seguir mostra todos os fluxos de log começando com o prefixo
2015no grupo de logsmy-logs:aws logs describe-log-streams --log-group-namemy-logs--log-stream-name-prefix2015Saída:
{ "logStreams": [ { "creationTime": 1433189871774, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531", "logStreamName": "20150531", "storedBytes": 0 }, { "creationTime": 1433189873898, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601", "logStreamName": "20150601", "storedBytes": 0 } ] }-
Para ver detalhes da API, consulte DescribeLogStreams
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-log-events.
- AWS CLI
-
O seguinte comando recupera eventos de logs de um fluxo de logs chamado
20150601no grupo de logsmy-logs:aws logs get-log-events --log-group-namemy-logs--log-stream-name20150601Saída:
{ "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130", "events": [ { "ingestionTime": 1433190494190, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190516679, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190494190, "timestamp": 1433190184358, "message": "Example Event 2" } ], "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120" }-
Para ver detalhes da API, consulte GetLogEvents
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar put-log-events.
- AWS CLI
-
O seguinte comando define eventos de logs de um fluxo de logs chamado
20150601no grupo de logsmy-logs:aws logs put-log-events --log-group-namemy-logs--log-stream-name20150601--log-eventsfile://eventsSaída:
{ "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" }O exemplo acima lê uma matriz JSON de eventos de um arquivo chamado
eventsno diretório atual:[ { "timestamp": 1433190184356, "message": "Example Event 1" }, { "timestamp": 1433190184358, "message": "Example Event 2" }, { "timestamp": 1433190184360, "message": "Example Event 3" } ]Cada chamada subsequente exige que o próximo token de sequência fornecido pela chamada anterior seja especificado com a opção de token de sequência:
aws logs put-log-events --log-group-namemy-logs--log-stream-name20150601--log-eventsfile://events2--sequence-token"49542672486831074009579604567656788214806863282469607346"Saída:
{ "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826" }-
Para ver detalhes da API, consulte PutLogEvents
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar put-retention-policy.
- AWS CLI
-
O comando a seguir adiciona uma política de retenção de 5 dias a um grupo de logs chamado
my-logs:aws logs put-retention-policy --log-group-namemy-logs--retention-in-days5-
Para ver detalhes da API, consulte PutRetentionPolicy
na Referência de comandos da AWS CLI.
-