Descarregar PostgreSQL e atualizar logs

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

Por padrão, o registo dos logs do servidor para download numa instância de servidor flexível do Azure Database para PostgreSQL está desabilitado. No entanto, depois de habilitar o recurso, sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL começa a capturar os logs do servidor para arquivos, que você pode baixar para inspeção detalhada. Pode usar o portal do Azure ou os comandos da CLI do Azure para listar e descarregar estes ficheiros que podem ajudá-lo em qualquer esforço de resolução de problemas.

Este artigo explica como ativar e desativar a funcionalidade. Também descreve como pode listar todos os logs de servidor disponíveis e como pode descarregar qualquer um deles.

Passos para ativar a captura de logs de PostgreSQL e de atualização para download

Portal

Usando o Azure portal:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, na secção Monitorização, selecione Registos do servidor.

   

3. Marque a caixa de seleção Capture logs for download.

   

4. Por padrão, os ficheiros de log são mantidos por três dias, mas pode ajustar o período de retenção de 1 a 7 dias. Utilize o Log retention period (in days) para ajustar à sua configuração desejada.

   

5. Selecione o botão Guardar.

   

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

   

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

   

CLI

Pode ativar a captura de registos do servidor PostgreSQL e registos de atualização das principais versões através do comando az postgres flexible-server parameter set.

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

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

Para ajustar o período de retenção dos registos capturados para download, utilize este comando:

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

Os valores permitidos para o parâmetro do servidor logfiles.retention_days podem estar entre 1 e 7 dias. Se tentar defini-lo para um valor diferente, 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 após ativar a captura de registos do servidor para download, o primeiro registo estará disponível para download.

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

Passos para desativar a captura de logs de PostgreSQL e a atualização para download

Portal

Usando o Azure portal:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, na secção Monitorização, selecione Registos do servidor.

   

3. Desmarque a caixa de seleção Registos de captura para download.

   

4. Selecione o botão Guardar.

   

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

   

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

   

CLI

Pode desativar a captura de logs do servidor PostgreSQL e logs de upgrades de versão principal através do comando az postgres flexible-server parameter set.

Para desativar a captura dos registos para download, utilize este comando:

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

Passos para listar logs capturados disponíveis para download

Portal

Usando o Azure portal:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, na secção Monitorização, selecione Registos do servidor.

   

3. Uma tabela mostra todos os ficheiros de log capturados que ainda não foram eliminados. Ficheiros que foram capturados em algum momento, mas foram eliminados porque excederam o período de retenção configurado, já não estão visíveis ou acessíveis. Utilizando as caixas Pesquisar por ficheiros com nomes que contêm, Intervalo de tempo e Tipo de registo, pode definir condições de filtragem para reduzir os registos apresentados. Ao selecionar um cabeçalho de coluna, pode ordenar a lista de ficheiros de registo visíveis, em ordem ascendente ou descendente, pelo valor do atributo representado pelo cabeçalho selecionado. Sob cada coluna disponível, pode ver os diferentes atributos de cada ficheiro.

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

   

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

   

CLI

Pode listar os registos capturados do servidor PostgreSQL e os registos de atualizações da versão principal através do comando az postgres flexible-server server-logs list.

Para listar todos os registos capturados disponíveis para download, que foram atualizados nas últimas 72 horas (valor predefinido), utilize este comando:

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

Para listar todos os registos 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 registos capturados disponíveis para download, cujo tamanho seja inferior a 30 KiB, utilize este comando:

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

Para listar todos os registos 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

Passos para descarregar registos capturados

Portal

Usando o Azure portal:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, na secção Monitorização, selecione Registos do servidor.

   

3. Uma tabela mostra todos os ficheiros de log capturados que ainda não foram eliminados. Ficheiros que foram capturados em algum momento, mas foram eliminados porque excederam o período de retenção configurado, já não estão visíveis ou acessíveis. Utilizando as caixas Pesquisar por ficheiros com nomes que contêm, Intervalo de tempo e Tipo de registo, pode definir condições de filtragem para reduzir os registos apresentados. Ao selecionar um cabeçalho de coluna, pode ordenar a lista de ficheiros de registo visíveis, em ordem ascendente ou descendente, pelo valor do atributo representado pelo cabeçalho selecionado. Identifique o registo que deseja descarregar e, na coluna Ações, selecione Descarregar.

   

4. Se quiser descarregar vários ficheiros de registo de uma só vez, selecione todos os ficheiros que pretende descarregar e, na barra de ferramentas, escolha Descarregar.

   

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

   

CLI

Pode descarregar os logs capturados do servidor PostgreSQL e os logs de atualização da versão principal através do comando az postgres flexible-server server-logs download.

Para descarregar 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 descarregar 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 ficheiro fornecidos, para os quais existam ficheiros de registos com nomes correspondentes disponíveis para descarregar, é criado um ficheiro local com o mesmo nome e conteúdos.

• Se algum dos nomes de ficheiro fornecidos não estiver disponível para download, o comando não reporta nenhum erro. Simplesmente não descarrega esse ficheiro.

Conteúdo Relacionado

• Configure a alta disponibilidade.
• Configure a manutenção agendada.
• Criar alertas em métricas usando o portal.