Share via


Solução de problemas de servidores PostgreSQL

Este artigo descreve algumas técnicas que você pode usar para solucionar problemas do seu grupo de servidores. Além deste artigo, você pode querer ler como usar o Kibana para pesquisar os logs ou usar o Grafana para visualizar métricas sobre seu grupo de servidores.

Obter mais detalhes sobre a execução de um comando CLI

Você pode adicionar o parâmetro --debug a qualquer comando da CLI executado. Isso exibirá no console informações adicionais sobre a execução desse comando. Você deve achar útil obter detalhes para ajudá-lo a entender o comportamento desse comando. Por exemplo, você pode executar

az postgres server-arc create -n postgres01 -w 2 --debug --k8s-namespace <namespace> --use-k8s

ou

az postgres server-arc update -n postgres01 --extension --k8s-namespace <namespace> --use-k8s SomeExtensionName --debug

Além disso, você pode usar o parâmetro --help em qualquer comando da CLI para exibir alguma ajuda, lista de parâmetros para um comando específico. Por exemplo:

az postgres server-arc create --help

Coletando logs do controlador de dados e seus grupos de servidores

Leia o artigo sobre como obter logs para serviços de dados habilitados para Azure Arc

Solução de problemas interativa com blocos de anotações Jupyter no Azure Data Studio

Os blocos de notas podem documentar procedimentos ao incluir o conteúdo de markdown para descrever o que fazer/como o fazer. Além disso, podem disponibilizar código executável para automatizar um procedimento. Este padrão é útil para tudo, desde procedimentos operacionais padrão a guias de resolução de problemas.

Por exemplo, vamos solucionar problemas de um servidor PostgreSQL que pode ter alguns problemas usando o Azure Data Studio.

Nota

Como funcionalidade de pré-visualização, a tecnologia apresentada neste artigo está sujeita aos Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.

As atualizações mais recentes estão disponíveis nas notas de versão.

Neste momento, use a compilação de insiders do Azure Data Studio.

Instalar ferramentas

Instale o Azure Data Studio e a CLI do Azure (az) com a arcdata extensão na máquina cliente que você está usando para executar o bloco de anotações no Azure Data Studiokubectl. Para fazer isso, siga as instruções em Instalar ferramentas de cliente

Atualizar a variável de ambiente PATH

Certifique-se de que essas ferramentas podem ser invocadas de qualquer lugar nesta máquina cliente. Por exemplo, em uma máquina cliente Windows, atualize a variável de ambiente do sistema PATH e adicione a pasta na qual você instalou o kubectl.

Faça login no seu cluster Kubernetes com kubectl

Para fazer isso, você pode querer usar os comandos de exemplo fornecidos nesta postagem do blog. Você executaria comandos como:

kubectl config view
kubectl config set-credentials kubeuser/my_kubeuser --username=<your Arc Data Controller Admin user name> --password=<password>
kubectl config set-cluster my_kubeuser --server=https://<IP address>:<port>
kubectl config set-context default/my_kubeuser/ArcDataControllerAdmin --user=ArcDataControllerAdmin/my_kubeuser --namespace=arc --cluster=my_kubeuser
kubectl config use-context default/my_kubeuser/ArcDataControllerAdmin

O bloco de notas de resolução de problemas

Inicie o Azure Data Studio e abra o bloco de anotações de solução de problemas.

Implemente as etapas descritas em 033-manage-Postgres-with-AzureDataStudio.md para:

  1. Conecte-se ao seu Arc Data Controller
  2. Selecione com o botão direito do mouse sua instância do Postgres e escolha [Gerenciar]
  3. Selecione o painel [Diagnosticar e resolver problemas]
  4. Selecione o link [Solução de problemas]

Azure Data Studio - Open PostgreSQL troubleshooting Notebook

O TSG100 - O bloco de anotações de solução de problemas do servidor PostgreSQL habilitado para Azure Arc abre: Azure Data Studio - Use PostgreSQL troubleshooting notebook

Executar os scripts

Selecione o botão 'Executar tudo' na parte superior para executar o bloco de notas de uma só vez, ou pode percorrer e executar cada célula de código, uma a uma.

Visualize a saída da execução das células de código para quaisquer problemas potenciais.

Ao longo do tempo, adicionaremos mais detalhes ao bloco de anotações sobre como reconhecer problemas comuns e como resolvê-los.

Próximo passo