# Ativar a opção de publicação de logs no Amazon CloudWatch
<a name="AuroraPostgreSQL.CloudWatch.Publishing"></a>

Para publicar um log do PostgreSQL do seu cluster de banco de dados do Aurora PostgreSQL no CloudWatch Logs, escolha a opção **Log export** (Exportação de logs) para o cluster. Você pode escolher a configuração Log export (Exportação de logs) ao criar um cluster de banco de dados do Aurora PostgreSQL. Ou você pode modificar o cluster posteriormente. Quando você modifica um cluster existente, seus logs do PostgreSQL de cada instância são publicados no cluster do CloudWatch a partir desse momento. Para o Aurora PostgreSQL, o log do PostgreSQL (`postgresql.log`) é o único log que é publicado no Amazon CloudWatch. 

Você pode usar o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS para ativar o recurso de exportação de logs para seu cluster de banco de dados do Aurora PostgreSQL. 

## Console
<a name="AuroraPostgreSQL.CloudWatch.Console"></a>

Você escolhe a opção de exportação de logs para começar a publicar os logs do PostgreSQL do seu cluster de banco de dados do Aurora PostgreSQL no CloudWatch Logs.

**Como ativar o recurso de exportação de logs pelo console**

1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Databases (Bancos de dados)**.

1. Selecione o cluster de banco de dados do Aurora PostgreSQL cujos dados de log você deseja publicar no CloudWatch Logs.

1. Selecione **Modify**.

1. Na seção **Log exports** (Exportações de log), selecione **PostgreSQL log** (Log do PostgreSQL).

1. Escolha **Continue (Continuar)** e **Modify cluster (Modificar cluster)** na página de resumo.

## AWS CLI
<a name="AuroraPostgreSQL.CloudWatch.CLI"></a>

Você pode ativar a opção de exportação de logs para começar a publicar logs do Aurora PostgreSQL no Amazon CloudWatch Logs com a AWS CLI. Para isso, execute o comando [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da AWS CLI com as seguintes opções: 
+ `--db-cluster-identifier`—O identificador de cluster de banco de dados.
+ `--cloudwatch-logs-export-configuration` – a definição de configuração para os tipos de log a serem definidos para exportação no CloudWatch Logs para cluster de banco de dados.

Também é possível publicar logs do Aurora PostgreSQL executando um dos seguintes comandos da AWS CLI: 
+ [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html)
+ [restore-db-cluster-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-s3.html)
+ [restore-db-cluster-from-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-snapshot.html)
+ [restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)

Execute um destes comandos da AWS CLI com as seguintes opções:
+ `--db-cluster-identifier`—O identificador de cluster de banco de dados.
+ `--engine` — o mecanismo de banco de dados.
+ `--enable-cloudwatch-logs-exports` — a definição de configuração para os tipos de log a serem habilitados para exportação para o CloudWatch Logs para cluster de banco de dados.

Outras opções podem ser exigidas dependendo do comando da AWS CLI que você executa.

**Example**  
O comando a seguir cria um cluster de banco de dados Aurora PostgreSQL para publicar arquivos de log no CloudWatch Logs.  
Para Linux, macOS ou Unix:  

```
1. aws rds create-db-cluster \
2.     --db-cluster-identifier {{my-db-cluster}} \
3.     --engine aurora-postgresql \
4.     --enable-cloudwatch-logs-exports postgresql
```
Para Windows:  

```
1. aws rds create-db-cluster ^
2.     --db-cluster-identifier {{my-db-cluster}} ^
3.     --engine aurora-postgresql ^
4.     --enable-cloudwatch-logs-exports postgresql
```

**Example**  
O comando a seguir altera um cluster existente do banco de dados Aurora PostgreSQL para publicar arquivos de log no CloudWatch Logs. O valor `--cloudwatch-logs-export-configuration` é um objeto JSON. A chave para esse objeto é `EnableLogTypes`, e seu valor é `postgresql` e `instance`.  
Para Linux, macOS ou Unix:  

```
1. aws rds modify-db-cluster \
2.     --db-cluster-identifier {{my-db-cluster}} \
3.     --cloudwatch-logs-export-configuration '{"EnableLogTypes":["postgresql","instance"]}'
```
Para Windows:  

```
1. aws rds modify-db-cluster ^
2.     --db-cluster-identifier {{my-db-cluster}} ^
3.     --cloudwatch-logs-export-configuration '{\"EnableLogTypes\":[\"postgresql\",\"instance\"]}'
```
Ao utilizar o prompt de comando do Windows, certifique-se de fazer o escape das aspas duplas (") no código JSON, prefixando-as com uma barra invertida (\\).

**Example**  
O exemplo a seguir modifica um cluster de banco de dados Aurora PostgreSQL existente para desativar a publicação de arquivos de log no CloudWatch Logs. O valor `--cloudwatch-logs-export-configuration` é um objeto JSON. A chave para esse objeto é `DisableLogTypes`, e seu valor é `postgresql` e `instance`.  
Para Linux, macOS ou Unix:  

```
aws rds modify-db-cluster \
    --db-cluster-identifier {{mydbinstance}} \
    --cloudwatch-logs-export-configuration '{"DisableLogTypes":["postgresql","instance"]}'
```
Para Windows:  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier {{mydbinstance}} ^
    --cloudwatch-logs-export-configuration "{\"DisableLogTypes\":[\"postgresql\",\"instance\"]}"
```
Ao usar o prompt de comando do Windows, você deve fazer o escape das aspas duplas (") no código JSON, prefixando-as com uma barra invertida (\\).

## API do RDS
<a name="AuroraPostgreSQL.CloudWatch.API"></a>

Você pode ativar a opção de exportação de logs para começar a publicar logs do Aurora PostgreSQL com a API do RDS. Para isso, execute a operação [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) com as seguintes opções: 
+ `DBClusterIdentifier` – o identificador de cluster de banco de dados.
+ `CloudwatchLogsExportConfiguration` – a definição de configuração para os tipos de log a serem habilitados para exportação no CloudWatch Logs para o cluster de banco de dados.

Também é possível publicar logs do Aurora PostgreSQL com a API do RDS executando uma das seguintes operações da API do RDS: 
+ [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)
+ [RestoreDBClusterFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromS3.html)
+ [RestoreDBClusterFromSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html)
+ [RestoreDBClusterToPointInTime](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterToPointInTime.html)

Execute a ação da API do RDS com os seguintes parâmetros: 
+ `DBClusterIdentifier`—O identificador de cluster de banco de dados.
+ `Engine` — o mecanismo de banco de dados.
+ `EnableCloudwatchLogsExports` — a definição de configuração para os tipos de log a serem habilitados para exportação para o CloudWatch Logs para cluster de banco de dados.

Outros parâmetros podem ser exigidos dependendo do comando da AWS CLI que você executa.