Arquivos de log do banco de dados do Amazon RDS - Amazon Relational Database Service

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:

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