Arquivos de log do banco de dados do Amazon RDS - Amazon Relational Database Service
Como exibir e listar arquivos de log do banco de dadosComo fazer download de um arquivo de log de banco de dadosComo observar um arquivo de log de banco de dadosPublicação no CloudWatch LogsLeitura do conteúdo de arquivos de log usando REST

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

Arquivos de log do banco de dados do Amazon RDS

É possível visualizar, fazer download e observar os logs de banco de dados usando o Console de gerenciamento da AWS, a AWS Command Line Interface (AWS CLI) ou a API do Amazon RDS. Não há suporte para visualização, download ou observação de logs de transação.

Para obter informações específicas sobre o mecanismo, consulte:

Como exibir e listar arquivos de log do banco de dados

É possível visualizar arquivos de log de banco de dados do mecanismo de banco de dados usando o Console de gerenciamento da AWS. Você pode listar quais arquivos de log estão disponíveis para fazer download ou monitoramento usando a AWS CLI ou a API do Amazon RDS.

nota

Se você não encontrar a lista de arquivos de log para uma instância de banco de dados Oracle existente, reinicie a instância para visualizar a lista.

Para visualizar um arquivo de log de banco de dados

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

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

  3. Escolha o nome da instância de banco de dados que contém o arquivo de log que você deseja exibir.

  4. Escolha a guia Logs & events (Logs e eventos).

  5. Role para baixo até a seção Logs.

  6. Na seção Logs, escolha o log que você deseja exibir e View (Exibir).

Para listar os arquivos de log do banco de dados disponíveis para uma instância de banco de dados, use o comando describe-db-log-files da AWS CLI.

O exemplo a seguir retorna uma lista de arquivos de log para uma instância de banco de dados nomeada my-db-instance.

exemplo 

aws rds describe-db-log-files --db-instance-identifier my-db-instance

Para listar os arquivos de log disponíveis do banco de dados para uma instância de banco de dados, use a ação DescribeDBLogFiles da API do Amazon RDS.

Como fazer download de um arquivo de log de banco de dados

É possível usar o Console de gerenciamento da AWS, a AWS CLI ou a API para fazer download de um arquivo de log de banco de dados.

Para fazer download de um arquivo de log de banco de dados

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

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

  3. Escolha o nome da instância de banco de dados que contém o arquivo de log que você deseja exibir.

  4. Escolha a guia Logs & events (Logs e eventos).

  5. Role para baixo até a seção Logs.

  6. Na seção Logs, escolha o botão próximo ao log do qual você deseja fazer download e escolha Download.

  7. Abra o menu de contexto (clique com o botão direito do mouse) para o link fornecido e escolha Save Link As (Salvar link como). Informe o local onde você deseja salvar o arquivo de log e escolha Save (Salvar).

    como visualizar arquivos de log

Para fazer download de um arquivo de log de banco de dados, use o comando download-db-log-file-portion da AWS CLI. Por padrão, esse comando faz download apenas da parte mais recente de um arquivo de log. No entanto, faça download de um arquivo inteiro especificando o parâmetro --starting-token 0.

O exemplo a seguir mostra como fazer download do conteúdo inteiro de um arquivo de log denominado log/ERROR.4 e armazená-lo em um arquivo local denominado errorlog.txt.

exemplo

Para Linux, macOS ou Unix:

aws rds download-db-log-file-portion \
						--db-instance-identifier myexampledb \
						--starting-token 0 --output text \
						--log-file-name log/ERROR.4 > errorlog.txt

Para Windows:

aws rds download-db-log-file-portion ^
						--db-instance-identifier myexampledb ^
						--starting-token 0 --output text ^
						--log-file-name log/ERROR.4 > errorlog.txt

Para fazer download de um arquivo de log de banco de dados, use a ação DownloadDBLogFilePortion da API do Amazon RDS.

Como observar um arquivo de log de banco de dados

É possível monitorar o conteúdo de um arquivo de log usando o Console de gerenciamento da AWS.

Console

Para observar um arquivo de log de banco de dados

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

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

  3. Escolha o nome da instância de banco de dados que contém o arquivo de log que você deseja exibir.

  4. Escolha a guia Logs & events (Logs e eventos).

  5. Na seção Logs, escolha um arquivo de log e Watch (Observar).

Publicação de logs de banco de dados no Amazon CloudWatch Logs

Além de visualizar e baixar os logs de instância de Banco de Dados, você também pode publicar os logs no Amazon CloudWatch Logs. Com o CloudWatch Logs, é possível executar uma análise em tempo real dos dados em log, armazenar os dados em um armazenamento resiliente e gerenciar os dados com o agente do CloudWatch Logs. A AWS retém os dados de log publicados no CloudWatch Logs por um período indefinido, a menos que você especifique um período de retenção. Para obter mais informações, consulte Alterar a retenção de dados de log no CloudWatch Logs.

Para obter informações específicas sobre o mecanismo, consulte:

Leitura do conteúdo de arquivos de log usando REST

O Amazon RDS fornece um endpoint REST que permite acesso aos arquivos de log de instâncias de banco de dados. Isso é útil para gravar um aplicativo para transmitir o conteúdo do arquivo de log do Amazon RDS.

A sintaxe é:

GET /v13/downloadCompleteLogFile/DBInstanceIdentifier/LogFileName HTTP/1.1
Content-type: application/json
host: rds.region.amazonaws.com

Os seguintes parâmetros são obrigatórios:

  • DBInstanceIdentifier – o nome da instância de banco de dados que contém o arquivo de log do qual você deseja fazer download.

  • LogFileName – o nome do arquivo de log que será obtido por download.

A resposta contém o conteúdo do arquivo de log solicitado, como um fluxo.

O exemplo a seguir faz download do arquivo de log chamado log/ERROR.6 para a instância de banco de dados chamada sample-sql na região us-west-2. 

GET /v13/downloadCompleteLogFile/sample-sql/log/ERROR.6 HTTP/1.1
host: rds.us-west-2.amazonaws.com
X-Amz-Security-Token: AQoDYXdzEIH//////////wEa0AIXLhngC5zp9CyB1R6abwKrXHVR5efnAVN3XvR7IwqKYalFSn6UyJuEFTft9nObglx4QJ+GXV9cpACkETq=
X-Amz-Date: 20140903T233749Z
X-Amz-Algorithm: AWS4-HMAC-SHA256
X-Amz-Credential: AKIADQKE4SARGYLE/20140903/us-west-2/rds/aws4_request
X-Amz-SignedHeaders: host
X-Amz-Content-SHA256: e3b0c44298fc1c229afbf4c8996fb92427ae41e4649b934de495991b7852b855
X-Amz-Expires: 86400
X-Amz-Signature: 353a4f14b3f250142d9afc34f9f9948154d46ce7d4ec091d0cdabbcf8b40c558

Se você especificar uma instância de banco de dados não existente, a resposta consistirá no erro a seguir:

  • DBInstanceNotFound – DBInstanceIdentifier não se refere a uma instância de banco de dados existente. (Código de status HTTP: 404)