ApsaraDB RDS:Use the pg_profile extension to collect statistics on resource-intensive activities

-- Install
CREATE EXTENSION pg_profile;

-- Uninstall
DROP EXTENSION pg_profile;

Configurer la base de données serveur

Exécutez les instructions suivantes avec un compte privilégié.

1. Créez la base de données serveur.

   CREATE DATABASE server;

2. Connectez-vous à la base de données serveur et installez les extensions requises.

   pg_stat_statements et pg_stat_kcache doivent être chargés au démarrage de la base de données. Ajoutez les deux au paramètre shared_preload_libraries avant de créer ces extensions. pg_stat_kcache dépend de pg_stat_statements, donc les deux doivent être présents dans shared_preload_libraries . Pour obtenir des instructions, consultez la page Set parameters .

   \c server
   CREATE EXTENSION pg_stat_statements;
   CREATE EXTENSION pg_stat_kcache;

3. Vérifiez que les extensions sont installées.

   \dx

   Sortie attendue :

   Name                | Version |   Schema   |                              Description
   --------------------+---------+------------+------------------------------------------------------------------------
    pg_stat_kcache     | 2.2.1   | public     | Kernel statistics gathering
    pg_stat_statements | 1.9     | public     | track planning and execution statistics of all SQL statements executed
    ...

Configurer la base de données de profil

Exécutez les instructions suivantes avec un compte privilégié.

1. Créez la base de données de profil.

   CREATE DATABASE profile;

2. Connectez-vous à la base de données de profil et installez les extensions requises.

   \c profile
   CREATE EXTENSION plpgsql;
   CREATE EXTENSION dblink;
   CREATE EXTENSION pg_profile;

3. Vérifiez que les extensions sont installées.

   \dx

   Sortie attendue :

   Name        | Version |   Schema   |                         Description
   ------------+---------+------------+--------------------------------------------------------------
    dblink     | 1.2     | public     | connect to other PostgreSQL databases from within a database
    pg_profile | 4.0     | public     | PostgreSQL load profile repository and report builder
    plpgsql    | 1.0     | pg_catalog | PL/pgSQL procedural language
    ...

Enregistrer la connexion à la base de données serveur

Depuis la base de données de profil, enregistrez la base de données serveur en tant que cible de surveillance. Exécutez l'instruction suivante avec un compte privilégié.

SELECT create_server('server', 'host=<host> dbname=server port=<port> user=<user> password=<password>');

Valeurs de host selon la topologie réseau :

Pour obtenir les endpoints internes et publics d'une instance, consultez la page View and modify the endpoint and port number of an instance .

Sortie attendue :

show_servers
---------------------------------------------------------------------------------------
 (local,"dbname=profile port=3002",t,)
 (server,"host=127.0.0.1 dbname=server port=3002 user=test_user password=****",t,)
(2 rows)

La création d'une connexion serveur crée également une connexion local représentant la base de données de profil elle-même. Vous pouvez la voir dans la sortie ci-dessus.

Configurer la connexion à la base de données de profil

Une fois la connexion local créée, configurez ses identifiants. Exécutez l'instruction suivante avec un compte privilégié.

SELECT set_server_connstr('local','host=127.0.0.1 dbname=profile port=<port> user=<user> password=<password>');

Collecter un instantané

Depuis la base de données de profil, exécutez take_sample() pour collecter un instantané à partir de tous les serveurs enregistrés. Utilisez un compte privilégié.

SELECT take_sample();

Sortie attendue :

 take_sample
-------------------------
 (server,OK,00:00:00.52)
 (local,OK,00:00:00.51)
(2 rows)

Collectez au moins deux instantanés avant de générer un rapport ; le rapport couvre l'activité entre deux points d'instantané.

Afficher les instantanés collectés

SELECT * FROM show_samples('server');

Exemple de sortie :

 sample |      sample_time       | sizes_collected | dbstats_reset | bgwrstats_reset | archstats_reset
--------+------------------------+-----------------+---------------+-----------------+-----------------
      1 | 2022-09-30 02:14:07+00 | t               |               |                 |
      2 | 2022-09-30 02:16:59+00 | t               |               |                 |
      3 | 2022-09-30 02:17:58+00 | t               |               |                 |

Générer un rapport

Un rapport couvre l'activité entre deux instantanés ; spécifiez les numéros d'échantillon de début et de fin.

Option 1 : Depuis psql dans la base de données de profil

\o report_2_3.html
SELECT get_report('server',2,3);

Option 2 : Depuis l'interface de ligne de commande (CLI)

psql -Aqtc "SELECT profile.get_report('server',2,3)" \
  -o report_server_2_3.html \
  -d profile \
  -h <endpoint of the profile database instance> \
  -p 5432 \
  -U <privileged account of the profile database instance>

Les deux méthodes exportent le rapport sous forme de fichier HTML sur votre machine locale.