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á.

# Monitoramento dos logs de pipeline
<a name="monitoring-pipeline-logs"></a>

Você pode ativar o registro nos pipelines de OpenSearch ingestão da Amazon para expor mensagens de erro e aviso geradas durante as operações do pipeline e a atividade de ingestão. OpenSearch A ingestão publica todos os registros no *Amazon CloudWatch * Logs. CloudWatch Os registros podem monitorar as informações nos arquivos de log e notificá-lo quando determinados limites forem atingidos. É possível também arquivar seus dados de log em armazenamento resiliente. Para obter mais informações, consulte o [Guia do usuário do Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).

Os registros da OpenSearch ingestão podem indicar falhas no processamento de solicitações, erros de autenticação da origem até o coletor e outros avisos que podem ser úteis para a solução de problemas. Para seus registros, a OpenSearch ingestão usa os níveis de registro de `INFO``WARN`,`ERROR`, e. `FATAL` Recomendamos habilitar a publicação de logs para todos os pipelines.

## Permissões obrigatórias
<a name="monitoring-pipeline-logs-permissions"></a>

Para permitir que o OpenSearch Inestion envie registros para o CloudWatch Logs, você precisa estar conectado como um usuário com determinadas permissões do IAM. 

Você precisa das seguintes permissões de CloudWatch registros para criar e atualizar os recursos de entrega de registros:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Resource": "*",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:PutResourcePolicy",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:DescribeResourcePolicies",
                "logs:GetLogDelivery",
                "logs:ListLogDeliveries"
            ]
        }
    ]
}
```

------

## Habilitar publicação de logs
<a name="monitoring-pipeline-logs-enable"></a>

Você pode ativar a publicação de logs em pipelines existentes ou ao criar um pipeline. Para ver as etapas para habilitar a publicação de logs durante a criação do pipeline, consulte [Como criar pipelines](creating-pipeline.md#create-pipeline).

### Console
<a name="monitoring-pipeline-logs-enable-console"></a>

**Para habilitar a publicação de logs em um pipeline existente**

1. Faça login no console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Você estará na página Pipelines.

1. Abra o pipeline no qual você deseja habilitar logs e escolha **Ações**, **Editar opções de publicação de log**.

1. Ative a opção **Publicar em CloudWatch registros**.

1. Crie um novo grupo de logs ou selecione um existente. Recomendamos que você formate o nome como um caminho, como `/aws/vendedlogs/OpenSearchIngestion/pipeline-name/audit-logs`. Esse formato facilita a aplicação de uma política de CloudWatch acesso que concede permissões a todos os grupos de registros em um caminho específico, como`/aws/vendedlogs/OpenSearchIngestion`.
**Importante**  
Você deve incluir o prefixo `vendedlogs` no nome do grupo de logs, caso contrário, a criação falhará.

1. Escolha **Salvar**.

### CLI
<a name="monitoring-pipeline-logs-enable-cli"></a>

Para habilitar a publicação de registros usando o AWS CLI, envie a seguinte solicitação:

```
aws osis update-pipeline \
  --pipeline-name my-pipeline \
  --log-publishing-options  IsLoggingEnabled=true,CloudWatchLogDestination={LogGroup="/aws/vendedlogs/OpenSearchIngestion/pipeline-name"}
```