Métriques et Surveillance d'OmniEIR

Vue d'ensemble | Référence de Configuration | Guide des Opérations | Dépannage

Point de terminaison Prometheus

OmniEIR expose un point de terminaison de scraping Prometheus via TelemetryMetricsPrometheus sur prometheus_metrics_port (par défaut 9572):

GET http://<eir-host>:9572/metrics

Tous les labels ont une faible cardinalité (status / result / nf_type) afin que le nombre de séries reste limité.

Métriques

Métrique	Type	Labels	Description
omni_eir_equipment_check_count	compteur	status	Vérifications d'équipement par EquipmentStatus résolu (WHITELISTED/BLACKLISTED/GREYLISTED).
omni_eir_hss_request_count	compteur	result	Lectures OmniHSS GET /api/eir/rule par résultat (success/failure).
omni_eir_hss_request_duration_ms	jauge	result	Latence de la lecture de règle EIR OmniHSS la plus récente.
omni_eir_nrf_registration_status	jauge	nf_type	Statut d'enregistrement NRF (1 = enregistré, 0 = non).
beam_*	jauge	aucun	Statistiques standard de la VM BEAM (mémoire, comptes de processus/ports, temps de fonctionnement).

Événements de télémétrie sous-jacents

Événement	Mesures	Métadonnées	Émis par
[:omnieir, :equipment_check]	count	status	OmniEIR à chaque verdict résolu
[:omnieir, :hss, :request]	count, duration_ms	endpoint, result	OmniEIR à chaque GET /api/eir/rule vers OmniHSS
[:omniamf, :eir, :check]	count	result (:whitelisted | :greylisted | :blacklisted | :unknown | :error)	L'AMF à chaque vérification d'équipement

L'AMF émet également son événement existant [:omniamf, :registration, :result] avec result: :rejected lorsqu'un PEI blacklisté empêche un enregistrement. (La série [:omniamf, :eir, :check] est exposée sur le point de terminaison Prometheus de l'AMF, pas celui d'OmniEIR.)

Ce qu'il faut surveiller

• Un taux croissant de [:omnieir, :hss, :request] avec result: :failure signifie qu'OmniEIR ne peut pas atteindre OmniHSS. L'AMF échoue alors en mode ouvert (chaque appareil est autorisé). Alertez à ce sujet.
• [:omniamf, :eir, :check] avec result: :blacklisted compte les appareils interdits ; :error compte les événements de fail-open à l'AMF.

Journaux

OmniEIR et l'AMF enregistrent chaque décision. Lignes notables :

• AMF : 5G-EIR returned BLACKLISTED for PEI <pei> (<supi>); barring registration
• AMF : 5G-EIR check failed for <supi> (<reason>); failing open
• OmniEIR : Could not read EIR rules from HSS: <reason>