Dashboard del server

Il dashboard del server nell'estensione PostgreSQL mostra i dettagli della connessione PostgreSQL, le metriche delle prestazioni in tempo reale e cronologico e gli strumenti di gestione supportati. È possibile monitorare l'attività del server, aprire query, avviare il visualizzatore dello schema e accedere alla configurazione del server Azure, senza uscire dall'editor. Il dashboard viene eseguito nello stesso modo in Visual Studio Code e cursore. Solo il pannello della chat di intelligenza artificiale che si apre dai pulsanti di intelligenza artificiale del dashboard è diverso.

Tip

Configurare prima la connessione al server. Vedere Connessioni e identità. Per le azioni di gestione specifiche di Azure disponibili dal dashboard, vedi gestione del server di Azure.

Aprire il dashboard del server

  1. Nell'albero Connessioni fare clic con il pulsante destro del mouse su un nodo del server.
  2. Seleziona Dashboard.

Il dashboard si apre in una scheda chiamata <profileName> - Dashboard e mostra l'intestazione della pagina <connectionLabel> | Dashboard delle prestazioni.

Note

Il dashboard del server è una funzionalità di anteprima abilitata per impostazione predefinita. Per disabilitarla, imposta pgsql.enableServerDashboard su false nelle impostazioni di VS Code.

Scheda dei dettagli del server

Nella parte superiore del dashboard viene visualizzata una scheda dettagli che riepiloga la connessione corrente.

Campo Descrizione
Server Indirizzo del server PostgreSQL.
Versione Versione di PostgreSQL segnalata dal server.
Porto Porta TCP usata per la connessione (per impostazione predefinita è 5432).
User Utente autenticato per questa connessione.
DB predefinito Il database di destinazione della connessione (per impostazione predefinita è postgres).
Stato (solo Azure) Stato corrente del server flessibile Database di Azure per PostgreSQL, ad esempio Pronto, Arrestato o Avvio. Selezionare il pulsante Aggiorna accanto al valore per aggiornare lo stato.

Note

Il campo Stato viene visualizzato solo per le connessioni al server flessibile di Database di Azure per PostgreSQL.

Barra degli strumenti

La barra degli strumenti nella parte superiore del dashboard consente di accedere rapidamente alle operazioni comuni. Alcuni pulsanti vengono visualizzati solo quando vengono soddisfatte determinate condizioni.

Azioni di connessione

Button Descrizione
Connetti Viene visualizzato quando il server è disconnesso. Selezionarlo per ristabilire la connessione. Durante la connessione, il pulsante cambia in Connessione....
Azioni>Disconnetti Disconnetti dal server. Disponibile dal menu a discesa Azioni quando si è connessi.

Quando il server è scollegato, i pulsanti relativi al database nella barra degli strumenti sono disattivati e mostrano il suggerimento: "È necessaria una connessione al database." Connettersi al database per abilitare questa funzionalità."

Azioni di database

Button Descrizione
Nuova query Aprire un nuovo editor di query connesso a un database in questo server. Un selettore del database consente di scegliere il database di destinazione.
Connettere l'intelligenza artificiale / Connettere Copilot Apri una sessione in modalità agente limitata allo schema e ai dati di questo server. Il pannello di chat che si apre è GitHub Copilot Chat in Visual Studio Code e il pannello IA nativo di Cursor in Cursor. Vedi Integrazione di Copilot.
Visualizzare lo schema Avviare il visualizzatore dello schema per un database in questo server. Un selettore di database consente di scegliere il database di destinazione. Vedere Visualizzatore dello schema.

azioni del server Azure

Per le connessioni al server flessibile di Database di Azure per PostgreSQL, il menu a discesa Azioni include operazioni relative al ciclo di vita del server e la barra degli strumenti mostra un ulteriore pulsante del portale.

Button Descrizione
Azioni>Avvia Avviare un server Azure arrestato.
Azioni>Fermare Arrestare un server di Azure in esecuzione. L'arresto dealloca le risorse di calcolo e sospende la fatturazione delle risorse di calcolo.
Azioni>Riavviare Riavviare il server Azure. Usare questa opzione dopo la modifica dei parametri che richiedono un riavvio.
Portale di Azure Aprire il pannello di gestione del server nel portale di Azure nel browser predefinito.

Note

Le azioni Start, Stop e Restart richiedono autorizzazioni appropriate per il controllo degli accessi in base al ruolo di Azure (RBAC) sulla risorsa server.

Menu Impostazioni server

Per le connessioni Azure supportate, nella barra degli strumenti viene visualizzato un pulsante a discesa Impostazioni server. Fornisce lo spostamento alle pagine di gestione Azure aperte all'interno di VS Code.

Voce di menu Descrizione
Configurazione di rete Per Database di Azure per PostgreSQL - Server flessibile, visualizza e modifica le regole del firewall e le impostazioni dell'accesso pubblico. Per Azure HorizonDB (Anteprima), visualizza e modifica le regole del firewall e l'accesso ai servizi di Azure.
Parametri del server Esplorare e aggiornare i parametri PostgreSQL (statici e dinamici).
Backups Visualizzare la cronologia dei backup e configurare i criteri di conservazione dei backup.
Log del server Accedere e scaricare i log del server PostgreSQL per la risoluzione dei problemi.
Clone Server Clonare il server Azure da un punto di backup.

Le connessioni di Database di Azure per PostgreSQL - Server flessibile possono mostrare il menu completo. Le connessioni di Azure HorizonDB (anteprima) possono visualizzare Configurazione di rete quando la connessione dispone dell'identità completa della risorsa Azure e del pool. I parametri, i backup, i log del server, i cloni e le azioni del ciclo di vita non sono disponibili per le connessioni di Azure HorizonDB (anteprima).

Note

Il pulsante Impostazioni server viene visualizzato solo quando l'estensione rileva i metadati Azure per il server e almeno una pagina delle impostazioni è disponibile.

Prompt dei metadati di Azure

Quando l'estensione rileva che un server sembra essere una risorsa Database di Azure per PostgreSQL supportata, ma i metadati di Azure non sono ancora disponibili, nella barra degli strumenti viene visualizzato il messaggio Server Azure rilevato. Selezionare Recupera metadati per recuperare i metadati. Il recupero dei metadati consente le funzionalità di gestione di Azure che dipendono dall'identità della risorsa, ad esempio Database di Azure per PostgreSQL - Server flessibile Impostazioni del server e Azioni, Azure HorizonDB (Anteprima) Configurazione di rete e le metriche di Monitoraggio di Azure, ove supportate.

Se il recupero dei metadati non riesce, viene visualizzato un messaggio di errore Impossibile recuperare i metadati con i dettagli.

Banner di metadati incompleti

Se i metadati di Azure vengono recuperati ma manca l'ID del tenant, nella parte superiore della dashboard viene visualizzato un banner di avviso con il titolo Metadati di Azure incompleti. Selezionare Recupera metadati nel banner per riprovare. L'ID tenant è necessario per le operazioni del ciclo di vita del server (Avvio, Arresto, Riavvio).

Schede di indagine

Sotto la barra degli strumenti e la scheda dei dettagli, il dashboard organizza i dati di monitoraggio in quattro schede di indagine. Le funzionalità del server determinano quali schede sono visibili.

Tab Cosa mostra
Sintesi Grafici delle metriche raggruppati per categoria, con uno strumento di navigazione sommario per un accesso rapido a ogni gruppo.
Query Le istruzioni SQL principali classificate in base al tempo di esecuzione, al numero di chiamate o ad altre metriche, con il drill-down nei dettagli delle singole query.
Attese Analisi degli eventi di attesa con una tabella ordinata e un grafico temporale che mostra dove il server trascorre il tempo in attesa.
Sessioni Sessioni attive e inattive, vista ad albero dei blocchi, grafici dell'attività di blocco e pannelli di dettaglio a livello di sessione.

Selezionare una scheda per cambiare l'area del contenuto. La dashboard ricorda la scheda attiva durante la sessione corrente.

Overview

La scheda Panoramica è la vista iniziale predefinita. Visualizza le metriche del server come grafici interattivi organizzati in gruppi compressi.

Gruppi di metriche

Le metriche sono organizzate nei gruppi seguenti. Non tutti i gruppi vengono visualizzati per ogni server; il dashboard mostra solo i gruppi con dati disponibili.

Gruppo Cosa copre
Risorse Utilizzo della CPU, utilizzo della memoria e metriche a livello di calcolo.
Connessioni Connessioni attive, conteggi delle connessioni per stato e metriche del pool di connessioni.
I/O su disco Velocità effettiva di lettura e scrittura, operazioni di I/O al secondo e latenza.
Spazio di archiviazione Spazio su disco usato, spazio di archiviazione disponibile e percentuale di archiviazione.
Transazioni e carico di lavoro Frequenza delle transazioni, commit, rollback e righe elaborate.
Eventi di attesa Riepilogo dei principali tipi di evento di attesa e della relativa frequenza.
Maintenance & Autovacuum Attività di autovacuum e conteggi delle tuple morte.
Sicurezza dell'ID della transazione Età dell'ID transazione e metriche di riavvolgimento.
Replicazione Ritardo della replica e stato della replica (quando la replica è configurata).

Usa il navigatore del sommario sul lato per andare direttamente a un gruppo specifico. Selezionare un'intestazione di gruppo per espandere o comprimere i grafici.

Origini delle metriche

Ogni grafico delle metriche mostra un badge di origine che indica la provenienza dei dati:

Badge origine Availability
Sistema Agente di raccolta statistiche predefinito del server Tutti i server PostgreSQL
Azure Monitoraggio di Azure Database di Azure per PostgreSQL connessioni server flessibili con metadati di Azure

Quando entrambe le fonti sono disponibili, la panoramica visualizza insieme le metriche provenienti da entrambe le fonti, con ogni grafico contrassegnato dal badge della relativa fonte.

Intervallo di tempo e fuso orario

Seleziona Local o UTC nel selettore del fuso orario per controllare come gli assi del grafico e i tooltip visualizzano i timestamp.

Per Monitoraggio di Azure metriche, un selettore di intervallo di tempo consente di scegliere l'intervallo di date:

  • 1 ora
  • 6 ore
  • 12 ore
  • 1 giorno
  • 7 giorni
  • 30 giorni

Interazioni con il grafico

  • Legenda: ogni grafico include una legenda. Selezionare un elemento della legenda per nascondere la relativa serie; selezionarlo di nuovo per mostrarla.
  • Sincronizzazione incrociata: quando si passa il puntatore del mouse su un grafico, tutti i grafici nella stessa scheda sincronizzano i mirino con lo stesso timestamp, in modo da poter correlare le metriche tra i grafici.
  • Zoom: usare i controlli di zoom del grafico per concentrarsi su un intervallo di tempo di interesse.

Query

La scheda Query mostra i dati sulle prestazioni delle query dell'agente di raccolta statistiche PostgreSQL. Usalo per identificare istruzioni SQL lente o richiamate frequentemente.

Le statistiche di query richiedono l'abilitazione dell'estensione pg_stat_statements nel server PostgreSQL connesso.

Tabella SQL principale

La vista principale è una tabella classificata di istruzioni SQL. Ogni riga mostra:

Column Descrizione
Query Testo SQL normalizzato. Selezionare una riga per aprire il pannello dei dettagli.
ID query Identificatore di query PostgreSQL.
Chiamate Numero totale di volte in cui l'istruzione è stata eseguita.
Tempo totale Tempo di esecuzione cumulativo.
Tempo medio Tempo medio di esecuzione per chiamata.
Rows Totale righe restituite o interessate.
Banca dati Il database in cui è stata eseguita l'istruzione.
User Il ruolo PostgreSQL che ha eseguito l'istruzione.

Usare gli elenchi a discesa Database e Filtro utente sopra la tabella per restringere i risultati.

Pannello dei dettagli della query

Selezionare una riga nella tabella SQL superiore per aprire un pannello dei dettagli a destra. Il pannello dei dettagli mostra:

  • Testo COMPLETO di SQL con evidenziazione della sintassi
  • Statistiche di esecuzione (chiamate, tempo totale, tempo medio, tempo minimo/massimo, deviazione standard)
  • Un grafico di esecuzione che visualizza le prestazioni dell'istruzione nel tempo

Selezionare Chiedi a Copilot (o Chiedi intelligenza artificiale in cursore) nel pannello dei dettagli per aprire una sessione di chat di intelligenza artificiale con il contesto della query precaricata.

In attesa

La scheda Attese consente di comprendere dove il server impiega tempo in attesa. Combina una tabella classificata con un grafico nel tempo.

  • Tabella classificata: elenca i tipi di evento di attesa ordinati in base al tempo di attesa totale. Ogni riga mostra il nome dell'evento di attesa, la categoria e l'ora cumulativa.
  • Grafico nel tempo: visualizza gli eventi di attesa impilati nel tempo, in modo da vedere come cambiano i modelli di attesa durante una finestra di monitoraggio.

I grafici nella scheda Attese usano la sincronizzazione incrociata, quindi il passaggio del mouse su un grafico evidenzia lo stesso punto di tempo sull'altro.

Selezionare Chiedi a Copilot (o Chiedi intelligenza artificiale in cursore) per aprire una sessione di chat di intelligenza artificiale con i dati dell'evento di attesa correnti come contesto.

Sessioni

La scheda Sessioni mostra sessioni di database attive e consente di identificare le relazioni di blocco.

Schede di riepilogo delle sessioni

Nella parte superiore, le schede di riepilogo mostrano i conteggi per le categorie di sessione, ad esempio Sessioni attive, inattive e bloccate .

Tabella sessioni

La tabella di sessione elenca le singole sessioni con le colonne seguenti:

Column Descrizione
PID ID del processo del backend.
User Ruolo PostgreSQL per la sessione.
Banca dati Database collegato.
Applicazione Nome dell'applicazione client.
Stato Stato della sessione (attivo, inattivo, inattivo durante una transazione, ecc.).
Tipo di attesa Tipo di attesa corrente, se presente.
Evento di attesa Nome dell'evento di attesa specifico.
Query Testo della query corrente o dell'ultima query eseguita.
Duration Per quanto tempo lo stato corrente è persistente.
Tipo di backend Tipo di processo back-end (back-end client, ruolo di lavoro autovacuum e così via).

Usare i controlli filtro sopra la tabella per restringere le sessioni in base al tipo di carico di lavoro, all'applicazione o allo stato.

Selezionare Chiedi a Copilot (o Chiedi intelligenza artificiale in cursore) dall'intestazione della tabella Sessioni per aprire una sessione di chat di intelligenza artificiale con i dati della sessione come contesto. Quando sono presenti catene di blocco, l'analisi si concentra sulle relazioni di blocco e sullo stato di integrità della sessione.

Albero dei blocchi

Quando esistono relazioni di blocco tra sessioni, il dashboard mostra un albero di blocco che visualizza le sessioni che bloccano altre sessioni. Espandere i nodi della struttura ad albero per tracciare la catena dalla sessione di blocco ai relativi camerieri.

Grafici dell'attività di blocco

I grafici dell’attività di blocco visualizzano gli andamenti di acquisizione dei blocchi e di attesa nel tempo, fornendo un riepilogo visivo della contesa.

Pannello dei dettagli della sessione

Selezionare una riga di sessione per aprire un pannello di dettaglio con informazioni complete sulla sessione, incluse le proprietà complete del testo della query e della sessione.

Topologia di replica

Per le connessioni al server flessibile di Database di Azure per PostgreSQL che usano le repliche di lettura, nel dashboard viene visualizzato un pannello Topologia di replica. Mostra il server primario e le relative repliche con indicatori di stato, idoneità del cambio e avvisi di topologia.

Chiedi all'IA dalla dashboard

Il pulsante Chiedi a Copilot (Ask AI in Cursor) viene visualizzato in diversi contesti del dashboard: l'intestazione della scheda Query, la scheda Attese, la scheda Sessioni e i singoli grafici delle metriche. Quando la si seleziona, l'estensione apre una sessione di chat di intelligenza artificiale in modalità agente con i dati del dashboard pertinenti (metriche, dettagli delle query, eventi di attesa o informazioni sulla sessione) precaricati come contesto.

Note

Il pulsante Chiedi a Copilot / Ask AI richiede un assistente IA attivo: GitHub Copilot installato e con accesso effettuato per Visual Studio Code, oppure l'IA integrata di Cursor in Cursor. Il pulsante è disabilitato mentre i dati sono ancora in fase di caricamento o quando non sono disponibili dati.

Stato disconnesso

Quando il server è disconnesso, nel dashboard viene visualizzato un prompt che spiega che è necessaria una connessione al database. Selezionare Connetti per ristabilire la connessione e caricare i dati del dashboard.

Azure messaggi di stato delle metriche

Quando si visualizzano Monitoraggio di Azure metriche, il dashboard potrebbe visualizzare i messaggi di stato se le metriche non sono disponibili:

  • Metadati Azure mancanti: Azure metadati sono necessari per le metriche cronologiche. Selezionare Recupera metadati per recuperarlo.
  • Autorizzazioni insufficienti: non si dispone delle autorizzazioni di Azure necessarie per eseguire query sulle metriche da Monitoraggio di Azure. Selezionare Visualizza autorizzazioni necessarie per informazioni dettagliate .

Contenuti correlati

  • Last updated on