Exemplos do CloudWatch Logs usando o AWS CLI

O seguinte comando cria um grupo de logs chamado my-logs:

aws logs create-log-group --log-group-name my-logs

O seguinte comando cria um fluxo de logs 20150601 no grupo de logs my-logs:

aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601

O seguinte comando exclui um grupo de logs chamado my-logs:

aws logs delete-log-group --log-group-name my-logs

O seguinte comando exclui um fluxo de logs chamado 20150531 de um grupo de logs chamado my-logs:

aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531

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-name my-logs

O seguinte comando descreve um grupo de logs chamado my-logs:

aws logs describe-log-groups --log-group-name-prefix my-logs

Resultado:

{
    "logGroups": [
        {
            "storedBytes": 0,
            "metricFilterCount": 0,
            "creationTime": 1433189500783,
            "logGroupName": "my-logs",
            "retentionInDays": 5,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
        }
    ]
}

O comando a seguir mostra todos os fluxos de log começando com o prefixo 2015 no grupo de logs my-logs:

aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015

Resultado:

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

O seguinte comando recupera eventos de logs de um fluxo de logs chamado 20150601 no grupo de logs my-logs:

aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601

Resultado:

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

O seguinte comando define eventos de logs de um fluxo de logs chamado 20150601 no grupo de logs my-logs:

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events

Resultado:

{
    "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}

O exemplo acima lê uma matriz JSON de eventos de um arquivo chamado events no 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-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"

Resultado:

{
    "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}

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-name my-logs --retention-in-days 5

O comando a seguir inicia uma sessão do Live Tail em um grupo de logs chamado my-logs:

aws logs start-live-tail --log-group-identifiers arn:aws:logs:us-east-1:111111222222:log-group:my-logs

O comando a seguir inicia uma sessão do Live Tail em um grupo de logs chamado my-logs no modo interativo:

aws logs start-live-tail --log-group-identifiers arn:aws:logs:us-east-1:111111222222:log-group:my-logs --mode interactive

No modo interativo, você pode destacar até cinco termos nos logs acompanhados. Os códigos de severidade são destacados por padrão. Pressione h para entrar no modo de destaque e, em seguida, digite os termos a serem destacados, um por vez, e pressione Enter. Pressione c para limpar o(s) termo(s) destacado(s). Pressione t para alternar a formatação entre JSON/texto simples. Pressione Esc para sair da sessão do Live Tail. Pressione as teclas up / down para rolar para cima ou para baixo entre os eventos de log, use Ctrl + u / Ctrl + d para rolar mais rápido. Pressione q para rolar até os eventos de log mais recentes.