Collecte les métriques de chaque composant géré via la découverte de services de la console et évalue les règles d'alerte de la plateforme.
Généré depuis catalog/services/prometheus.yaml : ne pas modifier à la main.
Résumé
| |
|---|
| Version | 3.5.5 |
| Usage | installer et configurer, configurer et connecter |
| Couche | fonctionnelle (catalogue IA) |
| Catégorie | Observabilité |
| Méthodes d'installation | binary |
| Connexion externe | non |
| Réservé au bac à sable | non |
Licence
| |
|---|
| Identifiant SPDX | Apache-2.0 |
| Politique de licence | licence socle (MIT ou Apache-2.0) |
| Exception de licence | - |
| Composant de la plateforme | prometheus |
Paquets et artefacts
Un paquet que publie le projet du service (son image, son archive binaire, son paquet Python ou système) porte la licence du service ; un paquet tiers porte la licence écrite sur sa ligne, lue dans les métadonnées officielles du projet amont.
Systèmes et architectures pris en charge
| Méthode | Systèmes d'exploitation | Architectures |
|---|
binary | famille RHEL (dnf), famille Debian (apt), Arch Linux (pacman) | x86_64 (architecture des artefacts du descripteur) |
Systèmes hôtes certifiés : RHEL 8/9/10, Rocky Linux 8/9/10, AlmaLinux 8/9/10, Oracle Linux 8/9, CentOS Stream 9/10, Ubuntu 22.04/24.04, Debian 12, Arch Linux (rolling). Le contrôle préalable des hôtes accepte ces systèmes (une autre version d'une famille connue donne un avertissement, une version en fin de vie est refusée) et les architectures x86_64 et aarch64.
Prérequis
Hôte
- au moins 2048 Mo de mémoire (avertissement,
memory).
- au moins 20480 Mo libres pour
/var/lib/navin (avertissement, disk).
Programmes que les commandes et les contrôles du service lancent sur l'hôte, hors des racines gérées : les ajouter à allowed_commands de l'agent (voir Sécurité de l'agent Navin), sinon l'agent les refuse avec command_not_allowed : /usr/bin/curl.
Réseau et ports
| Composant | Nom du port | Port | Ouvert dans le pare-feu de l'hôte |
|---|
prometheus | http | 9090/tcp | oui |
Services et connexions nécessaires
Détail et résolution : voir Dépendances.
Méthodes et modes d'installation
| Méthode | Défaut | Ce que la méthode utilise |
|---|
binary | oui | les archives binaires du descripteur, décompressées dans le répertoire du service |
Composants
| Composant | Type | Méthodes d'installation | Ports |
|---|
Serveur Prometheus (prometheus) | maître | binary | 9090/tcp |
Unique (single) (par défaut)
Un seul serveur Prometheus.
Ce que le mode déploie :
| Composant | Placement |
|---|
prometheus | min 1, max 1 |
Haute disponibilité (ha)
Deux répliques identiques distinguées par l'étiquette externe replica.
Ce que le mode déploie :
| Composant | Placement |
|---|
prometheus | min 2, max 2, recommandé 2 |
Installer ce service
L'assistant d'installation du Navin Manager planifie, valide et exécute l'installation ; il faut la permission services:install sur le cluster.
-
Ouvrez l'assistant. Dans Clusters, choisissez l'action de ligne Installer des services du cluster cible. L'assistant s'ouvre sur sa première étape, Service.
-
Choisissez le service. À l'étape Service, sélectionnez Prometheus. La carte affiche la licence Apache-2.0 et les dépendances dont l'installation a besoin.
-
Choisissez les hôtes et le mode. À l'étape Hôtes, cochez les hôtes, puis choisissez le Mode : single (par défaut), ha. Chaque mode déploie les composants listés dans Méthodes et modes d'installation.
-
Liez les dépendances. À l'étape Liaisons, choisissez pour chaque dépendance (alertmanager, blackbox) Installer avec la plateforme ou Utiliser une connexion existante ; une dépendance facultative peut rester sur Aucune liaison.
-
Configurez. À l'étape Configuration, relisez les paramètres (voir Paramètres de configuration) ; les paramètres obligatoires sont manager_token. Les mots de passe laissés vides avec une valeur générée par défaut sont générés et scellés par le Manager.
-
Relisez et installez. À l'étape Installation, le Manager valide le plan et affiche l'ordre d'installation ; quand il indique « Le plan est valide. Prêt pour l'installation. », choisissez Installer. Un mode hautement disponible n'est installé que si ses contrôles HA réussissent.
-
Vérifiez. L'opération se termine quand les contrôles de santé de chaque instance réussissent (voir Contrôles de santé) ; le service apparaît alors en marche dans Services.
Connecter un service existant
| |
|---|
| Schémas | https, http |
| Port par défaut | 9090 |
| Authentification | facultative |
| Contrôle de santé | /-/ready |
| Méthode d'authentification | Champs | Description |
|---|
basic | username, password | Utilisateurs du fichier de configuration web (--web.config.file, basic_auth_users hachés en bcrypt). |
client_certificate | client_cert, client_key | Certificat client exigé par tls_server_config (client_auth_type RequireAndVerifyClientCert). |
none | - | Défaut de Prometheus : aucune authentification, gardez-le sur un réseau filtré. |
Documentation officielle : https://prometheus.io/docs/prometheus/latest/configuration/https/
Haute disponibilité
| |
|---|
| Cluster | réplicas (replication) |
| Haute disponibilité | redondance (redundancy) |
| Bascule | côté client (client) |
| Réplication | aucun (none) |
| Quorum | aucun (none) |
| Découverte | statique (static) |
| Point d'entrée | n'importe quel nœud (any-node) |
| Documentation officielle | https://prometheus.io/docs/introduction/faq/ |
Prérequis
| Prérequis | Doit être hautement disponible | Modes | Description |
|---|
alertmanager | oui | ha | Cluster Alertmanager dédoublonnant les alertes des deux réplicas. |
Topologie par mode
| Modes | Niveau le plus haut du catalogue | Répartition | Composant du quorum | Domaines de panne | Description |
|---|
single | autonome (standalone) | unique (single) | - | 1 | Un serveur Prometheus. |
ha | ha (ha) | actif-actif (active-active) | - | 2 | Deux réplicas identiques interrogeant les mêmes cibles, distingués par le label externe replica. |
Remarques
- Redondance, pas un stockage unifié : chaque réplica garde ses propres données locales (de petits trous peuvent différer) ; Thanos ou équivalent est facultatif pour une vue globale dédoublonnée.
Paramètres de configuration
Réseau
| Paramètre | Type | Défaut | Valeurs permises | Obligatoire | Secret | Redémarrage | Description |
|---|
Port HTTP (port) | port | 9090 | - | non | non | non | Port de l'API et de l'interface. |
TLS (tls_enabled) | bool | false | - | non | non | non | Servir l'API et l'interface en HTTPS (--web.config.file) avec un certificat émis par l'autorité de la console ; la collecte de Prometheus lui-même et les clients d'écriture distante le vérifient alors avec cette autorité. |
Stockage
| Paramètre | Type | Défaut | Valeurs permises | Obligatoire | Secret | Redémarrage | Description |
|---|
Rétention (retention) | duration | 15d | - | non | non | non | Durée de conservation des échantillons. |
Seuil d'alerte disque (disk_alert_percent) | int | 85 | min 50, max 99 | non | non | non | Pourcentage de disque utilisé qui déclenche une alerte. |
Découverte
| Paramètre | Type | Défaut | Valeurs permises | Obligatoire | Secret | Redémarrage | Description |
|---|
Intervalle de collecte (scrape_interval) | duration | 30s | - | non | non | non | Intervalle entre deux collectes d'une cible. |
Jeton de l'API de la console (manager_token) | password | - | - | oui | oui | non | Jeton en lecture seule de l'API de la console utilisé par la découverte de services ; écrit dans un fichier lisible par Prometheus seul. |
Dépendances
Pour chaque dépendance active, le Manager prend la première solution parmi : la liaison choisie dans l'assistant ; un service de la même installation qui la fournit ; un service déjà installé dans le cluster ; la seule connexion du type attendu. Sinon, une dépendance facultative reste non liée, et une dépendance obligatoire est ajoutée à l'installation dans son mode par défaut (la colonne ci-dessous nomme le service du catalogue ajouté).
| Liaison | Fournie par | Type de connexion | Point d'accès | Facultative | Quand rien n'est lié | Description |
|---|
alertmanager | alertmanager | - | http | oui | reste non liée (facultative) | Alertmanager qui reçoit les alertes de la plateforme. |
blackbox | blackbox-exporter | - | http | oui | reste non liée (facultative) | Exportateur de sondes dont les sondes (santé de la console et paramètre probes) sont lancées par Prometheus via /probe : disponibilité, latence et expiration des certificats des points d'accès (règle NavinCertificateExpiry). |
Points d'accès
| Point d'accès | Schéma | Composant | Port | Chemin | Paramètre TLS | Paramètres de liaison | Secrets de liaison | Commande de provisionnement |
|---|
http | http | prometheus | 9090 (port) | - | tls_enabled | - | - | - |
Commandes
| Commande | Composant | Cible | Description |
|---|
Recharger (reload) | prometheus | tous les hôtes | Recharge la configuration et les règles sans redémarrage. |
Afficher les cibles (targets) | prometheus | premier hôte | Liste les cibles actives et leur état. |
Contrôles de santé
Vivacité (par instance)
| Composant | Contrôle | Détails |
|---|
prometheus | HTTP {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn if config.tls_enabled else (host.ip or '127.0.0.1') }}:{{ config.port }}/-/ready | Attendu 200 ; 60 tentatives ; intervalle 2 s ; délai 3 s |
Contrôles préalables
| Contrôle | Type | Signification | Sévérité | Composants |
|---|
memory | memory_mb {"min": 2048} | au moins 2048 Mo de mémoire | avertissement | tous les composants |
disk | disk_free_mb {"min": 20480} | au moins 20480 Mo libres pour /var/lib/navin | avertissement | tous les composants |
port_free | port_free {"param": "port"} | port 9090 libre sur l'hôte | bloquant | tous les composants |
Désinstallation
Chemins supprimés quand les données sont purgées : {{ paths.data }}, {{ paths.log }}.
Liens rapides
- Interface Prometheus :
{{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn }}:{{ config.port }}/
Documentation amont