HYPHApar S33D
Documentation › Intégrations

Collecte générique : Prometheus, plugins Nagios et syslog

Trois moteurs pour superviser ce qui n'a pas d'intégration dédiée : tout logiciel qui publie ses mesures au format Prometheus, les milliers de plugins Nagios et Centreon existants, et les journaux envoyés par syslog.

Lecteur OpenMetrics et Prometheus

L'agent lit les pages /metrics au format d'exposition Prometheus (texte 0.0.4) ou OpenMetrics 1.0 (texte). Une entrée par cible, dans integrations.openmetrics :

integrations:
  openmetrics:
    - profile: node_exporter              # http://127.0.0.1:9100/metrics par défaut
    - name: monappli
      url: https://appli.exemple:8443/metrics
      interval: 30s                       # 30 s par défaut, 10 s au moins
      timeout: 10s
      namespace: monappli                 # préfixe des métriques HYPHA
      metrics: [http_requests_total, "job_*", "re:queue_(depth|age)_.*"]
      exclude_metrics: ["go_*"]
      rename: {http_requests_total: http.requests}
      labels: [code, method]              # étiquettes gardées comme tags ; "*" = toutes
      tags: {equipe: paiement}
      bearer_token_file: /etc/hypha/monappli.token   # relu à chaque relevé
      ca_file: /etc/hypha/ca-interne.pem  # aussi cert_file, key_file, insecure
      max_series: 2000

Les listes de plusieurs fichiers conf.d s'additionnent : un fichier par application. D'autres en-têtes passent par headers ; username et password donnent une authentification de base. Les valeurs d'en-têtes et les mots de passe ne s'affichent jamais dans hypha-agent check-config.

Traduction des mesures

Type PrometheusCe qu'HYPHA reçoit
jauge, inconnula valeur telle quelle
compteurun débit par seconde (byte_per_second pour _bytes), rien à la première lecture ni après une remise à zéro
histogramme<nom>.count et <nom>.sum (débits), <nom>.avg, centiles <nom>.p50, .p95, .p99 estimés comme histogram_quantile ; les seaux avec histogram_buckets: true
résumé<nom>.count, <nom>.sum, <nom>.avg et chaque quantile publié (0.5 → p50, 0.999 → p99_9)

Nom HYPHA : <namespace>.<nom> (le suffixe _total d'un compteur est retiré), ou <namespace>.<rename>. Les étiquettes Prometheus hors de labels sont écartées, et les séries qui ne diffèrent que par elles sont additionnées (par exemple node_cpu_seconds_total sans l'étiquette cpu donne le temps de tous les cœurs). Chaque série porte instance_name et endpoint.

Garde-fou de cardinalité

Au-delà de max_series séries pour une cible (2 000 par défaut), l'agent garde les premières dans l'ordre alphabétique, écarte les autres, le dit dans l'état de l'agent et dans son journal, et publie openmetrics.series.dropped. Le modèle de moniteur « Plafond de séries OpenMetrics atteint » prévient quand cela dure.

Profils intégrés

Un profil apporte le port, le chemin, les métriques retenues, leurs noms et les étiquettes utiles. Ce que l'entrée ajoute (metrics, rename, labels, tags) complète le profil.

ProfilPortMesures (espace de noms)
node_exporter9100node.load.1, node.cpu.seconds par mode, node.memory.*, node.filesystem.* par point de montage, node.network.* et node.disk.* par périphérique, node.procs.*, node.filefd.*, node.hwmon.temperature, node.time.offset
prometheus9090prometheus.tsdb.head_series, .tsdb.samples_appended, .http.requests par code, .http.request_duration.p95, .target.interval_length.p99, .rule.evaluation_failures, .notifications.dropped, .config.last_reload_successful, .process.resident_memory

Vingt-neuf autres profils (Consul, Vault, etcd, Traefik, Kafka par l'exportateur JMX, GitLab, Argo CD…) sont décrits dans Logiciels exposant Prometheus.

Contrôle et mesures de l'agent

Plugins Nagios, Monitoring Plugins et Centreon

L'agent lance des plugins au format Nagios et en tire un contrôle et des métriques :

integrations:
  nagios:
    - name: disque-racine
      command: check_disk -w 20% -c 10% -p /
      interval: 60s                        # 10 s au moins
      timeout: 30s                         # au plus l'intervalle
    - name: http-local
      command: [check_http, -H, 127.0.0.1, -u, /sante]
      user: nagios                         # compte qui lance le plugin (Linux)
    - name: charge-centreon
      command: [/usr/bin/perl, /usr/lib/centreon/plugins/centreon_plugins.pl,
                --plugin=os::linux::local::plugin, --mode=load]
      tags: {role: web}

Sécurité

Paquets usuels : monitoring-plugins (Debian, Ubuntu), nagios-plugins-all (EPEL) ; plugins Centreon : dépôt libre centreon-plugins (Perl, avec libjson-xs-perl).

Réception syslog

L'agent peut recevoir les journaux de vos équipements (pare-feux, switchs, routeurs, NAS, imprimantes) et de vos serveurs. Coupée par défaut.

syslog:
  enabled: true
  udp: 0.0.0.0:514                 # vide = pas d'UDP
  tcp: 0.0.0.0:514                 # vide = pas de TCP
  allowed_sources: [192.0.2.0/24]  # vide = toutes les sources
  max_connections: 64
  rate_limit: 2000                 # lignes par seconde, au-delà jetées et comptées
  parsers:
    - {match: 192.0.2.10, parser: kv}
  tags: {site: siege}

Les journaux reçus se cherchent comme les autres : source:syslog @syslog.hostname:fw01, source:syslog status:error.

Modèles des pare-feux et routeurs (Fortinet, Stormshield, pfSense, OPNsense, Palo Alto, Cisco ASA, SonicWall, WatchGuard, Check Point, MikroTik, Ubiquiti) : voir Équipements réseau et sécurité (syslog).

Modèles de moniteurs et tableaux

Famille Collecte générique du catalogue de moniteurs : cible OpenMetrics injoignable, plafond de séries atteint, plugin Nagios en alerte, réception syslog en échec, équipement syslog muet, lignes syslog jetées, erreurs graves reçues par syslog.

Le catalogue de tableaux propose « Cibles OpenMetrics et Prometheus », « node_exporter (Prometheus) », « Serveur Prometheus », « Plugins Nagios et Centreon » et « Journaux reçus par syslog ».

Mise à jour : 20 novembre 2026