Xata Agent : un assistant IA pour la surveillance et l'optimisation des bases de données PostgreSQL

Introduction générale

Xata Agent est un outil d'intelligence artificielle open source conçu spécifiquement pour les bases de données PostgreSQL. Il peut surveiller automatiquement l'état de la base de données, trouver la cause première des problèmes de performance ou des défaillances, et donner des recommandations pour la réparation. L'équipe de développement de xAI l'a positionné comme un assistant de type "expert en bases de données", adapté aux développeurs et au personnel d'exploitation. Le projet est hébergé sur GitHub, à la date du 17 mars 2025, et dessert plus de 35 000 bases de données PostgreSQL actives. xata Agent est non seulement gratuit et open source, mais il prend également en charge les extensions qui permettent aux utilisateurs d'ajouter des outils ou d'ajuster les paramètres en fonction de leurs besoins. Il met l'accent sur la sécurité et n'effectue aucune opération susceptible d'endommager la base de données. Tous les diagnostics et recommandations sont basés sur des commandes SQL prédéfinies et une logique d'analyse.

Liste des fonctions

• suivi en temps réelLes données de la base de données peuvent être utilisées à des fins d'analyse, de recherche et d'évaluation de la qualité de l'information.
• Diagnostic du problèmeAnalyse des journaux et des mesures pour identifier la cause d'une utilisation élevée de l'unité centrale ou d'une mémoire insuffisante.
• Recommandations d'optimisationLes services d'aide à la décision : fournissent des suggestions de réglage de paramètres spécifiques, tels que l'allocation de la mémoire ou les plafonds de connexion.
• Analyse lente des requêtesLes requêtes : Dressez la liste des requêtes dont l'exécution prend beaucoup de temps et donnez des pistes d'amélioration.
• Intégration des journaux et des mesuresSupport pour l'obtention de données depuis AWS RDS et Aurora via Cloudwatch.
• Support extensibleOutils personnalisés : permet aux utilisateurs d'ajouter des outils personnalisés ou des playbooks pour gérer des tâches spécifiques.
• fonction de notificationLes alertes : Envoyez des alertes via Slack pour une réponse facile et rapide de l'équipe.

Utiliser l'aide

Processus d'installation

Xata Agent doit fonctionner avec une base de données PostgreSQL, le processus d'installation est simple et est principalement déployé via Docker. Voici les étapes détaillées :

1. Préparation de l'environnement
   • Assurez-vous que Docker et Docker Compose sont installés. Cela peut être fait avec la commande docker --version répondre en chantant docker-compose --version Vérifier.
   • Une base de données PostgreSQL est nécessaire pour stocker la configuration de l'agent Xata et les données historiques.
2. Télécharger le projet
   • Ouvrez un terminal et entrez la commande Clone Repository :

     git clone https://github.com/xataio/agent.git
     

   • Accédez au catalogue de projets :

     cd agent
     

3. Configuration des variables d'environnement
   • Dans le répertoire racine du projet, trouvez le fichier .env.production et l'ouvrir à l'aide d'un éditeur de texte.
   • Définissez les champs obligatoires suivants :
     • PUBLIC_URLRemplissez votre adresse d'accès, par ex. http://localhost:8080.
     • OPENAI_API_KEYEntrez votre clé API OpenAI (d'autres modèles comme Anthropic ou Deepseek sont pris en charge).
   • Facultatif : si vous utilisez les notifications Slack, ajoutez des clés liées à Slack.
4. Démarrage des services
   • S'exécute dans le terminal :

     docker-compose up -d
     

   • Ceci démarrera l'agent Xata et une base de données PostgreSQL temporaire. Attendez quelques minutes jusqu'à ce que le terminal indique que le service est en cours d'exécution.
5. interface d'accès
   • Ouvrez votre navigateur et tapez http://localhost:8080(ou l'URL_PUBLIQUE que vous avez définie).
   • Suivez les invites de la page pour terminer la première installation, comme la connexion à votre base de données PostgreSQL cible.

Principales fonctions

suivi en temps réel

• Après la connexion, la page d'accueil affiche l'état actuel de la base de données cible, comme le nombre de connexions actives et l'utilisation du processeur.
• Cliquez sur l'onglet "Moniteur" pour voir un graphique détaillé des mesures, avec des données mises à jour toutes les 10 secondes.

Diagnostic du problème

• Si la base de données présente une anomalie, telle qu'une utilisation élevée de l'unité centrale, cliquez sur le bouton "Diagnostics".
• L'agent Xata exécute automatiquement des commandes SQL prédéfinies (par exemple, la vérification de l'élément pg_stat_statements) et affiche ensuite la cause du problème, par exemple une requête particulière qui consomme trop de ressources.

Recommandations d'optimisation

• Sur la page Suggestions, l'outil dresse la liste des configurations de paramètres en cours (par ex. max_connections peut-être shared_buffers).
• La valeur recommandée et la raison de l'ajustement sont indiquées à côté, par exemple "L'augmentation de l'allocation de mémoire réduit l'IO du disque".

Analyse lente des requêtes

• Dans l'onglet Requêtes lentes, l'outil répertorie les instructions SQL dont l'exécution prend plus de 2 secondes.
• Cliquez sur une requête pour voir le plan d'exécution détaillé et les suggestions d'optimisation, comme l'ajout d'index.

mise en garde

• Lors de la première utilisation, il est recommandé de se connecter d'abord à une base de données de test pour s'assurer que la configuration est correcte.
• Si vous avez besoin d'étendre la fonctionnalité, vous pouvez le faire dans la section apps/dbagent/src/lib/tools pour ajouter des outils personnalisés, voir le README officiel pour plus de détails.

scénario d'application

1. Petites et moyennes équipes de développement
   Description du scénario : Une équipe de développement gère plusieurs bases de données PostgreSQL sans DBA à temps plein. Xata Agent peut automatiquement surveiller les bases de données, identifier les requêtes lentes ou les connexions excessives, et donner des suggestions d'optimisation pour réduire la charge de travail de l'équipe.
2. Exploitation et maintenance de la base de données en nuage
   Description du scénario : une instance PostgreSQL fonctionnant sur AWS RDS présente un goulot d'étranglement au niveau des performances. Les utilisateurs accèdent aux journaux Cloudwatch via l'agent Xata pour identifier rapidement les problèmes, tels que la latence due à l'attente d'un verrou, et recevoir des recommandations sur les paramètres de réglage.
3. Maintenance des projets Open Source
   Description du scénario : les projets open source ont besoin d'une base de données stable, mais les ressources sont limitées. Xata Agent est gratuit et facile à déployer, il surveille en temps réel et notifie le développeur des anomalies via Slack.

QA

1. L'agent Xata est-il gratuit ?
   Oui, il s'agit d'un outil open source entièrement gratuit. Vous n'avez qu'à couvrir les coûts de l'environnement d'exploitation, tels que les coûts du serveur Docker.
2. Cela modifiera-t-il ma base de données ?
   Non. Xata Agent n'exécute que des commandes de diagnostic en lecture seule et n'effectue aucune opération de modification ; toutes les recommandations doivent être mises en œuvre manuellement.
3. Quelles sont les bases de données prises en charge ?
   Actuellement, seul PostgreSQL est pris en charge, y compris les versions de services en nuage telles que RDS et Aurora.