Painel de controlo do servidor

O painel do servidor na extensão PostgreSQL mostra detalhes da ligação PostgreSQL, métricas de desempenho em tempo real e histórico, e ferramentas de gestão suportadas. Podes monitorizar a atividade do servidor, abrir consultas, iniciar o visualizador de esquema e aceder à configuração do servidor Azure, tudo isto sem sair do editor. O painel de controlo funciona da mesma forma no Visual Studio Code e no Cursor; apenas o painel de chat de IA que se abre a partir dos botões de IA do painel é diferente.

Gorjeta

Configura primeiro a ligação ao teu servidor. Ver Ligações e identidade. Para ações de gestão específicas do Azure disponíveis no dashboard, consulte Azure Server management.

Abrir o painel do servidor

  1. Na árvore de Conexões , clique com o botão direito num nó do servidor.
  2. Selecione Dashboard.

O dashboard abre num separador chamado <profileName> - Dashboard e mostra o cabeçalho da página <connectionLabel> | Dashboard de Desempenho.

Note

O painel do servidor é uma funcionalidade de pré-visualização ativada por defeito. Para desativar, defina pgsql.enableServerDashboard como false nas definições do Código VS.

Cartão de detalhes do servidor

O topo do painel mostra um cartão de detalhes que resume a ligação atual.

Campo Description
Server O endereço do servidor PostgreSQL.
Version A versão PostgreSQL reportada pelo servidor.
Porto A porta TCP usada para a ligação (a predefinição é 5432).
User O utilizador autenticado para esta ligação.
Base de Dados Padrão A base de dados de destino da ligação (por defeito, postgres).
State (Azure apenas) O estado atual do Base de Dados do Azure para PostgreSQL servidor flexível, como Pronto, Parado ou Início. Selecione o botão de atualização ao lado do valor para atualizar o estado.

Note

O campo Estado aparece apenas para ligações flexíveis de servidor no Base de Dados do Azure para PostgreSQL.

Barra de ferramentas

A barra de ferramentas no topo do painel proporciona acesso rápido a operações comuns. Alguns botões aparecem apenas quando certas condições são cumpridas.

Ações de ligação

Button Description
Conectar Aparece quando o servidor é desligado. Seleciona-o para restabelecer a ligação. Durante a ligação, o botão muda para Conectar....
Ações>Desligar Desliga-te do servidor. Disponível no menu suspenso da lista de Ações quando estás ligado.

Quando o servidor é desligado, os botões relacionados com a base de dados na barra de ferramentas são desativados e mostram a dica de ferramenta: "É necessária uma ligação à base de dados. Liga-te à base de dados para ativar esta funcionalidade."

Ações da base de dados

Button Description
Nova consulta Abra um novo editor de consultas ligado a uma base de dados neste servidor. Um seletor de base de dados permite-lhe escolher a base de dados alvo.
Connect AI / Connect Copilot Abra uma sessão no modo Agente limitada ao esquema e aos dados deste servidor. O painel de chat que se abre é o GitHub Copilot Chat no Visual Studio Code e o painel de IA nativo do Cursor, no Cursor. Ver integração com o Copilot.
Visualizar o esquema Inicie o visualizador de esquemas para uma base de dados neste servidor. Um seletor de base de dados permite-lhe escolher a base de dados alvo. Ver visualizador de esquema.

Ações do servidor Azure

Para ligações flexíveis ao servidor Base de Dados do Azure para PostgreSQL, o menu da lista suspensa de Ações inclui operações do ciclo de vida do servidor e a barra de ferramentas mostra um botão adicional do portal.

Button Description
Ações>Início Inicie um servidor Azure parado.
Ações>Pára Parar um servidor Azure em execução. Parar desloca recursos de computação e pausa a faturação computacional.
Ações>Reiniciar Reinicie o servidor Azure. Usa isto depois de alterares parâmetros que exijam reinício.
portal do Azure Abra o painel de gestão do servidor no portal do Azure no seu navegador predefinido.

Note

As ações de Iniciar, Parar e Reiniciar requerem permissões apropriadas de controlo de acesso baseado em papéis (RBAC) do Azure sobre o recurso do servidor.

Menu de Definições do Servidor

Para ligações Azure suportadas, aparece um botão de lista suspensa de Definições do Servidor na barra de ferramentas. Proporciona navegação para páginas de gestão do Azure que abrem dentro do VS Code.

Item de menu Description
Configuração da Rede Para o servidor flexível do Base de Dados do Azure para PostgreSQL, veja e modifique as regras de firewall e as definições de acesso público. Para o Azure HorizonDB (Pré-visualização), visualize e modifique as regras de firewall e o acesso aos serviços do Azure.
Parâmetros do Servidor Navegue e atualize os parâmetros do PostgreSQL (tanto estáticos como dinâmicos).
Backups Consulte o histórico de cópias de segurança e configure políticas de retenção de cópias de segurança.
Registos do Servidor Acede e descarregue os registos do servidor PostgreSQL para resolução de problemas.
Servidor clonado Clone o servidor Azure a partir de um ponto de backup.

As ligações ao servidor flexível do Base de Dados do Azure para PostgreSQL podem mostrar o menu completo. As ligações Azure HorizonDB (Preview) podem mostrar a Configuração de Rede quando a ligação tem a identidade completa do recurso Azure e do pool. Parâmetros, cópias de segurança, registos do servidor, clonagem e ações de ciclo de vida não estão disponíveis para ligações de Azure HorizonDB (Preview).

Note

O botão de Definições do Servidor aparece apenas quando a extensão deteta metadados do Azure para o servidor e pelo menos uma página de definições está disponível.

Pedido de metadados do Azure

Quando a extensão deteta que um servidor parece ser um recurso suportado pela Base de Dados do Azure para PostgreSQL, mas os metadados do Azure ainda não estão disponíveis, aparece um aviso de Azure Server Detectado na barra de ferramentas. Selecione Fetch Metadata para recuperar os metadados. A obtenção de metadados permite funcionalidades de gestão do Azure que dependem da identidade do recurso, como as Definições do servidor e as Ações do servidor flexível do Base de Dados do Azure para PostgreSQL, a Configuração de rede do Azure HorizonDB (Preview) e as métricas do Azure Monitor, quando suportadas.

Se a busca de metadados falhar, aparece uma mensagem de erro Failed to Fetch Metadata com detalhes.

Banner de metadados incompletos

Se os metadados do Azure forem obtidos mas o ID do tenant estiver em falta, aparece um banner de aviso no topo do painel com o título Metadados Azure Incompletos. Selecione Buscar Metadados no banner para tentar novamente. O ID do inquilino é necessário para operações do ciclo de vida do servidor (Início, Terminar, Reiniciar).

Separadores de investigação

Por baixo da barra de ferramentas e do cartão de detalhes, o painel organiza os dados de monitorização em quatro separadores de investigação. As capacidades do servidor determinam que separadores estão visíveis.

Tab O que mostra
Descrição geral Gráficos de métricas agrupados por categoria, com um navegador de índice para acesso rápido a cada grupo.
Consultas Principais instruções SQL classificadas por tempo de execução, número de chamadas ou outras métricas, com detalhe detalhado individual da consulta.
Espera Análise de eventos de espera com uma tabela ordenada e um gráfico ao longo do tempo que mostra onde o servidor despende tempo em espera.
Sessões Sessões ativas e ociosas, uma vista em árvore de bloqueios, gráficos da atividade de bloqueio e painéis de detalhes ao nível da sessão.

Selecione um separador para mudar de área de conteúdo. O painel lembra-se do separador ativo dentro da sessão atual.

Descrição geral

O separador Descrição geral é a vista apresentada por predefinição. Apresenta métricas de servidor como gráficos interativos organizados em grupos dobráveis.

Grupos métricos

As métricas estão organizadas nos seguintes grupos. Nem todos os grupos aparecem em todos os servidores; O painel mostra apenas os grupos que têm dados disponíveis.

Group O que cobre
Recursos Utilização da CPU, utilização de memória e métricas ao nível de computação.
Ligações Ligações ativas, contagens de ligações por estado e métricas do pool de ligações.
E/S de disco Débito de leitura e escrita, IOPS e latência.
Armazenamento Espaço em disco utilizado, armazenamento disponível e percentagem de armazenamento.
Transações e Carga de Trabalho Taxas de transação, confirmações, reversões e linhas processadas.
Eventos de espera Resumo dos principais tipos de eventos de espera e a sua frequência.
Manutenção e Aspiração automática Atividade de autovácuo e contagem de tuplas mortas.
Segurança do ID de Transação Idade do ID de Transação e métricas envolventes.
Replication Atraso de replicação e estado da réplica (quando a replicação está configurada).

Use o navegador de índice ao lado para saltar diretamente para um grupo específico. Selecione um cabeçalho de grupo para expandir ou colapsar os seus gráficos.

Fontes métricas

Cada gráfico de métricas mostra um emblema de origem que indica a origem dos dados:

Badge Fonte Availability
System Coletor de estatísticas incorporado no servidor Todos os servidores PostgreSQL
Azul Azure Monitor Base de Dados do Azure para PostgreSQL ligações do servidor flexível com metadados do Azure

Quando ambas as fontes estão disponíveis, a visão geral apresenta métricas de ambas as fontes em conjunto, cada gráfico rotulado com o seu emblema de fonte.

Intervalo de tempo e fuso horário

Selecione Local ou UTC no seletor de fusos horários para controlar como os eixos do gráfico e as dicas de ferramentas exibem os carimbos temporais.

Para métricas do Azure Monitor, um seletor de janela temporal permite-lhe escolher o intervalo de datas:

  • 1 hora
  • 6 horas
  • 12 horas
  • 1 dia
  • 7 dias
  • 30 dias

Interações com mapas

  • Lenda: Cada gráfico inclui uma legenda. Selecione uma entrada da legenda para ocultar essa série; selecione-a novamente para a repor.
  • Sincronização de mira: Quando passa o rato sobre um gráfico, todos os gráficos no mesmo separador sincronizam as suas miras com o mesmo carimbo temporal, para que possas correlacionar métricas entre gráficos.
  • Zoom: Use os controlos de zoom do gráfico para focar num intervalo temporal de interesse.

Queries

O separador Consultas mostra dados sobre o desempenho das consultas do coletor de estatísticas do PostgreSQL. Use-o para identificar instruções SQL lentas ou frequentemente chamadas.

As estatísticas de consulta exigem que a pg_stat_statements extensão esteja ativada no servidor PostgreSQL ligado.

Tabela SQL principal

A vista principal é uma tabela ordenada de instruções SQL. Cada linha mostra:

Column Description
Query Texto SQL normalizado. Selecione uma linha para abrir o painel de detalhes.
ID de consulta O identificador de consulta PostgreSQL.
Chamadas Número total de vezes que a declaração foi executada.
Tempo Total Tempo acumulado de execução.
Tempo médio Tempo médio de execução por chamada.
Linhas Total de linhas retornadas ou afetadas.
Database A base de dados onde a instrução foi executada.
User A função do PostgreSQL que executou a instrução.

Utilize os menus suspensos de filtro Base de Dados e Utilizador acima da tabela para restringir os resultados.

Painel de detalhes da consulta

Selecione uma linha na tabela SQL superior para abrir um painel de detalhes à direita. O painel de detalhe mostra:

  • Texto SQL completo com realce da sintaxe
  • Estatísticas de execução (chamadas, tempo total, tempo médio, tempo mínimo/máximo, desvio padrão)
  • Um gráfico de execução que visualiza o desempenho da declaração ao longo do tempo

Selecione Perguntar ao Copilot (ou Ask AI no Cursor) no painel de detalhes para abrir uma sessão de chat de IA com o contexto da consulta pré-carregado.

Períodos de Espera

O separador Waits ajuda-te a perceber onde é que o servidor passa tempo à espera. Combina uma tabela ordenada com um gráfico ao longo do tempo.

  • Tabela classificada: Lista tipos de eventos de espera ordenados pelo tempo total de espera. Cada linha mostra o nome do evento de espera, a categoria e o tempo acumulado.
  • Gráfico ao longo do tempo: Visualiza eventos de espera empilhados ao longo do tempo, para que possa ver como os padrões de espera mudam durante uma janela de monitorização.

Os gráficos no separador Waits usam sincronização de mira, por isso passar o rato sobre um gráfico destaca o mesmo ponto temporal no outro.

Selecione Perguntar ao Copilot (ou Ask AI no Cursor) para abrir uma sessão de chat de IA com os dados atuais do evento de espera como contexto.

Sessões

O separador Sessões mostra sessões ativas na base de dados e ajuda-o a identificar relações bloqueantes.

Cartões de resumo das sessões

No topo, os cartões de resumo mostram as contagens para categorias de sessões como Ativa, Ociosa e Bloqueada .

Tabela de sessões

A tabela de sessões lista sessões individuais com as seguintes colunas:

Column Description
PID Identificador do processo do backend.
User Função do PostgreSQL da sessão.
Database Base de dados conectada.
Application Nome do aplicativo cliente.
State Estado da sessão (ativo, inativo, inativo na transação, etc.).
Tipo de Espera Tipo de espera atual, se houver.
Evento de Espera Nome específico do evento de espera.
Query Texto da consulta atual ou última execução.
Duration Há quanto tempo persiste o estado atual.
Tipo de Backend Tipo de processo backend (backend cliente, trabalhador autoaspirador, etc.).

Use os controlos de filtro acima da tabela para restringir as sessões por tipo de carga de trabalho, aplicação ou estado.

Selecione Perguntar ao Copilot (ou Ask AI no Cursor) no cabeçalho da tabela Sessões para abrir uma sessão de chat de IA com os dados da sessão como contexto. Quando há cadeias de bloqueio, a análise centra-se nas relações de bloqueio e na saúde da sessão.

Árvore de blocos

Quando existem relações de bloqueio entre sessões, o painel mostra uma árvore de bloqueio que visualiza quais as sessões que estão a bloquear outras. Expanda os nós da árvore para traçar a cadeia desde a sessão de bloqueio até aos seus empregados.

Gráficos de atividade das eclusas

Os gráficos de atividade das fechaduras mostram padrões de aquisição e espera da fechadura ao longo do tempo, dando-lhe um resumo visual da contenda.

Painel de detalhes da sessão

Selecione uma linha de sessão para abrir um painel de detalhe que mostre a informação completa da sessão, incluindo o texto completo da consulta e as propriedades da sessão.

Topologia réplica

Para ligações ao servidor flexível do Base de Dados do Azure para PostgreSQL que utilizam réplicas de leitura, surge um painel Topologia de réplicas no painel de controlo. Mostra o servidor principal e as suas réplicas com indicadores de estado, prontidão para a transição e quaisquer avisos de topologia.

Pergunte à IA no painel de controlo

O botão Perguntar ao Copilot (Ask AI no Cursor) aparece em vários contextos de dashboard: o cabeçalho do separador Queries, o separador Waits, o separador Sessions e gráficos de métricas individuais. Quando o seleciona, a extensão abre uma sessão de chat de IA em modo Agente com os dados relevantes do painel (métricas, detalhes de consulta, eventos de espera ou informações da sessão) pré-carregados como contexto.

Note

O botão Perguntar ao Copilot / Ask AI necessita de um assistente de IA ativo: o GitHub Copilot instalado e com sessão iniciada no Visual Studio Code, ou a IA incorporada do Cursor. O botão está desativado enquanto os dados ainda estão a carregar ou quando não há dados disponíveis.

Estado desconectado

Quando o servidor é desligado, o painel mostra um aviso a explicar que é necessária uma ligação à base de dados. Selecione Ligar para restabelecer a ligação e carregar os dados do painel de controlo.

Mensagens de estado das métricas do Azure

Ao visualizar métricas do Azure Monitor, o painel pode mostrar mensagens de estado se as métricas não estiverem disponíveis:

  • Metadados Azure em falta: Metadados Azure são necessários para métricas históricas. Selecione Buscar Metadados para os recuperar.
  • Permissões Insuficientes: Não tem as permissões necessárias do Azure para consultar métricas do Azure Monitor. Selecione Ver Permissões Necessárias para mais detalhes.

Conteúdo relacionado

  • Last updated on