Configurar a captura de logs do servidor PostgreSQL e logs de atualização de versão principal

APLICA-SE A: Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Você pode usar os logs do servidor PostgreSQL para diagnosticar problemas específicos experimentados em um servidor flexível do Banco de Dados do Azure para PostgreSQL e para obter informações detalhadas sobre as atividades executadas em seus servidores. Você pode usar os logs de atualização da versão principal para solucionar erros que podem ocorrer durante uma tentativa de atualizar seu servidor para uma versão principal superior do PostgreSQL.

Por padrão, a captura de logs do servidor para download em um servidor flexível do Banco de Dados do Azure para PostgreSQL está desabilitada. No entanto, depois de habilitar o recurso, seu servidor flexível do Banco de Dados do Azure para PostgreSQL começa a capturar os logs do servidor em arquivos, que você pode baixar para inspeção detalhada. Você pode usar o portal do Azure ou os comandos da CLI do Azure para listar e baixar esses arquivos que podem ajudá-lo com quaisquer esforços de solução de problemas.

Este artigo explica como ativar e desativar o recurso. Ele também descreve como você pode listar todos os logs de servidor disponíveis e como você pode baixar qualquer um deles.

Habilite a captura de logs do servidor PostgreSQL e logs de atualização de versão principal para download

Portal

Usando o portal do Azure:

1. Selecione seu Banco de Dados do Azure para servidor flexível PostgreSQL.

2. No menu de recursos, na seção Monitoramento , selecione Logs do servidor.

   

3. Em Baixar logs do servidor, marque a caixa de seleção Ativar .

   

4. Por padrão, os arquivos de log são retidos por três dias, mas você pode ajustar o período de retenção de 1 a 7 dias. Use a segmentação de dados Período de retenção (em dias) para ajustar a configuração desejada.

   

5. Selecione o botão Save.

   

6. Uma notificação informa que o serviço está configurando a captura de logs para download.

   

7. Quando a operação termina, uma notificação informa que o serviço concluiu a configuração da captura de logs para download.

   

CLI

Você pode habilitar a captura de logs do servidor PostgreSQL e logs de atualização de versão principal por meio do comando az postgres flexible-server parameter set .

Para habilitar a captura dos logs para download, use este comando:

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.download_enable --value on

Para ajustar o período de retenção para os logs capturados para download, use este comando:

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.retention_days --value <retention_period_in_days>

Os valores permitidos para o parâmetro logfiles.retention_days server podem ser entre 1 e 7 dias. Se você tentar defini-lo para um valor diferente, você receberá este erro:

Code: ServerParameterToCMSUnAllowedParameterValue
Message: The value: [<value>] of Server Parameter: [logfiles.retention_days] is invalid, the allowed values are: [1-7]

Nota

• Alguns minutos depois de ativar a captura de logs do servidor para download, o primeiro log estará disponível para download.

• Inicialmente, e por aproximadamente uma hora, os logs do servidor ocupam espaço em disco de dados. Em seguida, eles são movidos para o armazenamento de backup e mantidos lá pelo período de retenção configurado.

Desative a captura de logs do servidor PostgreSQL e logs de atualização de versão principal para download

Portal

Usando o portal do Azure:

1. Selecione seu Banco de Dados do Azure para servidor flexível PostgreSQL.

2. No menu de recursos, na seção Monitoramento , selecione Logs do servidor.

   

3. Em Baixar logs do servidor, desmarque a caixa de seleção Ativar .

   

4. Selecione o botão Save.

   

5. Uma notificação informa que o serviço está configurando a captura de logs para download.

   

6. Quando a operação termina, uma notificação informa que o serviço concluiu a configuração da captura de logs para download.

   

CLI

Você pode desabilitar a captura de logs do servidor PostgreSQL e logs de atualização de versão principal por meio do comando az postgres flexible-server parameter set .

Para desativar a captura dos logs para download, use este comando:

az postgres flexible-server parameter --resource-group <resource_group> --server-name <server> --name logfiles.download_enable --value off

Listar logs capturados disponíveis para download

Portal

Usando o portal do Azure:

1. Selecione seu Banco de Dados do Azure para servidor flexível PostgreSQL.

2. No menu de recursos, na seção Monitoramento , selecione Logs do servidor.

   

3. Uma tabela mostra todos os arquivos de log capturados que ainda não foram excluídos. Os arquivos que foram capturados em algum momento, mas foram excluídos porque excederam o período de retenção configurado, não são mais visíveis ou acessíveis. Usando as caixas Pesquisar um arquivo de log, Intervalo de tempo de log e Tipo de log, você pode definir condições de filtragem para reduzir os logs mostrados. Ao selecionar um cabeçalho de coluna, você pode classificar a lista de arquivos de log visíveis, em ordem crescente ou decrescente, pelo valor do atributo representado pelo cabeçalho selecionado. Em cada coluna disponível, você pode ver os diferentes atributos de cada arquivo:

   • Nome: Nome do arquivo de log. O serviço atribui a cada arquivo de log um nome com esse padrão postgresql_yyyy_mm_dd_hh_00_00.log.
   • Última hora de atualização: carimbo de data/hora da última vez que cada arquivo de log foi carregado. Os arquivos de log são carregados, aproximadamente, a cada 10 minutos.
   • Tamanho: Tamanho em bytes ocupado pelo arquivo de log.
   • Tipo de Log: O Log do Servidor indica que o arquivo corresponde a um log do servidor PostgreSQL. O Log de Atualização indica que o arquivo corresponde a um log de atualização da versão principal.

   

4. O conteúdo da tabela não é atualizado automaticamente. Para ver as informações mais recentes, selecione Atualizar.

   

CLI

Você pode listar os logs capturados do servidor PostgreSQL e os logs de atualização da versão principal por meio do comando az postgres flexible-server server-logs list.

Para listar todos os logs capturados disponíveis para download, que foram atualizados nas últimas 72 horas (valor padrão), use este comando:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server>

Para listar todos os logs capturados disponíveis para download, que foram atualizados nas últimas 10 horas, use este comando:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --file-last-written 10

Para listar todos os logs capturados disponíveis para download, cujo tamanho é inferior a 30 KiB, use este comando:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --max-file-size 30

Para listar todos os logs capturados disponíveis para download, cujo nome contém 01_07, use este comando:

az postgres flexible-server server-logs list --resource-group <resource_group> --server-name <server> --filename-contains 01_07

Baixar logs capturados disponíveis para download

Portal

Usando o portal do Azure:

1. Selecione seu Banco de Dados do Azure para servidor flexível PostgreSQL.

2. No menu de recursos, na seção Monitoramento , selecione Logs do servidor.

   

3. Uma tabela mostra todos os arquivos de log capturados que ainda não foram excluídos. Os arquivos que foram capturados em algum momento, mas foram excluídos porque excederam o período de retenção configurado, não são mais visíveis ou acessíveis. Usando as caixas Pesquisar um arquivo de log, Intervalo de tempo de log e Tipo de log, você pode definir condições de filtragem para reduzir os logs mostrados. Ao selecionar um cabeçalho de coluna, você pode classificar a lista de arquivos de log visíveis, em ordem crescente ou decrescente, pelo valor do atributo representado pelo cabeçalho selecionado. Identifique o registo que pretende transferir e, na coluna Ações , selecione Transferir.

   

4. Se quiser baixar vários arquivos de log ao mesmo tempo, selecione todos os arquivos que deseja baixar e selecione Download na barra de ferramentas.

   

5. O conteúdo da tabela não é atualizado automaticamente. Para ver as informações mais recentes, selecione Atualizar.

   

CLI

Você pode baixar os logs capturados do servidor PostgreSQL e os logs de atualização da versão principal por meio do comando az postgres flexible-server server-logs download .

Para baixar um log específico, use este comando:

az postgres flexible-server server-logs download --resource-group <resource_group> --server-name <server> --name <log_name>

Para baixar um log específico, use este comando:

az postgres flexible-server server-logs download --resource-group <resource_group> --server-name <server> --name <log1_name log2_name ...logn_name>

Nota

• Para os nomes de arquivo fornecidos para os quais há arquivos de log com nomes correspondentes disponíveis para download, um arquivo local é criado com o mesmo nome e conteúdo.

• Se algum dos nomes de arquivo fornecidos não estiver disponível para download, o comando não relatará nenhum erro. Ele simplesmente não baixa esse arquivo.

Partilhe as suas sugestões e bugs com a equipa de produto da Base de Dados do Azure para PostgreSQL.

Conteúdos relacionados

• Reinicie uma instância do Banco de Dados do Azure para servidor flexível PostgreSQL.
• Inicie uma instância do Banco de Dados do Azure para servidor flexível PostgreSQL.
• Pare uma instância do Banco de Dados do Azure para servidor flexível PostgreSQL.
• Reinicie uma instância do Banco de Dados do Azure para servidor flexível PostgreSQL.
• Opções de computação no Banco de Dados do Azure para PostgreSQL - Servidor Flexível.
• Opções de armazenamento no Banco de Dados do Azure para PostgreSQL - Servidor Flexível.
• Limites no Banco de Dados do Azure para PostgreSQL - Servidor Flexível.