Monitoraggio di PostgreSQL

I sistemi operativi supportati dal sensore PostgreSQL sono in linea con i requisiti dell'agente host, che possono essere verificati nella sezione "Sistemi operativi supportati" di ciascun agente host, ad esempio " Sistemi operativi supportati per Unix ".

Il sensore supporta le seguenti versioni di PostgreSQL:

• PostgreSQL 8.0.x all'indirizzo 8.4.x
• PostgreSQL 9.0.x all'indirizzo 9.6.x
• PostgreSQL 10.x
• PostgreSQL 11.x
• PostgreSQL 12.x
• PostgreSQL 13.x
• PostgreSQL 14.x
• PostgreSQL 15.x
• PostgreSQL 16.6
• PostgreSQL 17.2

La tabella seguente riporta l'ultima versione supportata e la politica di assistenza:

Per ulteriori informazioni sulla politica di assistenza, consultare la sezione "Strategia di assistenza per i sensori".

Per questa tecnologia, Instana supporta il tracciamento lato client per i seguenti linguaggi e runtime:

• Java
• Node.js
• PHP
• .NET Framework
• .NET Core
• Librerie e piattaforme supportate d Go
• Python

La raccolta delle statistiche è controllata dai parametri di configurazione impostati nel file postgresql.conf , che viene creato durante la configurazione di postgresql. Per monitorare la raccolta dei dati statistici, impostare i seguenti parametri su on (sono yesaccettati 1 anche, true e ).

Per individuare la posizione del tuo postgresql.conf file, esegui la seguente query SQL:

SHOW config_file;

Questa query restituisce il percorso completo del postgresql.conf file sul tuo server PostgreSQL.

La tabella seguente elenca i parametri di configurazione:

Per ulteriori informazioni sulla configurazione della raccolta dei dati statistici, consultare la documentazione di PostgreSQL.

In alcuni ambienti, i file di configurazione di PostgreSQL non vengono mantenuti dopo il riavvio. Le modifiche apportate direttamente a postgresql.conf potrebbero non essere mantenute dopo il riavvio del sistema. Per garantire che l'impostazione relativa alla raccolta dei dati statistici rimanga attiva anche dopo il riavvio, si consiglia di utilizzare il ALTER SYSTEM comando. Questo comando salva la configurazione nel postgresql.auto.conf file, che si trova nella directory dei dati di PostgreSQL, e mantiene la configurazione anche se si utilizza un volume persistente.

Utilizza il seguente comando per abilitare la raccolta delle statistiche:

• ALTER SYSTEM SET track_activities = 'on';
• ALTER SYSTEM SET track_counts = 'on';
• ALTER SYSTEM SET track_io_timing = 'on';

Esegui il SELECT pg_reload_conf(); comando per ricaricare la configurazione. Verificare l'impostazione eseguendo i seguenti comandi:

• SHOW track_activities;
• SHOW track_counts;
• SHOW track_io_timing;

È inoltre possibile controllare il postgresql.auto.conf file per verificare le modifiche di configurazione applicate utilizzando il ALTER SYSTEM comando. Questo file contiene la configurazione aggiornata.

Per ulteriori informazioni sull'uso ALTER SYSTEM del comando di configurazione, consultare la documentazione di PostgreSQL.

cluster_name = 'PostgreSQL_cluster'

Per abilitare la raccolta delle statistiche per i container rootless Podman di PostgreSQL, è necessario abilitare i parametri nel postgresql.conf file e mappare la porta di ascolto del server PostgreSQL alla stessa porta sull'host in cui è ospitato il container rootless Podman. È necessario effettuare il mapping delle porte per stabilire una connessione e raccogliere le metriche richieste. Infine, imposta il valore della chiave ` isRootlessPodman ` su `true` nel file di configurazione dell'agente.

L'autorizzazione minima per il monitoraggio della raccolta di metrica è SELECT sul database pg_stat_database . Il seguente esempio illustra come creare un utente per le necessità dell'agente:

create user <USERNAME> with password <PASSWORD>;
grant SELECT ON pg_stat_database to <USERNAME>;
 

Per configurare l'autenticazione richiesta quando il sensore si connette a PostgreSQL, completare i seguenti passaggi:

1. Configurare le credenziali utente abilitando la sezione di configurazione nel file di configurazione dell'agente <agent_install_dir>/etc/instana/configuration.yaml.

2. Immettere un nome utente e una password.

   La parola d'ordine è una parola d'ordine in testo chiaro.

Per l'autenticazione basata su password, il meccanismo di autenticazione dell'utente PostgreSQL corrispondente deve essere md5, scram-sha-256 (versione 10 e successive) o una password. Per ulteriori informazioni, consultare le sezioni " Autenticazione tramite password" e "Autenticazione client" nella documentazione di PostgreSQL.

Per stabilire una connessione tra il sensore e PostgreSQL, PostgreSQL deve contenere un database con un nome identico al nome utente:

com.instana.plugin.postgresql:
  user: '<USERNAME>'
  password: '<PASSWORD>'
  database: '' # by default PostgreSQL will use 'user' as database to connect to.
  poll_rate: 10 #Values are in seconds. Default Value 1 Sec.
  isRootlessPodman: true/false # Optional. Use this field only if you are running postgres inside a rootless podman container. Default value is false.
 

Il campo Database viene utilizzato solo per l'autenticazione. L'agente legge automaticamente le modifiche apportate al file di <agent_install_dir>/etc/instana/configuration.yamlconfigurazione. Pertanto, le modifiche a questo file di configurazione vengono ricaricate a sistema acceso (non è necessario riavviare l'agent).

Per raccogliere le metriche del database, è necessario assegnare user il CONNECT privilegio specificato per tutti i database presenti nell'istanza PostgreSQL . Il seguente esempio mostra come concedere il privilegio CONNECT a un utente:

GRANT CONNECT ON DATABASE <DATABASE_NAME> TO <USERNAME>;
 

Vedi i seguenti dati di configurazione raccolti dall'istanza Postgres in esecuzione:

• ID processo
• Ora di inizio
• Porta
• Versione
• Ruolo
• Numero massimo di connessioni

Di seguito sono riportate le metriche delle prestazioni raccolte per ciascuna istanza Postgres :

Ogni sensore ha una knowledge base curata delle firme di integrità che vengono valutate continuamente rispetto alla metrica in ingresso e vengono utilizzate per generare problemi o incidenti che dipendono dall'impatto dell'utente.

Gli eventi predefiniti generano problemi o incidenti in base al mancato rispetto delle condizioni di integrità delle entità, mentre gli eventi personalizzati generano problemi o incidenti in base alle soglie di una singola metrica di una determinata entità.

Per ulteriori informazioni sugli eventi integrati per il sensore PostgreSQL , vedi il Riferimento agli eventi integrati.

Tipo di problema di monitoraggio: postgresql_stats_not_enabled

Il server PostgreSQL è stato rilevato, ma la raccolta delle statistiche non è abilitata. È necessario abilitare la raccolta delle statistiche. Per ulteriori informazioni, consultare la sezione Abilita raccolta statistiche .

Tipo di problema di monitoraggio: postgresql_authentication_failed

Autenticazione PostgreSQL non riuscita. Per creare un utente di monitoraggio e configurarlo, fare riferimento alla sezione Crea un utente di monitoraggio .

Tipo di problema di monitoraggio: postgresql_connection_failed

L'agente non riesce a stabilire una connessione al server PostgreSQL . È necessario verificare che la connessione sia stata stabilita tra l'agent e il sensore.