Guide de l'interface utilisateur Web
Panneau de contrôle du moniteur RAN - Référence de l'interface utilisateur
Guide complet pour utiliser le panneau de contrôle basé sur le Web du moniteur RAN
Table des matières
- Aperçu
- Accéder à l'interface utilisateur Web
- Tableau de bord principal
- Page des stations de base
- Vue des détails de l'appareil
- Page des alarmes
- Gestion de la configuration
- Page des eNodeBs non configurés
- Page des journaux d'application
- Page de politique de conservation des données
- Page d'état InfluxDB
- Flux de travail de l'interface utilisateur Web
Aperçu
Le moniteur RAN comprend un panneau de contrôle basé sur le Web pour la surveillance et la gestion opérationnelles en temps réel. L'interface utilisateur Web offre une visibilité immédiate sur l'état des appareils, les alarmes, la configuration et la santé du système.
Interface utilisateur Web vs. Grafana
L'interface utilisateur Web est idéale pour :
- Vérifications immédiates de l'état des appareils
- Surveillance des alarmes en temps réel
- Gestion de la configuration
- Dépannage de session
- Administration système
Grafana est idéal pour :
- Analyse des tendances historiques
- Tableaux de bord KPI personnalisés
- Planification de capacité à long terme
- Identification de modèles
- Rapports exécutifs
Pour les tableaux de bord et les analyses Grafana, consultez le Guide d'intégration Grafana.
Accéder à l'interface utilisateur Web
Le panneau de contrôle est accessible via HTTPS :
URL : https://<ran-monitor-ip>:9443
Port par défaut : 9443 (configurable via la variable d'environnement CONTROL_PANEL_HTTPS_PORT)
Certificats SSL :
- Les certificats auto-signés fonctionnent pour les environnements de laboratoire
- La production doit utiliser des certificats signés par une CA
- Certificats configurés dans
config/runtime.exs
Pour les détails de configuration, consultez le Guide de configuration d'exécution.
Actualisation automatique : La plupart des pages se rafraîchissent automatiquement toutes les 5 secondes pour afficher des données en temps réel.
Tableau de bord principal
Le tableau de bord fournit une vue d'ensemble de votre infrastructure RAN.
Sections clés
État du système
- Indicateurs de santé globaux
- Temps de disponibilité et connectivité du système
Résumé des appareils
- Nombre d'appareils associés/échoués
- Vue d'ensemble de l'état d'enregistrement
- Instantané rapide de la santé des appareils
Alarmes actives
- Nombre actuel de pannes par gravité
- Niveaux de gravité codés par couleur (Critique, Majeur, Mineur, Avertissement)
- Liens rapides vers les détails des alarmes
Activité récente
- Derniers événements et changements
- Mises à jour de configuration
- Changements d'état de session
Fonctionnalités
- Se rafraîchit automatiquement toutes les 5 secondes
- Indicateurs de statut codés par couleur (vert = sain, rouge = problèmes)
- Navigation par clic vers des vues détaillées
- Mises à jour des métriques en temps réel
Page des stations de base
Affichez tous les appareils gérés avec leur état actuel et les informations de session.
Informations affichées
État de connexion
- Vert (associé) - L'appareil est connecté et opérationnel
- Rouge (échoué) - L'appareil ne répond pas ou a des problèmes de connexion
État d'enregistrement
- Montre si l'appareil est correctement enregistré auprès du moniteur RAN
- Détails de la session d'enregistrement
Informations de session
- Détails de la session active
- Heure de création de la session
- Heure d'expiration de la session
- État de maintien en vie
Dernier contact
- Horodatage de la dernière communication réussie
- Aide à identifier les appareils non réactifs
Actions disponibles
Filtrer et rechercher :
- Filtrer par statut (tous/associés/échoués)
- Rechercher par nom d'appareil ou adresse IP
- Trier par n'importe quelle colonne
Gestion des appareils :
- Cliquez sur n'importe quel appareil pour voir des informations détaillées
- Vue d'ensemble rapide de l'état de tous les appareils
- Liens vers la configuration de l'appareil
Vue des détails de l'appareil
Cliquez sur n'importe quel appareil depuis la page des stations de base pour voir des informations complètes.
Détails d'enregistrement
- Identité du gestionnaire et état d'authentification
- Horodatage d'enregistrement
- Informations d'identification d'authentification utilisées
- Clés et certificats du gestionnaire
Cycle de vie de la session
- Heure de création de la session
- Heure d'expiration de la session
- Intervalle et état de maintien en vie
- Dernier horodatage de maintien en vie
- Temps restant jusqu'à l'expiration
Métriques récentes
- Derniers instantanés de données de performance
- Valeurs de compteur et horodatages
- État de collecte des métriques
- Intervalles de collecte de données
Alarmes actives
- Pannes actuelles pour cet appareil spécifique
- Gravité et description de l'alarme
- Horodatages des alarmes
- Informations sur la cause probable
État de configuration
- Valeurs de paramètres actuelles
- Changements récents de configuration
- Horodatage de configuration
- Historique des changements de paramètres
Page des alarmes
Surveillez toutes les pannes de votre réseau dans une vue centralisée.
Informations sur les alarmes
Niveaux de gravité :
- Critique (Rouge) - Affecte le service, action immédiate requise
- Majeur (Orange) - Dégradation significative, attention urgente nécessaire
- Mineur (Jaune) - Non affectant le service, doit être traité
- Avertissement (Bleu) - Informatif, surveiller les tendances
- Résolu (Vert) - Alarme précédemment active a été résolue
Détails de l'alarme :
- Description du problème
- Cause probable
- Système affecté (DN - Nom Distingué)
- Horodatages (quand l'alarme s'est produite et dernière mise à jour)
Fonctionnalités
Codage couleur :
- Identification visuelle immédiate de la gravité
- Rouge = Alarmes critiques
- Orange = Alarmes majeures
- Jaune = Alarmes mineures
- Bleu = Avertissements
- Vert = Résolu
Tri et filtrage :
- Trier par gravité, appareil ou temps
- Filtrer par type d'alarme
- Rechercher des problèmes spécifiques
Liens vers les appareils :
- Cliquez sur l'alarme pour voir les détails de l'appareil affecté
- Vérifiez les métriques de l'appareil
- Naviguez vers la configuration de l'appareil
Pour des procédures détaillées de gestion des alarmes, consultez le Guide de gestion des alarmes.
Gestion de la configuration
L'interface utilisateur Web fournit des outils pour gérer les configurations des appareils de manière sûre et efficace.
Télécharger la configuration
Objectif : Récupérer et sauvegarder la configuration actuelle
Étapes :
- Accédez à la page de détails de l'appareil
- Cliquez sur "Télécharger la configuration"
- La configuration est récupérée depuis l'appareil
- Sauvegardez la configuration en tant que fichier XML
Meilleure pratique : Téléchargez et sauvegardez toujours la configuration avant de faire des modifications
Télécharger la configuration
Objectif : Appliquer une nouvelle configuration à l'appareil
Étapes :
- Sélectionnez le fichier de configuration XML
- Cliquez sur "Télécharger la configuration"
- La configuration est téléchargée sur l'appareil (crée un "plan")
- Le système retourne un ID de plan pour le suivi
Important : Le téléchargement ne crée qu'un plan - il n'active pas la configuration
Valider la configuration
Objectif : Vérifier que la configuration est valide avant l'activation
Étapes :
- Entrez l'ID de plan du téléchargement
- Cliquez sur "Valider"
- L'appareil valide la syntaxe et les paramètres
- Le système confirme la préparation à l'activation ou signale des erreurs
Remarque : Validez toujours avant d'activer pour éviter les erreurs de configuration
Activer la configuration
Objectif : Appliquer le plan de configuration validé
Étapes :
- Entrez l'ID de plan validé
- Cliquez sur "Activer la configuration"
- Les changements prennent effet immédiatement sur l'appareil
- Surveillez l'état pour le succès/l'échec
Avertissement : L'activation est immédiate et peut affecter le service - assurez-vous que la validation a réussi d'abord
Flux de travail de configuration
Processus recommandé :
- Télécharger la configuration actuelle (sauvegarde)
- Modifier la configuration hors ligne
- Télécharger la nouvelle configuration (obtenir l'ID de plan)
- Valider la configuration (vérifier qu'il n'y a pas d'erreurs)
- Activer si la validation réussit
- Vérifier que les changements ont pris effet
- Surveiller l'appareil pour la stabilité
Pour les détails de configuration des stations de base, consultez le Guide de configuration AirScale.
Page des eNodeBs non configurés
Découvrez et gérez les stations de base tentant de se connecter qui ne sont pas encore configurées dans le système.
Objectif
La page des eNodeBs non configurés vous aide à :
- Découvrir de nouvelles stations de base sur le réseau
- Identifier les appareils tentant des connexions non autorisées
- Vérifier les identifiants des appareils avant de les ajouter à la configuration
- Suivre les tentatives de connexion d'équipements inconnus
Informations affichées
ID de l'agent
- Identifiant de l'appareil détecté lors des tentatives de connexion
- Utilisez cet ID lors de l'ajout de l'appareil à la configuration
Dernière vue
- Horodatage de la dernière tentative de connexion
- Aide à identifier les appareils actifs vs inactifs
Occurrences
- Nombre de fois que l'appareil a tenté de se connecter
- Des tentatives fréquentes peuvent indiquer une mauvaise configuration
Première vue
- Quand l'appareil a été détecté pour la première fois
- Utile pour suivre les nouveaux équipements
Actions disponibles
Rafraîchir
- Recharger la liste des appareils non configurés
- Met à jour les horodatages et les comptes d'occurrences
Supprimer
- Supprimer des entrées individuelles de la liste
- Utile pour nettoyer les appareils anciens/déclassés
Tout effacer
- Supprimer tous les enregistrements d'appareils non configurés
- Nouveau départ pour la liste
Aide à la configuration
Lorsque des appareils apparaissent ici, suivez ces étapes :
- Notez l'ID de l'agent à partir du tableau
- Ajoutez la configuration de l'appareil à
config/runtime.exs:airscales: [
%{
address: "10.7.15.66",
name: "Site-A-BS1",
port: "8080",
web_username: "admin",
web_password: "password"
}
] - Redémarrez le moniteur RAN pour commencer à surveiller l'appareil
Pour des instructions de configuration détaillées, consultez le Guide de configuration d'exécution.
Cas d'utilisation
- Découverte de réseau : Trouver de nouvelles stations de base ajoutées au réseau
- Sécurité : Identifier les tentatives de connexion non autorisées
- Provisionnement : Vérifier les identifiants des appareils avant la configuration
- Déclassement : Suivre les tentatives d'appareils qui devraient être hors ligne
Page des journaux d'application
Tableau de bord de journalisation en temps réel pour le dépannage et la surveillance de l'activité du système.
Niveaux de journal
Filtrer par niveau de journal :
- Urgent - Pannes critiques pour le système
- Alerte - Action immédiate requise
- Critique - Conditions critiques
- Erreur - Conditions d'erreur
- Avertissement - Conditions d'avertissement
- Avis - Normal mais significatif
- Info - Messages informatifs
- Débogage - Informations détaillées de débogage
Remarque : Lors du filtrage, le niveau sélectionné et tous les niveaux de gravité supérieurs sont affichés.
Fonctionnalités
Recherche et filtrage :
- Recherche textuelle dans tous les messages de journal
- Diffusion en temps réel des journaux (derniers 500 messages)
- Filtrer par niveau de journal
Contrôles :
- Pause/Reprendre - Arrêter la diffusion en direct des journaux pour examiner les messages
- Effacer - Supprimer tous les journaux de l'affichage
- Niveau système - Changer dynamiquement le niveau de journalisation de l'application
Codage couleur :
- Rouge - Niveaux Urgent/Alerte/Critique
- Rouge clair - Niveau Erreur
- Jaune - Niveau Avertissement
- Cyan - Niveau Avis
- Bleu - Niveau Info
- Gris - Niveau Débogage
Cas d'utilisation
Dépanner les problèmes de connexion :
- Filtrer les erreurs provenant d'appareils spécifiques
- Rechercher des noms d'appareils ou des adresses IP
- Examiner les messages d'échec de connexion
Surveiller l'activité du système :
- Surveiller les journaux de niveau info pour les opérations normales
- Suivre les événements d'enregistrement des appareils
- Surveiller l'activité de collecte de données
Déboguer des problèmes :
- Définir temporairement le niveau de débogage
- Reproduire le problème
- Examiner les journaux détaillés
- Revenir au niveau info une fois terminé
Enquêter sur les pannes :
- Rechercher des messages d'erreur et des traces de pile
- Examiner les horodatages autour de l'heure de la panne
- Corréler avec les événements des appareils
Meilleures pratiques
- Utilisez Pause lors de l'examen de séquences d'erreurs spécifiques
- Définissez le niveau de journal approprié :
- Info pour la production
- Débogage pour le dépannage
- Avertissement pour une production tranquille
- Recherchez efficacement en utilisant des noms d'appareils ou des mots-clés d'erreur
- Les changements de niveau de journal persistent jusqu'au redémarrage de l'application
Page de politique de conservation des données
Gérez combien de temps les données sont stockées dans InfluxDB pour chaque station de base.
Affichage des paramètres globaux
Période de conservation par défaut
- Politique de conservation à l'échelle du système en heures/jours
- Configuré dans
config/config.exs - Par défaut : 720 heures (30 jours)
Total des enregistrements
- Nombre de tous les points de données à travers tous les appareils
- Mis à jour lors du rafraîchissement de la page
État de nettoyage automatique
- Montre les nettoyages exécutés toutes les heures
- État du travailleur en arrière-plan
Paramètres par appareil
Pour chaque station de base configurée :
Informations sur l'appareil :
- Nom de l'appareil
- État d'enregistrement (Enregistré/Non enregistré)
- Paramètre de période de conservation actuel
Comptes d'enregistrements :
- Métriques de performance - Nombre de points de données PM stockés
- Configuration - Nombre de captures d'écran de configuration
- Alarmes - Nombre d'enregistrements d'alarme
- Total - Somme de tous les enregistrements pour cet appareil
Actions :
- Mettre à jour la période de conservation - Changer les heures de conservation (s'applique uniquement à cet appareil)
- Nettoyer les anciennes données - Déclencher manuellement le nettoyage en fonction de la période de conservation
- Effacer toutes les données - Supprimer toutes les données pour cet appareil (irréversible)
Comment fonctionne la conservation
- Par défaut global - Défini dans le fichier de configuration, s'applique à tous les appareils
- Surcharge par appareil - Optionnellement définir une conservation personnalisée pour des appareils spécifiques
- Nettoyage automatique - S'exécute toutes les heures, supprime les données plus anciennes que la période de conservation
- Nettoyage manuel - Utilisez "Nettoyer les anciennes données" pour forcer un nettoyage immédiat
Périodes de conservation courantes
- 720 heures (30 jours) - Surveillance opérationnelle à court terme
- 2160 heures (90 jours) - Conservation standard pour la plupart des déploiements
- 4320 heures (180 jours) - Conservation prolongée pour conformité
- 8760 heures (365 jours) - Analyse historique à long terme
Cas d'utilisation
- Réduire l'utilisation de stockage en abaissant la période de conservation
- Conserver les données critiques des appareils plus longtemps que les autres
- Nettoyer les données de test avant la production
- Gérer l'utilisation de l'espace disque InfluxDB
Avertissement : Effacer toutes les données est permanent et ne peut pas être annulé. Vérifiez toujours avant d'exécuter.
Pour des informations détaillées sur la politique de conservation, consultez le Guide de politique de conservation des données.
Page d'état InfluxDB
Surveillez la santé et l'état de votre base de données de séries temporelles InfluxDB.
État de connexion
Indicateur de connexion
- Vert (connecté) - InfluxDB est accessible
- Rouge (déconnecté) - Problème de connexion détecté
Nom de la base de données
- Nom de seau InfluxDB configuré
- Doit correspondre à la configuration d'exécution
Version InfluxDB
- Version de base de données détectée
- Utile pour la vérification de compatibilité
Comptes de mesures
Comptes de points de données en temps réel pour chaque type de mesure :
- Métriques de performance - Points de données PM collectés
- Configuration - Captures d'écran de configuration stockées
- Alarmes - Enregistrements d'alarmes dans la base de données
- Total - Somme de tous les points de données
Informations de stockage
- Politiques de conservation - Paramètres de conservation actuellement configurés
- Utilisation du disque - Taille estimée de la base de données
- Dernière mise à jour - Horodatage de la dernière écriture de données
Détails de configuration
- Hôte et port InfluxDB
- Nom de seau configuré
- État de connexion
- Nombre de mesures
Diagnostics de santé
- État de connectivité InfluxDB
- Activité de collecte de données
- État de la politique de conservation
- Dernier horodatage de synchronisation
Actualisation automatique
La page se rafraîchit automatiquement toutes les 5 minutes pour afficher les statistiques actuelles.
Interpréter l'état
- Connecté + Comptes de données croissants - Système fonctionnant normalement
- Connecté + Pas de données - Vérifiez l'enregistrement de l'appareil et le sondage
- Déconnecté - Vérifiez qu'InfluxDB fonctionne et la connectivité réseau
- Croissance de stockage élevée - Révisez les politiques de conservation
Cas d'utilisation
- Vérifiez qu'InfluxDB reçoit des données
- Surveillez la croissance et le stockage de la base de données
- Dépannez les problèmes de connexion
- Confirmez que les données sont écrites
Flux de travail de l'interface utilisateur Web
Flux de travail opérationnels courants utilisant l'interface utilisateur Web.
Vérification quotidienne de la santé
Objectif : Vérifier la santé du système au début du quart
Étapes :
- Ouvrez le tableau de bord principal
- Vérifiez que tous les appareils affichent un statut vert
- Vérifiez le nombre d'alarmes et leur gravité
- Examinez les appareils rouges/échoués
- Enquêtez sur les problèmes si nécessaire
- Documentez toute action entreprise
Temps : < 5 minutes
Enquête sur les alarmes
Objectif : Répondre et résoudre les alarmes
Étapes :
- Ouvrez la page des alarmes
- Triez par gravité (Critique en premier)
- Cliquez sur l'alarme pour des détails complets
- Naviguez vers l'appareil affecté
- Vérifiez les métriques récentes
- Déterminez l'action requise
- Mettez en œuvre la résolution
- Vérifiez que l'alarme se dissipe
Pour des procédures détaillées de gestion des alarmes, consultez le Guide de gestion des alarmes.
Mise à jour de la configuration
Objectif : Mettre à jour en toute sécurité la configuration de l'appareil
Étapes :
- Téléchargez la configuration actuelle (sauvegarde)
- Modifiez la configuration hors ligne à l'aide des outils appropriés
- Téléchargez la nouvelle configuration sur l'appareil
- Notez l'ID de plan retourné
- Validez la configuration en utilisant l'ID de plan
- Si la validation réussit, activez la configuration
- Vérifiez que les changements ont pris effet
- Surveillez la stabilité de l'appareil pendant 15-30 minutes
- Documentez le changement dans le système de gestion des changements
Remarques de sécurité :
- Validez toujours avant d'activer
- Apportez des modifications pendant les fenêtres de maintenance si possible
- Ayez un plan de retour prêt
- Surveillez les comportements inattendus
Ajout d'une nouvelle station de base
Objectif : Ajouter une station de base nouvellement déployée à la surveillance
Étapes :
- Vérifiez la page des eNodeBs non configurés pour l'appareil
- Notez l'ID de l'agent et l'adresse IP
- Ajoutez l'appareil à
config/runtime.exs - Redémarrez l'application moniteur RAN
- Vérifiez que l'appareil apparaît sur la page des stations de base
- Confirmez que l'enregistrement réussit (statut vert)
- Vérifiez que les métriques circulent vers InfluxDB
- Définissez la politique de conservation si nécessaire
- Ajoutez aux tableaux de bord Grafana
Pour des opérations détaillées, consultez le Guide des opérations courantes.
Dépannage de la connectivité des appareils
Objectif : Diagnostiquer et résoudre les problèmes de connexion des appareils
Étapes :
- Vérifiez la page des stations de base pour l'état de l'appareil
- Si rouge/échoué, cliquez sur l'appareil pour des détails
- Examinez les informations de session et le dernier temps de contact
- Vérifiez les journaux d'application pour les messages d'erreur
- Vérifiez la connectivité réseau (ping de l'appareil)
- Confirmez que les identifiants sont corrects
- Vérifiez que l'appareil est accessible sur le port configuré
- Examinez les journaux côté appareil si nécessaire
- Redémarrez la connexion ou l'appareil si nécessaire
- Vérifiez la récupération
Pour un dépannage détaillé, consultez le Guide de dépannage.
Documentation connexe
- Guide de démarrage - Configuration initiale et déploiement
- Guide des opérations courantes - Tâches opérationnelles quotidiennes
- Guide de gestion des alarmes - Gestion et escalade des alarmes
- Guide de configuration d'exécution - Configuration du système
- Guide d'intégration Grafana - Analyses et tableaux de bord
- Guide de politique de conservation des données - Gestion du cycle de vie des données
- Guide de dépannage - Problèmes courants et solutions