--- title: "Meilleures pratiques pour intégrer Prometheus avec APISIX - API7.ai" description: "Cet article expliquera comment configurer et utiliser Prometheus dans Apache APISIX, et recommandera quelques configurations d'indicateurs courants." url: "https://api7.ai/fr/blog/best-practice-for-integrating-apisix-with-prometheus" --- [Blog](https://api7.ai/fr/blog) [Products](https://api7.ai/fr/category/products)[Technology](https://api7.ai/fr/category/technology)[Ecosystem](https://api7.ai/fr/category/ecosystem)[Case Study](https://api7.ai/fr/category/usercase)[Team & Community](https://api7.ai/fr/category/community) Search ⌘ + K [Blog](https://api7.ai/blog) Technology # Meilleures pratiques pour intégrer Prometheus avec APISIX January 13, 2024 [Technology](https://api7.ai/category/technology) Dans l'architecture cloud-native d'aujourd'hui, surveiller les [métriques](https://api7.ai/blog/api7-portal-monitor-api-metrics) de votre passerelle API est crucial. Apache APISIX, en tant que passerelle API haute performance, offre non seulement des fonctionnalités étendues, mais prend également en charge une intégration transparente avec Prometheus pour collecter et surveiller les métriques clés du trafic API. Cet article explore comment configurer et utiliser Prometheus dans Apache APISIX, en mettant en avant les considérations essentielles et en recommandant des configurations de métriques courantes. ### À propos de Prometheus [Prometheus](https://apisix.apache.org/docs/apisix/plugins/prometheus/) est un système de surveillance open source qui collecte et stocke des données de séries temporelles, permettant une surveillance et une analyse en temps réel des performances du système. Lorsqu'il est intégré à Apache APISIX, Prometheus devient un outil essentiel pour capturer des métriques détaillées liées au trafic API. ### Activation du plugin Prometheus dans Apache APISIX 1. Pour activer les métriques Prometheus dans Apache APISIX, commencez par configurer le plugin Prometheus dans le fichier `config.yaml` : ``` plugins: - prometheus ``` 2. Configurez le plugin Prometheus sur le service ou l'API souhaité à collecter. Vous pouvez également le configurer globalement. Voici un exemple de configuration du plugin à l'aide d'une commande cURL : ``` curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d ' { "uri": "/hello", "plugins": { "prometheus":{} }, "upstream": { "type": "roundrobin", "nodes": { "127.0.0.1:80": 1 } } }' ``` Pour des configurations plus complexes, consultez : [Documentation du plugin Prometheus](https://apisix.apache.org/docs/apisix/plugins/prometheus/) ### Configuration de la stratégie de collecte dans Prometheus Dans Prometheus, configurez le fichier `prometheus.yml` pour ajouter APISIX comme nouvelle cible de surveillance : ``` scrape_configs: - job_name: 'apisix' static_configs: - targets: [':'] ``` ### Métriques courantes dans Apache APISIX Les métriques spécifiques à une entreprise peuvent varier, mais voici quelques métriques clés dans Apache APISIX, fournissant des informations riches pour la surveillance et l'analyse du système : - **Métriques de requêtes et réponses HTTP :** - `apisix_http_request_total` : Enregistre le total des requêtes HTTP via APISIX, offrant une vue d'ensemble du trafic système. - `apisix_http_request_duration_seconds` : Mesure le temps de traitement des requêtes HTTP, aidant à identifier les goulots d'étranglement de performance. - `apisix_http_request_size_bytes` : Capture la taille des requêtes HTTP pour l'analyse des données. - `apisix_http_response_size_bytes` : Surveille la taille des réponses HTTP pour suivre le volume des données de réponse. - **Métriques des services en amont :** - `apisix_upstream_latency` : Reflète la latence de réponse des services en amont. - `apisix_upstream_health` : Indique l'état de santé des services en amont. - **Métriques de performance système :** - `apisix_node_cpu_usage` : Rapporte l'utilisation du CPU du nœud APISIX. - `apisix_node_memory_usage` : Fournit des informations sur l'utilisation de la mémoire. - **Métriques de trafic :** - `apisix_bandwidth` : Détaille l'utilisation de la bande passante pour le trafic en amont et en aval. - **Métriques d'erreurs et d'exceptions :** - `apisix_http_status_code` : Distribue les codes de statut HTTP des réponses, en se concentrant particulièrement sur les erreurs 4xx et 5xx. ### Visualisation et alertes Utilisez l'intégration de Grafana et Prometheus pour créer des tableaux de bord permettant de visualiser ces métriques. De plus, les règles d'alerte de Prometheus peuvent être configurées pour définir des alertes basées sur des conditions spécifiques. **Exemple de tableau de bord Grafana :** Créez divers graphiques dans Grafana, tels que des séries temporelles, des histogrammes ou des camemberts, pour afficher les métriques de performance d'APISIX. Par exemple, un tableau de bord affichant le nombre de requêtes HTTP et les temps de réponse moyens offre des informations en temps réel sur le trafic et les performances. **Exemple d'alerte Prometheus :** Les règles d'alerte dans Prometheus peuvent être configurées pour diverses conditions. Par exemple, si la durée moyenne de `apisix_http_request_duration_seconds` dépasse un seuil prédéfini, Prometheus peut être configuré pour envoyer des alertes critiques. ## Considérations d'optimisation Bien que disposer de nombreuses métriques Prometheus améliore les dimensions de surveillance et d'alerte, il est crucial de reconnaître que ces métriques consomment des ressources de calcul. Plus de métriques impliquent des demandes de ressources plus élevées, ce qui peut potentiellement impacter les systèmes métier. Depuis la version 3.0, Apache APISIX a considérablement optimisé le plugin Prometheus, introduisant un processus dédié pour les statistiques et la récupération des métriques. Cette amélioration atténue l'impact sur le trafic métier causé par les statistiques étendues des métriques Prometheus, contribution de [API7.ai](https://api7.ai/). ## Conclusion En intégrant Prometheus à Apache APISIX, les entreprises obtiennent des informations approfondies sur leur infrastructure API, assurant des opérations efficaces et sécurisées. La surveillance du trafic API devient progressivement un outil essentiel pour prévenir les problèmes de manière proactive, optimiser les performances et garantir la sécurité. Tags: [Monitoring](https://api7.ai/tags/monitoring) [APISIX Basics](https://api7.ai/tags/apisix-basics) Share article link Share Related Posts [![Quoi de neuf dans ADC 0.11 et 0.12 ?](https://static.api7.ai/uploads/2025/01/21/vI79UK0t_adc-0.11-0.12.png)](https://api7.ai/blog/adc-0.11-and-0.12) ## [Quoi de neuf dans ADC 0.11 et 0.12 ?](https://api7.ai/blog/adc-0.11-and-0.12) [![3 conseils pour déployer APISIX dans Kubernetes (Partie 2)](https://static.api7.ai/uploads/2024/05/07/5oXyr34X_deploy-apisix-in-k8s.png)](https://api7.ai/blog/3-tips-for-deploying-apisix-in-k8s-2) ## [3 conseils pour déployer APISIX dans Kubernetes (Partie 2)](https://api7.ai/blog/3-tips-for-deploying-apisix-in-k8s-2) Table of Contents - - [À propos de Prometheus](#%C3%A0-propos-de-prometheus) - [Activation du plugin Prometheus dans Apache APISIX](#activation-du-plugin-prometheus-dans-apache-apisix) - [Configuration de la stratégie de collecte dans Prometheus](#configuration-de-la-strat%C3%A9gie-de-collecte-dans-prometheus) - [Métriques courantes dans Apache APISIX](#m%C3%A9triques-courantes-dans-apache-apisix) - [Visualisation et alertes](#visualisation-et-alertes) - [Considérations d'optimisation](#consid%C3%A9rations-doptimisation) - [Conclusion](#conclusion) ## Related Posts [![Collecte de logs simplifiée avec le plugin http-logger d'APISIX](https://static.api7.ai/uploads/2024/04/11/Zod2vE0f_http-logger-cover.png)](https://api7.ai/fr/blog/apisix-http-logger-plugin) Technology April 11, 2024 #### [Collecte de logs simplifiée avec le plugin http-logger d'APISIX](https://api7.ai/fr/blog/apisix-http-logger-plugin) Learn how to enhance development efficiency with real-time API call log monitoring using the APISIX http-logger plugin. [Observability](https://api7.ai/tags/observability) [Monitoring](https://api7.ai/tags/monitoring) [APISIX Basics](https://api7.ai/tags/apisix-basics) [![Maîtriser les vérifications de santé d'APISIX : Stratégies de surveillance active et passive](https://static.api7.ai/uploads/2024/01/11/yJqiZUi2_health-check-cover.png)](https://api7.ai/fr/blog/health-check-ensures-high-availability) Technology January 11, 2024 #### [Maîtriser les vérifications de santé d'APISIX : Stratégies de surveillance active et passive](https://api7.ai/fr/blog/health-check-ensures-high-availability) Explorons comment APISIX, une passerelle API open-source, met en œuvre des mécanismes de vérification de santé robustes, surveillant activement et passivement les nœuds. [Monitoring](https://api7.ai/tags/monitoring) [APISIX Basics](https://api7.ai/tags/apisix-basics) [![Configuration des alertes : Mesures clés pour améliorer la stabilité des API](https://static.api7.ai/uploads/2024/01/04/ExKAUjBR_alerts-cover-en.png)](https://api7.ai/fr/blog/configuring-alerts-for-stable-api) Technology January 6, 2024 #### [Configuration des alertes : Mesures clés pour améliorer la stabilité des API](https://api7.ai/fr/blog/configuring-alerts-for-stable-api) Découvrez comment améliorer la stabilité des API en optimisant la configuration des alertes, garantissant ainsi des opérations commerciales fluides. [Monitoring](https://api7.ai/tags/monitoring) [Observability](https://api7.ai/tags/observability) [APISIX Basics](https://api7.ai/tags/apisix-basics)