Coletores - Amazon CloudWatch
Requisitos e limitações

Coletores

Os coletores definem o destino para onde os dados de log processados são enviados. Cada pipeline deve ter exatamente um coletor. No momento, apenas o coletor do CloudWatch Logs é compatível.

Comportamento do coletor por tipo de fonte
Source type (Tipo de origem) Configuração do grupo de logs Comportamento
CloudWatch Logs Deve usar @original Os eventos são sempre retornados a seu grupo de logs original
S3 Caminho de grupo de logs personalizado Os eventos são enviados ao grupo de logs especificado
APIs de terceiros Caminho de grupo de logs personalizado Os eventos são enviados ao grupo de logs especificado
Configuração

Configure o coletor com os seguintes parâmetros:

exemplo Configuração de fonte fora do CloudWatch Logs
sink:
  cloudwatch_logs:
    log_group: "/aws/my-application/logs"
exemplo configuração de fonte do CloudWatch Logs
sink:
  cloudwatch_logs:
    log_group: "@original"
Parâmetros
log_group (obrigatório)

O nome do grupo de logs do CloudWatch Logs para onde os eventos processados serão enviados. Para pipelines com fontes fora do cloudwatch_logs, esse deve ser o nome de um grupo de logs existente. Para pipelines que usam a fonte cloudwatch_logs, o ÚNICO valor permitido é @original.

Requisitos e limitações

Existência do grupo de logs

Se ele for criado usando o Console de gerenciamento da AWS, o CloudWatch tentará criar o grupo de logs especificado e a política de recurso apropriada se ela não existir ao usar uma fonte de logs fora do CloudWatch. Do contrário, o grupo de logs especificado já deverá existir quando o pipeline for criado.

Tamanho do evento

Cada evento de logs não pode exceder 256 KB após o processamento.

Retenção de grupo de logs

O pipeline usa as configurações de retenção definidas no grupo de logs de destino.

Política de recursos do grupo de logs

As políticas de recursos do CloudWatch Logs são obrigatórias para pipelines que gravam em grupos de logs, exceto os que usam a fonte cloudwatch_logs. Quando você usa o Console de gerenciamento da AWS para configurar o pipeline, o CloudWatch tenta adicionar a política de recurso, se necessário. Se você for criar o pipeline usando o AWS CLI ou uma API, deverá criar a política manualmente e adicioná-la usando a solicitação logs:PutResourcePolicy. Para saber mais, consulte Políticas de recursos.

Suporte entre regiões

O grupo de logs de destino deve estar na mesma região que o pipeline.

Importante

Para pipelines que usam o tipo de fonte cloudwatch_logs:

  • Você deve usar @original como o valor do grupo de logs.

  • Os eventos são sempre retornados ao grupo de logs original.

  • O grupo de logs original deve ser existir durante todo o ciclo de vida do pipeline.

  • Pipelines com processadores modificam os eventos de logs no grupo de logs original do CloudWatch de onde são interceptados, para logs provenientes de serviços da AWS.

nota

Os eventos de log estão sujeitos às cotas e limitações do CloudWatch Logs.