HYPHApar S33D
Documentation › Intégrations

Intégrations du système, du web et de la messagerie

L'agent reconnaît les logiciels installés et relève leurs mesures, aux noms compatibles Datadog. La plupart s'activent seules.

Principe

Les réglages vont dans integrations.<nom> de la configuration. Les bases de données ont leur page : Bases de données.

Serveurs web et répartiteurs

IntégrationSourceMesures principalesActivation
nginxpage stub_statusnginx.requests, nginx.connections.active, .reading, .writing, .waitingenabled: true et url
apachemod_status (?auto)apache.net.hits, .request_per_s, .bytes_per_s, apache.performance.busy_workers, .idle_workers, apache.conns_totalauto
haproxysocket d'administration (show stat) ou page CSVhaproxy.frontend.*, haproxy.backend.*, haproxy.server.*, haproxy.backend_up, haproxy.server.upauto
iis (Windows)compteurs de performanceiis.requests_per_s, iis.current_connectionsauto

Pour nginx, ouvrez la page d'état à la seule boucle locale :

location /nginx_status { stub_status; allow 127.0.0.1; deny all; }
integrations:
  nginx: {enabled: true, url: http://127.0.0.1/nginx_status}
  apache: {enabled: auto, url: "http://127.0.0.1/server-status?auto"}
  haproxy: {enabled: auto, socket: /run/haproxy/admin.sock}   # ou url: http://127.0.0.1:8404/stats;csv

Les journaux d'accès de nginx, d'Apache et de HAProxy sont découpés à l'arrivée : méthode, chemin, code HTTP, durée, adresse du client. Voir Journaux.

PHP-FPM, Varnish, Squid, Lighttpd, Gunicorn et Supervisor, ainsi que PowerDNS, OpenLDAP, Keycloak, Nexus, Harbor, ZooKeeper et Ceph, ont leurs sondes dédiées : voir Applications et services.

Jenkins, GitHub (et GitHub Enterprise Cloud), le registre Zot et Odoo : voir CI, forges et gestion.

DNS

bind lit le canal de statistiques JSON (statistics-channels { inet 127.0.0.1 port 8053; };), sinon rndc status. Mesures : bind.queries par type, bind.responses.nxdomain, bind.responses.servfail, bind.zone.serial par zone, bind.recursive_clients.

Pi-hole, AdGuard Home et Unbound, ainsi que Caddy, MinIO, Mosquitto, Proxmox Backup Server, Borg et restic, ont leur page : Réseau, stockage et sauvegardes.

Messagerie

IntégrationSourceMesures et contrôles
postfixpostqueue -j et journaux de remisepostfix.queue.size par file (active, deferred, hold, incoming), postfix.delivery.sent, .deferred, .bounced
dovecotdoveadm stats dump, doveadm whodovecot.auth.success, .failures, dovecot.connections
rspamdpage /stat localerspamd.messages.scanned, .learned, .spam, .ham, rspamd.actions par action, rspamd.connections
exchange (Windows)compteurs de performanceexchange.queue.<état> par dépôt de transport, exchange.database.mounted (et contrôle), exchange.imap.connections ; contrôles des messages en quarantaine ou suspendus

Pour vérifier la messagerie de bout en bout (bannière SMTP, IMAP, envoi puis relève, SPF, DKIM, DMARC, listes noires), voir les tests synthétiques de messagerie.

Sécurité et accès

integrations:
  ssh:
    targets:
      - {name: bastion, address: "bastion.exemple:22", expect_banner: "^SSH-2.0-OpenSSH_9"}
      - {address: 192.0.2.10}          # port 22 par défaut

Certificats

x509 suit les certificats posés sur l'hôte : tls.cert.days_left et le contrôle tls.cert.expiry (avertissement sous 21 jours, critique sous 7 jours), relus toutes les heures.

La page Certificats de l'interface rassemble tous les certificats relevés par les agents et par les tests synthétiques, triés par échéance.

Matériel et système

IntégrationSourceMesures et contrôles
smartsmartctl, toutes les 30 min, sans réveiller un disque en veillesmart.health, .temperature, .reallocated_sectors, .power_on_hours, .wear_level
hwmon/sys/class/hwmonsystem.temperature, system.fan.rpm
ntpchronyc, timedatectl ou ntpq ; w32tm sous Windowsntp.offset, contrôle ntp.in_sync
updatescache du gestionnaire de paquets (sans apt update), relu toutes les heuressystem.updates.pending, .security, system.reboot_required ; Windows : contrôle windows.updates.pending
systemd_timerssystemctlcontrôle systemd.timer : critique si le dernier passage a échoué, avertissement si un timer actif n'a pas tourné depuis deux périodes
virtualboxVirtualBox.xml des comptes et processusvirtualbox.vms.running, .total, contrôle virtualbox.vm.running des VM en démarrage automatique
btrfs/sys/fs/btrfs (compteurs d'erreurs : noyau 5.14 et plus, sinon btrfs device stats)par système de fichiers monté : btrfs.allocated, .used, .usage par type (usage_type) et profil (replication_type), btrfs.unallocated et .unallocated.pct, btrfs.device.errors ; contrôle btrfs.health : critique si un disque manque, avertissement si des compteurs d'erreurs ne sont pas nuls
nfsclient : /proc/1/mountstats ; serveur : /proc/net/rpc/nfsdclient, par montage : opérations, octets lus et écrits, temps aller-retour et d'exécution moyens, retransmissions, délais dépassés, occupation ; contrôle nfs.mount (critique si statfs ne répond pas dans timeout, 5 s : montage figé). Serveur : fils nfsd, appels RPC et mauvais appels, octets, opérations par version, exports ; contrôle nfs.server

Un serveur NFS en conteneur garde ses statistiques dans son propre espace réseau : integrations.nfs.server_stats: /proc/<pid du conteneur>/net/rpc/nfsd. nfs.mounts restreint les montages suivis (motifs).

Processus, ports et pages

Sans intégration particulière, l'agent sait aussi contrôler :

Vos propres mesures

L'agent écoute StatsD au format DogStatsD sur 127.0.0.1:8125/udp, agrège sur 15 secondes et envoie le tout comme des métriques ordinaires :

echo "boutique.commandes:1|c|#env:prod" | nc -u -w0 127.0.0.1 8125

Pour une application qui publie déjà ses mesures au format Prometheus, des plugins Nagios ou Centreon, ou des journaux envoyés par syslog, voir Collecte générique.

Les compteurs (c) deviennent des sommes, les jauges (g) des valeurs, les durées (ms, h) des distributions (.avg, .max, .p50, .p95, .p99, .count). Pour les métriques OpenTelemetry, voir Traces.

Mise à jour : 20 novembre 2026