Collection de la zone Flexi
Collecte de métriques de performance et d'alarmes pour les stations de base Nokia Flexi Zone classiques
RAN Monitor est multi-fournisseur. Les stations de base Nokia Flexi Zone classiques (FZM, par exemple le Flexi Zone Indoor Pico) sont prises en charge aux côtés de Nokia AirScale, Casa Systems et Baicells.
Les unités Flexi Zone sont intégrées via l'API, comme Casa. Vous soumettez l'adresse IP de la station de base et ses identifiants de gestion à RAN Monitor. RAN Monitor configure ensuite la station de base pour envoyer ses métriques de performance (PM) et ses alarmes à RAN Monitor via HTTP. Après l'intégration, l'unité rapporte d'elle-même sur un minuteur. Aucune action supplémentaire n'est nécessaire.
Table des matières
- Aperçu
- Architecture
- Intégration d'une unité
- Configuration
- Ce qui est collecté
- API
- Métriques
- Dépannage
Aperçu
Une station de base Flexi Zone classique n'a pas l'interface webhook NE3S que utilise AirScale. RAN Monitor collecte à partir de celle-ci avec un modèle de push à la place :
- Vous intégrez l'unité une fois via l'API. Vous donnez à RAN Monitor l'adresse IP de la station de base et ses identifiants de gestion.
- RAN Monitor configure l'unité pour envoyer de nouveaux fichiers PM et un instantané d'alarme à RAN Monitor toutes les quelques minutes.
- RAN Monitor reçoit chaque push, analyse les compteurs et les écrit dans InfluxDB. Il enregistre également les alarmes actives.
Les données PM utilisent le format XML OMeS de Nokia, le même format de compteur que AirScale. RAN Monitor réutilise le parseur OMeS existant, donc les compteurs Flexi Zone apparaissent à côté des autres fournisseurs sans configuration supplémentaire.
L'accès de gestion à la station de base est ouvert uniquement pendant l'intégration. RAN Monitor le ferme à nouveau à la fin. Le push régulier de PM et d'alarmes ne l'utilise pas.
Architecture
La séquence d'intégration :
Intégration d'une unité
Pour intégrer une Flexi Zone, soumettez son IP et ses identifiants de gestion à l'API :
POST /api/flexi/onboard
{
"ip": "10.7.15.67",
"bts_username": "Nemuadmin",
"bts_password": "nemuuser",
"ssh_password": "<service-account password>"
}
RAN Monitor effectue alors automatiquement les actions suivantes :
- Il ouvre l'accès de gestion sur la station de base.
- Il installe une petite tâche de push sur l'unité. La tâche envoie de nouveaux fichiers PM et l'instantané d'alarme à RAN Monitor.
- Il démarre la tâche. La tâche s'exécute toutes les 5 minutes.
- Il ferme à nouveau l'accès de gestion.
L'unité commence à rapporter dans quelques minutes. La station de base conserve la tâche de push après l'intégration.
Paramètres de la requête d'intégration :
| Paramètre | Type | Requis | Par défaut | Description |
|---|---|---|---|---|
ip | Chaîne | Oui | - | Adresse IP OAM de la station de base, accessible depuis RAN Monitor. |
bts_username | Chaîne | Non | Nemuadmin | Nom d'utilisateur pour l'interface de gestion web de la station de base. |
bts_password | Chaîne | Non | nemuuser | Mot de passe pour l'interface de gestion web de la station de base. |
ssh_username | Chaîne | Non | Compte de service Nokia | Compte de service utilisé pour installer la tâche de push. |
ssh_password | Chaîne | Non | Par défaut de Nokia | Mot de passe du compte de service. À définir lorsque l'opérateur l'a changé. |
push_interval | Chaîne | Non | 5min | Fréquence à laquelle la station de base pousse PM et alarmes. Utilisez une durée systemd, par exemple 5min ou 15min. |
keep_ssh | Booléen | Non | false | Laisser l'accès de gestion ouvert après l'intégration. Gardez false en production. |
RAN Monitor ne retourne jamais les identifiants dans la réponse. Une réponse de succès indique l'IP cible, l'adresse RAN Monitor à laquelle l'unité poussera, les étapes d'intégration et si l'accès de gestion a été laissé ouvert :
{
"status": "ok",
"ip": "10.7.15.67",
"ranmon_host": "10.4.2.250",
"ranmon_port": 9081,
"ssh_left_enabled": false,
"steps": ["activation de l'accès de gestion", "installation de la tâche de push", "accès de gestion fermé"]
}
Remarque sur le redémarrage : RAN Monitor ne redémarre pas l'unité pendant l'intégration. Le push commence immédiatement. Si la station de base redémarre plus tard, ou si un ingénieur la remet en service avec BTS Site Manager ou NetAct, relancez l'intégration pour restaurer la tâche de push.
Configuration
RAN Monitor reçoit les pushes Flexi Zone sur un point de terminaison dédié. Définissez le point de terminaison dans runtime.exs :
config :ran_monitor, :nokia,
flexi_push: [
port: 9081,
advertised_host: "10.4.2.250"
]
Paramètres :
| Paramètre | Type | Requis | Par défaut | Description |
|---|---|---|---|---|
port | Entier | Non | 9081 | Port TCP pour les pushes PM et alarmes Flexi Zone entrants. Remplacez par la variable d'environnement FLEXI_PUSH_PORT. |
advertised_host | Chaîne | Non | Adresse locale de RAN Monitor | Adresse que RAN Monitor écrit dans la tâche de push de la station de base. La station de base l'utilise pour atteindre RAN Monitor. Définissez ceci lorsque RAN Monitor a plus d'une adresse ou est derrière un NAT. |
La station de base doit atteindre http://<advertised_host>:<port>. Confirmez que les règles de pare-feu autorisent ce trafic depuis le réseau OAM de la station de base.
Ce qui est collecté
Métriques de performance. L'unité envoie des fichiers PM OMeS. Chaque fichier contient une ou plusieurs périodes de mesure. RAN Monitor écrit chaque compteur dans InfluxDB, tagué avec l'identité de la station de base. Les types de mesures de transport sont toujours présents. Les compteurs radio et de cellule apparaissent lorsqu'une cellule transporte du trafic. Types de mesures typiques :
| Type de mesure | Zone |
|---|---|
LTE_Ethernet_Link | Lien Ethernet de retour |
LTE_ETHIF_stats | Interface Ethernet |
LTE_IP_Stats | Couche IP |
LTE_IP_Filtering | Filtrage de paquets IP |
LTE_IPSec | IPsec |
LTE_L2_SWITCH_Stats | Commutateur de couche 2 |
LTE_TAC_Stats | Contrôle d'admission de transport |
Pour les définitions de compteurs, voir la Référence des compteurs Nokia.
Alarmes. L'unité envoie sa liste de défauts actifs. RAN Monitor enregistre chaque défaut actif avec son identité de défaut, son nom, son objet source et son horodatage. Pour la gestion des alarmes, voir le Guide de gestion des alarmes.
API
| Méthode + chemin | But |
|---|---|
POST /api/flexi/onboard | Intégrer une station de base par IP. RAN Monitor configure l'unité pour pousser PM et alarmes, puis ferme l'accès de gestion. |
GET /api/flexi/devices | Lister les unités Flexi Zone qui ont poussé. Affiche le numéro de série, l'IP source, le dernier temps PM et le dernier temps d'alarme. |
Les deux points de terminaison sont sur le port de point de terminaison de push Flexi (par défaut 9081).
Métriques
RAN Monitor écrit les compteurs Flexi Zone dans InfluxDB dans les mêmes mesures que les autres sources Nokia. Interrogez-les par le tag d'identité de la station de base. Pour les métriques au niveau de l'application Prometheus que RAN Monitor expose concernant l'ingestion, voir la Référence des métriques.
Dépannage
L'unité n'apparaît pas après l'intégration
Symptômes : GET /api/flexi/devices ne liste pas la station de base.
Causes possibles :
- La station de base ne peut pas atteindre
advertised_host:port. - Un pare-feu bloque le trafic de push.
- Les identifiants de gestion dans la requête d'intégration sont incorrects.
Résolution :
- Confirmez que
advertised_hostetportsont corrects dansruntime.exs. - Confirmez que le réseau OAM de la station de base peut atteindre RAN Monitor sur ce port.
- Relancez l'intégration avec les identifiants de gestion corrects.
PM arrêté après un redémarrage de la station de base
Symptômes : L'unité a rapporté auparavant, mais s'est arrêtée après la maintenance.
Causes possibles :
- L'unité a redémarré. La tâche de push ne survit pas à un redémarrage.
- Un ingénieur a remis l'unité en service avec BTS Site Manager ou NetAct.
Résolution :
- Relancez l'intégration pour cette station de base.
Les alarmes se mettent à jour mais PM ne le fait pas
Symptômes : L'heure de l'alarme avance, mais aucun nouveau PM n'arrive.
Causes possibles :
- L'unité n'a produit aucun nouveau fichier PM depuis le dernier push.
- Aucune cellule ne transporte de trafic, donc seuls des compteurs de transport sont produits.
Résolution :
- Attendez la prochaine période PM.
- Confirmez qu'une cellule est active si vous attendez des compteurs radio.