15 min (S0.1 : 15 min)
identifiants de la VM reçus
présentation de Telcéa
15 min
Formation = 2 jours × 7 h = 14 h (≈ 65 % de pratique)| Jour | Thème | Résultat |
|---|---|---|
| J1 | Construire | Sources raccordées, tableau de bord du NOC |
| J2 | Exploiter | Variables, plugins, partage, alertes, droits |
QCM d'ancrage par module, QCM final en fin de J2
flowchart LR A["M01-M02<br/>Supervision<br/>Grafana"] --> B["M03<br/>Sources"] B --> C["M04-M05<br/>Dashboard<br/>Graphiques"] C --> D["M06-M07<br/>Variables<br/>Plugins"] D --> E["M08-M09<br/>Partage<br/>Alertes"] E --> F["M10-M12<br/>Droits<br/>Croisement"]
| Jour | Modules | Durée |
|---|---|---|
| J1 | M01 Introduction · M02 Grafana · M03 Sources de données | 3 h 15 |
| J1 | M04 Création d'un dashboard · M05 Graphiques · bilan J1 | 3 h 00 |
| J2 | M06 Variables · M07 Plugins · M08 Partage | 2 h 45 |
| J2 | M09 Alertes · M10 Droits · M11 Croisement · M12 Plugin, bilan | 3 h 20 |
Réseau = 12 sites radio (4G / 5G) + 4 régions + 3 liens vers le cœurAvant: indicateurs dispersés → alarmes lues à la main → panne vue par les clients
Après: tableau de bord national → alertes par équipe → panne vue en 1 à 5 min
radio (sites) et transport (liens, routeurs)NOC = Network Operations Center (supervision 24 h / 24)
flowchart LR BZH["Bretagne<br/>REN, BRE, QUI"] -->|REN-PAR| PAR["Cœur Paris<br/>PAR-01, PAR-02, SDN"] HDF["Hauts-de-France<br/>LIL, AMI, DUN"] -->|LIL-PAR| PAR PRV["Provence<br/>MRS, TLN, AVI"] -->|MRS-PAR| PAR
Accès = 1 URL Grafana + 1 URL bureau + 1 mot de passe| Accès | URL | Usage |
|---|---|---|
| Grafana | https://stagiaireNN.<SESSION>.kovalibre-labs.com/grafana/ |
Tous les labs |
| Bureau Linux | https://stagiaireNN.<SESSION>.kovalibre-labs.com/ |
Terminal (labs ⭐⭐⭐) |
admin · identifiant bureau : stagiaireoubli de /grafana/ en fin d'URL → page du bureau Linux
lab bloqué > 5 min → signaler (tableau de bord de rattrapage disponible)
/grafana/, bureau à la racine/metrics des cibles.45 min (S1.1 : 25 min · S1.2 : 20 min)
M00
NOC de Telcéa, aucun outil raccordé
25 min
Évolution = Monolithe → N-tiers → Microservices + conteneursflowchart LR M["Monolithe<br/>1 serveur"] --> N["N-tiers<br/>web + appli + BDD"] N --> S["Microservices<br/>dizaines de services"] S --> C["Conteneurs<br/>éphémères"]
DevOps = Culture + Automatisation + Mesure + Partageflowchart LR P["Planifier"] --> C["Coder"] --> B["Construire"] --> T["Tester"] T --> D["Déployer"] --> O["Exploiter"] --> M["Superviser"] M --> P
Supervision = Collecter + Stocker + Visualiser + AlerterAvant: panne signalée par un client → recherche manuelle (heures)
Après: alerte automatique → tableau de bord de diagnostic (minutes)
| Usage | Exemple Telcéa | Public |
|---|---|---|
| Comprendre et planifier | Croissance du trafic 5G par région | Pilotage, architecture |
| Visualiser et partager | Écran du NOC : état des 12 sites | Exploitation |
| Alerter et corriger | Site BRE-01 hors service → équipe radio | Astreinte |
capacité planifiée sur l'historique (ex. ajout d'une cellule avant saturation)
Indicateur = Mesure + Seuil + Responsable| Famille | Indicateur Telcéa | Unité |
|---|---|---|
| Disponibilité | Site en service (telcea_site_up) |
0 / 1, % du temps |
| Capacité | Trafic par cellule, utilisation des liens | octets/s, % |
| Qualité | Latence, perte de paquets, réussite d'appel | ms, %, % |
| Environnement | Température, bascule sur batterie | °C, 0 / 1 |
Observabilité = Métriques + Journaux + Traces| Type | Forme | Exemple Telcéa | Outil type |
|---|---|---|---|
| Métrique | Valeur numérique horodatée | 914 abonnés sur PAR-01 | Prometheus, InfluxDB |
| Journal (log) | Ligne de texte horodatée | Bascule sur batterie (REN-01) |
Loki, Elasticsearch |
| Trace | Parcours d'une requête | Appel API → base → réponse | Tempo, Jaeger |
flowchart LR
subgraph Pull
P["Prometheus"] -->|"lit /metrics<br/>toutes les 15 s"| S1["Simulateur<br/>Telcéa"]
end
subgraph Push
T["Telegraf"] -->|"écrit<br/>toutes les 10 s"| I["InfluxDB"]
end
20 min
Chaîne = Collecteur → Base de séries temporelles → Visualisationflowchart LR C1["Exportateurs<br/>simulateur, node"] --> P["Prometheus"] C2["Telegraf"] --> I["InfluxDB"] C3["Alloy"] --> L["Loki"] P --> G["Grafana"] I --> G L --> G
| Outil | Modèle | Point fort |
|---|---|---|
| Nagios, Centreon | Contrôles OK / WARNING / CRITICAL | Supervision d'états, parc réseau |
| Zabbix | Agents + SNMP, base SQL | Tout-en-un (collecte, alertes) |
| Prometheus | Pull, séries temporelles, PromQL | Conteneurs, Kubernetes, alerting |
| InfluxDB | Push, séries temporelles, SQL | Mesures à haute fréquence, IoT |
| Elastic Stack | Indexation de documents | Recherche dans les journaux |
| Datadog | SaaS tout-en-un, facturé à l'usage | Aucune infrastructure à gérer |
Grafana = Sources de données + Tableaux de bord + Alertes« Grafana ne remonte rien » → le problème est presque toujours dans la source
| Prometheus 3.16 | InfluxDB 3.12 Core | |
|---|---|---|
| Collecte | Pull (lecture des cibles) | Push (Telegraf, API) |
| Langage | PromQL | SQL (et InfluxQL) |
| Alertes | Règles + Alertmanager | Non (passer par Grafana) |
| Données Telcéa | Réseau simulé + VM + conteneurs | Mesures système de la VM |
un outil par usage, Grafana pour tout afficher au même endroit
Supervision = Collecter + Stocker + Visualiser + Alerter/metrics des cibles (pull).1 h (S2.1 : 25 min · S2.2 : 35 min)
M01
Grafana 13.3.1 démarré sur la VM, aucune source raccordée
GF_*, et vérifier la valeur effective25 min
Grafana = Serveur (Go) + Interface (React) + Base interne + Pluginsflowchart LR N["Navigateur"] --> F["Interface<br/>React"] F --> B["Serveur Grafana<br/>Go"] B --> DB["Base interne<br/>SQLite"] B --> PL["Plugins de<br/>sources"] PL --> P["Prometheus"] PL --> I["InfluxDB"]
Panel = Requête + Plage de temps → Data frame → Visualisationflowchart LR P["Panel<br/>requête + plage"] --> S["Serveur<br/>Grafana"] S --> D["Plugin<br/>Prometheus"] D --> Q["Prometheus<br/>PromQL"] Q --> DF["Data frame<br/>tableau"] DF --> V["Visualisation"]
| Mode | Commande ou source | Usage |
|---|---|---|
| Conteneur Docker | grafana/grafana:13.3.1 |
Tests, petites équipes (formation) |
| Paquet Linux | Dépôt APT / RPM apt.grafana.com |
Serveur dédié, service grafana-server |
| Kubernetes | Chart Helm ou Grafana Operator 5.26 | Plateformes conteneurisées |
| Grafana Cloud | Offre SaaS de Grafana Labs | Aucune infrastructure à gérer |
admin / admin, changement de mot de passe imposéGF_SECURITY_ADMIN_PASSWORDdocker run -d --name grafana -p 3000:3000 \
-v grafana_data:/var/lib/grafana \
-e GF_SECURITY_ADMIN_PASSWORD=<MOT_DE_PASSE> \
grafana/grafana:13.3.1Contrôle :
curl -s http://localhost:3000/api/health{
"database": "ok",
"version": "13.3.1",
"commit": "da3aa3ff574e7dbbf808c66b6daa744defed0441"
}13.3.1), jamais latest en productioncompose.yamlflowchart LR NG["Nginx<br/>HTTPS /grafana/"] --> G["Grafana<br/>13.3.1"] G --> P["Prometheus<br/>3.16"] G --> I["InfluxDB<br/>3.12 Core"] G --> L["Loki<br/>3.7"] P --> A["Alertmanager<br/>0.35"]
/mail/), aucun courriel ne sort de la VM35 min
Valeur effective = defaults.ini < grafana.ini < variables GF_*defaults.ini : valeurs par défaut (ne JAMAIS modifier)grafana.ini : fichier de l'installation (/etc/grafana/grafana.ini en paquet)GF_<SECTION>_<CLÉ> : surcharge sans toucher aux fichiers (Docker)| Section | Clé | Variable |
|---|---|---|
[server] |
root_url |
GF_SERVER_ROOT_URL |
[security] |
admin_password |
GF_SECURITY_ADMIN_PASSWORD |
[smtp] |
host |
GF_SMTP_HOST |
Settings = toutes les sections + valeurs réellement appliquées| Section | Clé | Valeur sur la VM |
|---|---|---|
server |
root_url |
https://stagiaireNN.<SESSION>…/grafana/ |
database |
type |
sqlite3 |
smtp |
enabled |
true (vers Mailpit) |
paths |
provisioning |
/etc/grafana/provisioning |
toujours vérifier ici après un changement (faute de frappe = valeur ignorée)
Provisioning = Fichiers YAML + Redémarrage → Ressources crééesflowchart LR F["provisioning/<br/>datasources"] --> G["Grafana<br/>démarrage"] D["provisioning/<br/>dashboards"] --> G A["provisioning/<br/>alerting"] --> G G --> R["Ressources<br/>verrouillées"]
datasources, dashboards, plugins, alertingprovisioning/dashboards/noc.yamlapiVersion: 1
providers:
- name: noc
folder: NOC
type: file
allowUiUpdates: false
options:
path: /etc/grafana/provisioning/dashboards/nocnoc/ = un tableau de bord dans le dossier « NOC »| Rubrique | Contenu |
|---|---|
| General → Settings, Stats | Configuration effective, compteurs |
| Users and access | Utilisateurs, équipes, comptes de service (M10) |
| Plugins and data → Plugins | Plugins installés et catalogue (M07) |
| Advisor | Contrôles de santé (sources, plugins obsolètes) |
| Version | Nouveauté | Module |
|---|---|---|
| 12.0 (2025) | Applications Drilldown | M03 |
| 12.0 | Plugins Angular supprimés | M07 |
| 13.0 (2026) | Tableaux de bord dynamiques | M04 |
| 13.0 | Restauration après suppression | M06 |
| 13.0 | Advisor, jauge, suggestions | M02, M05 |
| 13.0 | grafana-cli, Image Renderer retirés |
M07, M08 |
Valeur effective = defaults.ini < grafana.ini < GF_*, vérifiée dans Settingsgrafana cli (sans tiret), plus d'Image Rendererroot_url de la section [server] ?GRAFANA_ROOT_URLGF_SERVER_ROOT_URLGF_ROOT_URLSERVER_ROOT_URLGF_<SECTION>_<CLÉ> en majuscules : GF_SERVER_ROOT_URL.grafana.ini et une variable GF_* définissent la même clé : laquelle s'applique ?grafana.inidefaults.iniGF_*.ini.defaults.inigrafana-cli plugins install <ID>grafana cli plugins install <ID>grafana-server install <ID>apt install grafana-plugin-<ID>grafana-cli ; commande : grafana cli plugins install <ID>.1 h 30 (S3.1 : 45 min · S3.2 : 45 min)
M02
Grafana configuré, aucune source raccordée
rate(), agrégation par étiquette45 min
Source de données = Plugin + URL + Authentificationflowchart LR G["Grafana"] --> P1["Plugin<br/>Prometheus"] G --> P2["Plugin<br/>InfluxDB"] P1 -->|"http://prometheus:9090"| PR["Prometheus"] P2 -->|"http://influxdb:8181"| IN["InfluxDB"]
| Famille | Exemples | Langage |
|---|---|---|
| Séries temporelles | Prometheus, InfluxDB, Graphite | PromQL, SQL / InfluxQL |
| Journaux | Loki, Elasticsearch | LogQL, Lucene |
| Bases SQL | MySQL, PostgreSQL, SQL Server | SQL |
| Supervision existante | Zabbix (plugin communautaire) | Éditeur visuel |
| Cloud | CloudWatch, Azure Monitor | Éditeurs dédiés |
Zabbix ou Centreon conservés, Grafana ajouté pour les tableaux de bord
| Champ | Valeur Telcéa |
|---|---|
| Name | Prometheus |
| Prometheus server URL | http://prometheus:9090 |
| Default | Activé |
Résultat de Save & test :
Successfully queried the Prometheus API.localhost = le conteneur Grafana lui-même → nom du service (prometheus)
Série = Nom de métrique + {Étiquettes} → (horodatage, valeur)telcea_cell_users{region="Ile-de-France", site="PAR-01", techno="5G"} 914telcea_cell_users : abonnés connectés)region, site, techno)job (nom de la collecte), instance (cible lue)| Type | Comportement | Exemple Telcéa | Requête type |
|---|---|---|---|
| Gauge | Monte et descend | telcea_cell_users |
Valeur brute |
| Counter | Ne fait que croître | telcea_cell_traffic_bytes_total |
rate(...[5m]) |
| Histogram | Répartition en tranches | telcea_site_latency_seconds_bucket |
histogram_quantile() |
_total par convention ; seul le débit (rate) a du senstelcea_site_up # 12 séries : un site = une série
telcea_site_up{region="Bretagne"} # égalité : 3 sites
telcea_site_up{region!="Bretagne"} # différence : 9 sites
telcea_cell_users{site=~"PAR-.*|SDN-01"} # regex : Paris + Saint-Denis
telcea_site_up == 0 # comparaison : sites hors service=, !=, =~ (regex), !~ (regex exclue)telcea_site_up : 1 = en service, 0 = hors serviceDébit = rate(compteur[fenêtre]) · Total = sum by (étiquette) (...)rate(telcea_cell_traffic_bytes_total{direction="down"}[5m]) * 8
sum by (region) (telcea_cell_users)
sum by (region) (rate(telcea_cell_traffic_bytes_total{direction="down"}[5m])) * 8Sortie (banc, 18/11/2026 10 h, abonnés par région) :
{region="Bretagne"} 989 {region="Ile-de-France"} 2529
{region="Hauts-de-France"} 1032 {region="Provence"} 1386rate() toujours AVANT sum (sinon redémarrage de cible = pic faux)
45 min
| Fonction | Usage |
|---|---|
| Builder / Code | Requête guidée ou saisie directe (PromQL) |
| Metrics browser | Liste des métriques et de leurs étiquettes |
| Query history | Requêtes déjà exécutées (réutilisables) |
| Split | Deux requêtes côte à côte (deux sources possibles) |
| Add → Add to dashboard | Requête envoyée vers un tableau de bord (M04) |
InfluxDB 3 = Base + Tables (mesures) + Colonnes (tags, champs, time)| Notion | Telcéa (base systeme, écrite par Telegraf) |
|---|---|
| Base (database) | systeme |
| Table (measurement) | cpu, mem, disk, net, system |
| Tag (texte indexé) | host = vm-noc, cpu = cpu-total |
| Champ (valeur) | usage_user, usage_idle, available_percent |
| Temps | Colonne time (UTC) |
| Champ | Valeur Telcéa |
|---|---|
| Query language | SQL (à choisir EN PREMIER) |
| URL | http://influxdb:8181 |
| Database | systeme |
| Token | INFLUX_TOKEN de stack/.env |
| Insecure Connection | Activé (pas de TLS dans la stack) |
Résultat de Save & test : OK
Insecure Connection désactivé → échec de connexion (TLS attendu)
SELECT $__dateBin(time) AS time, avg(usage_user) AS cpu_utilisateur
FROM cpu
WHERE $__timeFilter(time)
GROUP BY 1
ORDER BY 1$__timeFilter(time) : filtre sur la plage de temps choisie dans Grafana$__dateBin(time) : regroupement par intervalle (alias AS time OBLIGATOIRE)sans AS time → erreur no time column found
| Source | Requête |
|---|---|
| Prometheus (node-exporter) | 100 * (1 - avg(rate(node_cpu_seconds_total{mode="idle"}[5m]))) |
| InfluxDB (Telegraf) | SELECT $__dateBin(time) AS time, avg(100 - usage_idle) FROM cpu ... |
Source de données = Plugin + URL + Authentification ; URL vue PAR LE SERVEUR GrafanaSérie = Nom + {Étiquettes} ; gauge → valeur, counter → rate(), puis sum by$__timeFilter et $__dateBin(time) AS timehttp://prometheus:9090http://localhost:9090https://prometheus.telcea.examplehttp://grafana:3000telcea_cell_traffic_bytes_total est un compteur : quelle requête donne un débit ?telcea_cell_traffic_bytes_totalsum(telcea_cell_traffic_bytes_total)rate(telcea_cell_traffic_bytes_total[5m])avg(telcea_cell_traffic_bytes_total)rate() donne le débit par seconde.PAR- ?{site="PAR-*"}{site=~"PAR-.*"}{site!="PAR-"}{site~"PAR"}=~ applique une expression régulière : PAR-.*.sum by (region) (telcea_cell_users) ?regionsum by (region) additionne en conservant une série par valeur de region.$__interval$__range$__timeFilter(time)now() - 1h$__timeFilter(time) traduit la plage de temps du tableau de bord en clause WHERE.1 h 15 (S4.1 : 35 min · S4.2 : 40 min)
M03 (sources Prometheus et InfluxDB)
requêtes validées dans Explore, aucun tableau de bord
35 min
Tableau de bord = Panels + Lignes / Onglets + Plage de temps + Variablesflowchart TD F["Dossier<br/>NOC Telcéa"] --> D["Tableau de bord<br/>[TLC] Réseau — Vue nationale"] D --> R1["Ligne Synthèse"] D --> R2["Ligne Radio"] R1 --> P1["Panel Stat<br/>Sites en service"] R2 --> P2["Panel Time series<br/>Abonnés par région"]
Titre = [Préfixe] Domaine — Vue (+ tags + dossier)| Élément | Règle Telcéa | Exemple |
|---|---|---|
| Préfixe | Entité ou équipe propriétaire | [TLC] |
| Domaine | Périmètre supervisé | Réseau, Système |
| Vue | Niveau de détail | Vue nationale, Détail site |
| Tags | Minuscules, sans accent | telcea, reseau, noc |
| Dossier | Une équipe ou un service | NOC Telcéa |
TEST ou DEV dans le titre : jamais utilisé en exploitationpropriétaire indiqué dans la description (équipe + contact)
| Étape | Action |
|---|---|
| 1. Mise en page | Auto grid (tailles automatiques) ou Custom grid (placement libre) |
| 2. Premier panel | Panneau Add → Panel → Configure visualization |
| 3. Requête | Source, requête (copiée d'Explore), légende |
| 4. Enregistrer | Save : titre, dossier, description |
| 5. Quitter l'édition | Exit edit (puis Edit pour y revenir) |
| Élément | Comportement | Usage Telcéa |
|---|---|---|
| Ligne (row) | Repliable, empilée verticalement | Synthèse, Radio, Transport |
| Onglet (tab) | Un seul visible à la fois | Vue nationale / Par région |
| Règle d'affichage | Selon variable, plage ou résultat | Panel masqué si aucune donnée |
| Réglage | Exemple | Effet |
|---|---|---|
| Plage relative | Last 6 hours (now-6h → now) |
Fenêtre glissante |
| Plage absolue | 2026-11-18 08:00 → 12:00 |
Analyse d'un incident passé |
| Rafraîchissement | 30s |
Requêtes relancées toutes les 30 s |
| Fuseau horaire | Défaut de l'organisation (Europe/Paris) |
Heure du NOC |
plage et rafraîchissement ENREGISTRÉS avec le tableau de bord (Save)
40 min
| Famille | Visualisations | Question type |
|---|---|---|
| Évolution dans le temps | Time series, Bar chart | « Comment évolue le trafic ? » |
| États dans le temps | State timeline, Status history | « Quand le site est-il tombé ? » |
| Distribution | Histogram, Heatmap | « Comment se répartit la latence ? » |
| Valeur unique | Stat, Gauge, Bar gauge | « Combien de sites en service ? » |
| Proportion | Pie chart | « Part de trafic par région ? » |
| Famille | Visualisations | Question type |
|---|---|---|
| Liste détaillée | Table | « État de chaque site ? » |
| Texte | Text, Logs | « Que faire ? Quelles alarmes ? » |
| Géographie | Geomap | « Où sont les sites en panne ? » |
| Schéma | Canvas, Node graph | « Quel lien est saturé ? » |
| Widgets | Dashboard list, Alert list, News | « Quels écrans et alertes ? » |
flowchart LR
Q["Question"] --> T{"Le temps<br/>compte ?"}
T -->|"Oui"| C["Time series<br/>State timeline"]
T -->|"Non"| N{"Une seule<br/>valeur ?"}
N -->|"Oui"| S["Stat, Gauge"]
N -->|"Non"| L["Table, Bar gauge<br/>Geomap"]
Titre = [Préfixe] Domaine — Vue, tags en minuscules, un dossier par équipeNouveau tableau de borddashboard_reseau_v2_finalTEST[TLC] Réseau — Vue nationale1 h 45 (S5.1 : 40 min · S5.2 : 50 min · S5.3 : 15 min)
M04
« [TLC] Réseau — Vue nationale » (3 lignes, valeurs brutes)
40 min
Time series = Séries + Axe du temps + Style (lignes, barres, points)Last, Max, Mean) à côté du nomlégende {{region}} (Lab 04.1) plutôt que la liste d'étiquettes complète
Valeur affichée = Calcul (Last, Mean, Max) sur la plage de temps| Visualisation | Forme | Usage Telcéa |
|---|---|---|
| Stat | Chiffre + fond ou courbe | Sites en service : 12 sur fond vert |
| Gauge | Cadran avec seuils | CPU de la VM : 13 % |
| Bar gauge | Barres horizontales ou verticales | Réussite des appels par région |
Table : valeur actuelle de chaque sérieAvant: Time, __name__, instance, job, region, site, techno, Value (1 / 0)
Après: Site, Région, Techno, État (« En service » sur fond vert)
| Visualisation | Donnée attendue | Usage Telcéa |
|---|---|---|
| State timeline | Valeurs d'état (0 / 1, textes) | Disponibilité des 12 sites heure par heure |
| Status history | Valeurs à intervalle régulier | État horaire (cases colorées) |
| Geomap | Champs latitude et longitude |
Carte des sites, couleur selon l'état |
Coords, couleur selon un champtelcea_site_up * on(site) group_left(ville, latitude, longitude) telcea_site_infotelcea_site_info : valeur toujours 1, coordonnées portées par les étiquetteson(site) group_left(...) : recopie les étiquettes choisies sur chaque série d'étatNumbercoordonnées laissées en texte → aucun marqueur sur la carte
50 min
Affichage = Options du panel + Options standard + Overridesflowchart LR P["Options du panel<br/>titre, légende"] --> S["Options standard<br/>unité, min, max, seuils"] S --> O["Overrides<br/>une série précise"]
| Calcul | Résultat | Usage |
|---|---|---|
| Last * | Dernière valeur non nulle | État actuel (par défaut) |
| Mean | Moyenne sur la plage | Charge moyenne de la journée |
| Max / Min | Extrêmes | Pic de trafic |
| Total | Somme des points | Rarement pertinent sur un débit |
| Delta | Écart début / fin | Croissance d'un compteur |
Mean sur telcea_site_up → 11.9 au lieu de 12
| Unité | Valeur brute | Affichage |
|---|---|---|
bits/sec(SI) (bps) |
776475341 |
776 Mb/s |
Percent (0.0-1.0) (percentunit) |
0.41 |
41% |
Percent (0-100) (percent) |
13.1 |
13.1% |
bytes(IEC) |
1073741824 |
1 GiB |
seconds (s) |
0.059 |
59 ms |
percent sur un ratio 0-1 → 0.41% au lieu de 41%
| Panel | Seuils (mode Absolute) | Effet |
|---|---|---|
| Sites en service | rouge Base · orange 10 · vert 12 | Fond rouge dès 9 sites |
| Liens de collecte | vert Base · orange 0.8 · rouge 0.9 | Lignes pointillées à 80 % et 90 % |
| CPU de la VM | vert Base · orange 65 · rouge 90 | Arcs de couleur de la jauge |
Mapping = Valeur (ou plage, regex, nul) → Texte + Couleur| Type | Exemple Telcéa | Affichage |
|---|---|---|
| Value | 1 |
« En service » (vert) |
| Value | 0 |
« Hors service » (rouge) |
| Range | 0.9 à 1 |
« Saturé » (rouge) |
| Special | Null / NaN |
« Pas de données » (gris) |
| Sélecteur | Exemple | Propriété modifiée |
|---|---|---|
| Fields with name | REN-PAR |
Couleur fixe violette (lien breton) |
| Fields with name | TRANSMIT |
Transform : Negative Y |
| Fields with name | État (table) |
Cell type : fond coloré |
| Fields with name matching regex | PAR-.* |
Couleur commune aux sites parisiens |
15 min
flowchart LR A["M01-M02<br/>Supervision<br/>Grafana"] --> B["M03<br/>Sources<br/>PromQL, SQL"] B --> C["M04<br/>Tableau de bord<br/>lignes, widgets"] C --> D["M05<br/>Unités, seuils<br/>mappings, carte"] D --> E["J2<br/>Variables, plugins<br/>alertes, droits"]
Last * par défaut) ; Table : détail en Instantbps, percentunit) : Grafana convertit et formatetelcea_cell_traffic_bytes_totalrate(telcea_cell_traffic_bytes_total[5m])sum(telcea_cell_traffic_bytes_total)max(telcea_cell_traffic_bytes_total)rate() transforme le compteur d'octets en débit par seconde.0.41 : quelle unité affiche 41% ?percentunitpercentshortbpspercentunit attend un ratio 0-1.11.9 sites en service : quelle est la cause probable ?Mean au lieu de Last *Mean moyenne les valeurs de la plage ; Last * donne l'état actuel.1 ?REN-PAR en violet ?REN-PARsitelatitude et longitudehttp://prometheus:9090 ?localhost1 h (S6.1 : 40 min · S6.2 : 20 min)
M05
« [TLC] Réseau — Vue nationale » lisible, aucune variable
40 min
Variable = Nom + Liste de valeurs → $nom remplacé dans les requêtesAvant: 4 copies du tableau de bord (une par région) → 4 corrections à chaque évolution
Après: 1 tableau de bord + liste déroulante Région → 1 seule maintenance
?var-region=Bretagne)variables plutôt que copies (règle du support historique)
| Type | Valeurs | Exemple Telcéa |
|---|---|---|
| Query | Lues dans la source | region : 4 régions lues dans Prometheus |
| Custom | Liste saisie à la main | techno : 4G,5G |
| Interval | Durées | fenetre : 1m,5m,15m,1h |
| Constant | Valeur fixe, masquée | Seuil commun à plusieurs panels |
| Text box | Saisie libre | Recherche d'un code d'alarme |
| Data source | Sources d'un type | Basculer entre deux Prometheus |
| Champ | Valeur |
|---|---|
| Name / Label | region / Région |
| Data source | Prometheus |
| Query type | Label values (étiquette region, métrique telcea_site_info) |
| Multi-value / Include All value | Activés |
| Refresh | On dashboard load |
Équivalent en requête classique :
label_values(telcea_site_info, region)$nom dans la requête, le titre, la légendesum by (site) (telcea_cell_users{region=~"$region", site=~"$site", techno=~"$techno"})
sum by (site) (rate(telcea_cell_traffic_bytes_total{direction="down"}[$fenetre])) * 8=~ obligatoire en multi-valeur : $region devient (Bretagne|Provence)Débit par site ($fenetre) → « Débit par site (15m) »region="$region" (égalité) → « No data » dès 2 valeurs choisies
Variable fille = Requête filtrée par $variable_mèreflowchart LR R["region<br/>Bretagne"] --> S["site<br/>REN-01, BRE-01, QUI-01"] S --> P["Panels<br/>filtrés"] T["techno<br/>4G, 5G"] --> P
label_values(telcea_site_info{region=~"$region"}, site)| Symptôme | Cause | Correction |
|---|---|---|
| « No data » avec 2 valeurs | = au lieu de =~ |
region=~"$region" |
| « No data » sur la latence | Filtre techno : étiquette absente de la métrique |
Retirer techno de cette requête |
| Liste des sites figée | Refresh sur Never |
On dashboard load |
| Sites d'une autre région | Variable fille non filtrée | {region=~"$region"} dans sa requête |
20 min
Repeat = Panel modèle × Valeurs sélectionnéesregionSites en service — $region| Outil | Usage Telcéa |
|---|---|
| Dossiers imbriqués | NOC Telcéa → Radio, Transport (droits au M10) |
| Tags | telcea, reseau, radio : filtre et liens dynamiques |
| Favoris (étoile) | Écrans personnels de chaque technicien |
| Playlists | Rotation automatique sur l'écran mural |
| Liens de tableau de bord | Menu « Telcéa » : tous les tableaux de bord tagués |
Suppression → Dashboards → Recently deleted → Restoresuppression par erreur d'un écran de NOC = restauration en 1 minute
$variable dans les requêtes, titres, légendes ; =~ en multi-valeurrate)region="$region"region=~"$region"region!="$region"region:$region=~ : la sélection multiple devient une expression régulière (A|B).site à la variable region ?label_values(site)site avant regionlabel_values(telcea_site_info{region=~"$region"}, site)techno=~"$techno" ?technotechno est mal nomméeregion1 h (S7.1 : 20 min · S7.2 : 40 min)
M06
tableaux de bord national et régional, visualisations natives uniquement
grafana cli et par configuration20 min
Plugin = Panel | Source de données | Application| Type | Apporte | Exemple |
|---|---|---|
| Panel | Une visualisation | Flow (schéma SVG animé) |
| Source de données | Un connecteur | Zabbix, MongoDB |
| Application | Pages + panels + sources | Drilldown, Advisor |
grafana.com/grafana/plugins et Administration → Plugins and data → PluginsSignature = Éditeur identifié + Code non modifié depuis la publication| Niveau | Signé par | Exemple |
|---|---|---|
| Grafana | Grafana Labs | Status Panel (Vonage), Polystat |
| Commercial | Éditeur partenaire | Plugins Enterprise |
| Community | Développeur indépendant | D3 Gauge, Flow |
| Private | Usage interne d'une organisation | Plugin maison |
| Non signé | Personne | Refusé par défaut |
| Méthode | Commande ou action | Redémarrage |
|---|---|---|
| Interface | Fiche du plugin → Install | Non |
| CLI (Grafana 13) | grafana cli plugins install <ID> [<VERSION>] |
Oui |
| Configuration | GF_PLUGINS_PREINSTALL_SYNC=<ID>@<VERSION>,... |
Au démarrage |
docker compose exec grafana grafana cli plugins install andrewbmchugh-flow-panel✔ Downloaded and extracted andrewbmchugh-flow-panel v1.20.1 zip successfully to /var/lib/grafana/plugins/andrewbmchugh-flow-panel| Plugin du programme | État (novembre 2026) | Choix de la formation |
|---|---|---|
| Boom Table | Déprécié, Angular : ne se charge plus | Table native + transformations, ou Polystat |
| Diagram | Sans mise à jour depuis 04/2024 | Flow (schéma SVG, mis à jour en 12/2025) |
| Status Panel (Vonage) | 2.0.4, React, signé Grafana | Conservé |
| D3 Gauge | 2.2.0 (04/2026), React | Conservé |
migration vers 12 → « Panel plugin not found: yesoreyeram-boomtable-panel »
40 min
Couleur du pavé = Pire état parmi les indicateurs (OK, Warning, Critical)Critical < Warning → les grandes valeurs sont bonnesun Status Panel par région (panel répété sur $region)
| Plugin | Forme | Réglages clés |
|---|---|---|
| D3 Gauge 2.2.0 | Cadran à aiguille, graduations | Unité, min / max, bandes de seuils |
| Polystat 2.1.16 | Hexagones, un par série | Calcul (current), seuils, mappings, colonnes |
Flow = SVG (identifiants) + YAML (identifiant → série → seuils)
flowchart LR
D["Dessin SVG<br/>draw.io"] --> F["Panel Flow"]
Y["Configuration<br/>YAML"] --> F
Q["Requêtes<br/>{{link}}, {{region}}"] --> F
F --> R["Liens et régions<br/>colorés"]
cell-REN-PAR ↔ série nommée REN-PAR (légende {{link}})strokeColor (traits), fillColor (formes), label (texte + valeur)flow-config.yamlcellIdPreamble: "cell-"
cells:
REN-PAR:
dataRef: "REN-PAR"
strokeColor:
thresholds:
- {color: "green", level: 0}
- {color: "orange", level: 0.8}
- {color: "red", level: 0.9}
Bretagne: {dataRef: "Bretagne", fillColor: {thresholds: *seuils-sites}}dataRef ≠ nom de la série (légende absente) → élément gris
Plugin = Panel | Source | Application ; signature = éditeur + intégritégrafana cli plugins install <ID> puis redémarrage, ou installation depuis l'interfacegrafana-cli plugins install <ID>apt install <ID>docker plugin install <ID>grafana cli plugins install <ID>grafana-cli supprimé en Grafana 13.grafana cli plugins install, que faut-il faire ?dataRef ne correspond à aucun nom de sériedataRef doit correspondre au nom d'une série.45 min (S8.1 : 25 min · S8.2 : 20 min)
M07
trois tableaux de bord du NOC (national, régional, écran mural)
25 min
Mode de partage = Destinataire + Données exposées + Durée| Destinataire | Besoin | Mode |
|---|---|---|
| Collègue du NOC (compte Grafana) | Même vue, même instant | Lien interne |
| Direction, sans compte | Vue en direct, lecture seule | Lien externe |
| Prestataire, après incident | Figer l'état, sans les requêtes | Snapshot |
| Autre instance Grafana | Reprendre le tableau de bord | Export JSON |
now-6h devient une plage absolue (le destinataire voit le même instant)/goto/...var-region=Bretagne)lien à plage figée dans tout ticket d'incident (preuve horodatée)
Lien externe = Tableau de bord entier + Lecture seule + Sans authentificationvariables et sélecteur de plage non modifiables par le destinataire
Snapshot = Données affichées + Mise en forme − Requêtes − Sources| Option | Valeur Telcéa |
|---|---|
| Snapshot name | [TLC] Réseau — incident tempête 18/11 |
| Expires in | 1 Hour, 1 Day, 1 Week, Never |
| Publish snapshot | Stocké sur l'instance (Snapshots) |
| Publish to snapshots.raintank.io | Service externe (Grafana Labs) |
20 min
flowchart LR E["Export<br/>Download file"] --> F["Fichier JSON<br/>schéma v2"] F --> I["Dashboards → New<br/>Import dashboard"] I --> C["Choix de la source<br/>Prometheus"]
grafana.comapiVersion: dashboard.grafana.app/v2)Library panel = Panel partagé ; modification → tous les tableaux de bordpanel « Consignes d'astreinte » partagé par tous les écrans
| Besoin | OSS (formation) | Enterprise / Cloud |
|---|---|---|
| Rapport PDF planifié par courriel | Non | Schedule a report |
| Export PDF | Non | Export as PDF |
| Image d'un panel | Capture d'écran (Image Renderer retiré en 13) | Rendu serveur |
| Courriel avec un lien | Lien interne ou snapshot collé dans un courriel | Idem |
1 h 30 (S9.1 : 45 min · S9.2 : 45 min)
M05 (seuils), M06
écrans du NOC complets, aucune alerte
45 min
Alerte = Règle (requête + condition) → Instance → Politique → Point de contactflowchart LR R["Règle<br/>telcea_site_up < 1"] --> I["Instance<br/>site=BRE-01"] I --> P["Politique<br/>equipe=radio"] P --> C["Point de contact<br/>Équipe radio"] C --> M["Courriel<br/>radio@telcea.example"]
equipe, severite) : clés du routage| Gestion | Règles stockées dans | Usage |
|---|---|---|
| Grafana-managed (défaut) | Base de Grafana | Toutes sources, plusieurs requêtes, expressions |
| Data source-managed | Prometheus, Loki, Mimir | Règles existantes de Prometheus (lecture dans Grafana) |
SiteRadioHorsService déjà en place (Alertmanager)telcea_site_up| Élément | Valeur Telcéa |
|---|---|
| Requête A | telcea_site_up (Instant, Prometheus) |
| Condition (Alert condition) | WHEN QUERY IS BELOW 1 |
| Mode avancé | Expressions Reduce, Math, Threshold enchaînées |
Alerte = Condition vraie pendant la période d'attente (pending period)| Réglage | Valeur | Effet |
|---|---|---|
| Evaluation group | telcea-1m (intervalle 1 min) |
Règles évaluées ensemble |
| Pending period | 1m |
Pas d'alerte sur un pic d'une minute |
| Keep firing for | 0s (None) |
Retour immédiat à Normal |
| No data / Error | NoData, Error |
État dédié si la requête échoue |
flowchart LR N["Normal"] -->|"condition vraie"| P["Pending"] P -->|"vraie après 1m"| A["Alerting<br/>(Firing)"] P -->|"redevient fausse"| N A -->|"condition fausse"| R["Recovering"] R -->|"keep firing for écoulé"| N
| Type | Clé | Valeur Telcéa |
|---|---|---|
| Label | equipe |
radio ou transport |
| Label | severite |
critique, majeure, mineure |
| Annotation | summary |
Site {{ $labels.site }} ({{ $labels.region }}) hors service |
| Annotation | runbook_url |
Procédure d'intervention |
{{ $labels.site }} : remplacé par la valeur de l'instance (BRE-01)site, region) ajoutés automatiquement à l'instance| Règle | Condition | Pending | Labels |
|---|---|---|---|
| Site radio hors service | telcea_site_up < 1 |
1m | radio, critique |
| Lien de collecte saturé | utilisation > 0.8 | 2m | transport, majeure |
| Site sur batterie | telcea_site_on_battery > 0 |
1m | radio, mineure |
seuil = niveau où l'action est nécessaire, pas niveau de panne déjà visible
45 min
Point de contact = Intégration (courriel, Teams, Slack, webhook) + Paramètres| Point de contact | Intégration | Destination (stack) |
|---|---|---|
| NOC Telcéa | noc@telcea.example |
|
| Équipe radio | radio@telcea.example |
|
| Équipe transport | transport@telcea.example |
|
| Alertmanager externe | Alertmanager | http://alertmanager:9093 |
/mail/)flowchart TD D["Default policy<br/>NOC Telcéa"] --> R["equipe = radio<br/>Équipe radio"] D --> T["equipe = transport<br/>Équipe transport"]
group_by (alertname, region), Group wait 30 s, Repeat interval 1 hSilence = Matchers de labels + Début + Fin (+ commentaire)site = BRE-01 pendant 2 h (remplacement de l'alimentation)silence sans date de fin réaliste → alerte réelle ignorée des jours plus tard
flowchart LR PR["Prometheus<br/>règles YAML"] --> AM["Alertmanager<br/>0.35"] G["Grafana<br/>règles"] -->|"point de contact<br/>Alertmanager"| AM AM --> M["Courriel<br/>par équipe"]
Règle = Requête + Condition + Évaluation (pending) + Labels + Annotationsequipe = …equipe=radio : qui décide du destinataire ?telcea_site_up < 1 si 2 sites sont coupés ?site = BRE-01site = BRE-01 pour la durée de l'intervention.equipe : où part la notification ?{{ $labels.site }} ?45 min (S10.1 : 45 min)
M06 (dossiers), M09
un seul compte admin, tout le monde peut tout modifier
45 min
Droit effectif = Rôle d'organisation + Permissions (dossier, tableau de bord) par utilisateur ou équipeflowchart TD O["Organisation<br/>Telcéa"] --> U["Utilisateurs<br/>rôle Viewer, Editor, Admin"] O --> T["Équipes<br/>Radio, Transport"] T --> F["Dossier Radio<br/>permission Edit"] F --> D["Tableaux de bord<br/>du dossier"]
| Rôle | Peut | Usage Telcéa |
|---|---|---|
| Viewer | Consulter, explorer selon réglages | Direction, techniciens (base) |
| Editor | Créer et modifier tableaux de bord et alertes | Responsables d'équipe |
| Admin | Gérer utilisateurs, équipes, sources, plugins | Administrateur du NOC |
| No basic role | Rien sans permission explicite | Prestataires externes |
| Méthode | Action | Résultat |
|---|---|---|
| Création directe | New user : nom, courriel, login, mot de passe | Compte actif immédiatement |
| Invitation | Invite + Send invite email | Courriel avec lien d'activation (Mailpit) |
| Annuaire | LDAP, OAuth / SSO (Azure AD, Okta, Keycloak) | Comptes créés à la première connexion |
tech.radio, tech.transport, directeur (rôle Viewer)SSO de l'entreprise et équipes synchronisées depuis l'annuaire
Équipe = Membres + Permissions (une seule fois)Radio, TransportAvant: 12 techniciens × 3 dossiers = 36 permissions individuelles
Après: 2 équipes × 1 dossier = 2 permissions
| Dossier | Bénéficiaire | Permission |
|---|---|---|
NOC Telcéa |
Rôle Viewer / Editor (par défaut) | View / Edit |
NOC Telcéa / Radio |
Équipe Radio | Edit |
NOC Telcéa / Transport |
Équipe Transport | Edit |
| Tous | Rôle Admin | Admin |
| Profil | Action | Attendu (banc) |
|---|---|---|
tech.radio |
Modifier le tableau de bord de Radio |
Autorisé (HTTP 200) |
tech.transport |
Modifier le tableau de bord de Radio |
Refusé (HTTP 403) |
directeur |
Consulter le tableau de bord régional | Autorisé (HTTP 200) |
directeur |
Modifier ce tableau de bord | Refusé (HTTP 403) |
test uniquement positif → droits trop larges jamais détectés
Compte de service = Rôle + Jetons (révocables, à durée limitée)script qui utilise le mot de passe d'un administrateur humain
dossiers + équipes avant de multiplier les organisations
Droit effectif = Rôle d'organisation + Permissions héritées des dossiersadmin40 min (S11.1 : 40 min)
M03 (sources Prometheus et InfluxDB), M05
chaque panel interroge une seule source
40 min
Croisement = Plusieurs requêtes (une ou plusieurs sources) + Transformations| Question du NOC | Source 1 | Source 2 |
|---|---|---|
| Les deux collecteurs de la VM sont-ils d'accord ? | Prometheus (node-exporter) | InfluxDB (Telegraf) |
| Quel site a le débit par abonné le plus faible ? | Prometheus (abonnés) | Prometheus (trafic) |
| Le pic de CPU coïncide-t-il avec un pic de trafic ? | InfluxDB (CPU) | Prometheus (trafic) |
flowchart LR M["Panel<br/>source Mixed"] --> A["Requête A<br/>Prometheus"] M --> B["Requête B<br/>InfluxDB (SQL)"] A --> T["Transformations"] B --> T T --> V["Visualisation"]
-- Mixed -- ; chaque requête choisit sa source100 * (1 - avg(rate(node_cpu_seconds_total{mode="idle"}[1m]))) # A : node-exporterSELECT $__dateBin(time) AS time, avg(100 - usage_idle) AS telegraf -- B, InfluxDB
FROM cpu WHERE $__timeFilter(time) GROUP BY 1 ORDER BY 1percent) : les deux courbes sur le même axe1m : pas identique pour les deux sourcesAffichage = Requêtes → Transformation 1 → Transformation 2 → … → Visualisation| Transformation | Effet |
|---|---|
| Join by field | Aligne sur un champ commun (temps) |
| Merge series/tables | Fusionne des tables (même clé) |
| Add field from calculation | Opération entre deux champs |
| Organize fields by name | Masquer, renommer, ordonner |
| Filter fields by name | Garder ou exclure des champs |
| Group by / Sort by | Regrouper, agréger, trier |
| Requête (Instant, Table) | Colonne finale |
|---|---|
sum by (site, region) (telcea_cell_users) |
Abonnés |
sum by (site) (rate(telcea_cell_traffic_bytes_total{direction="down"}[5m])) * 8 |
Débit descendant |
histogram_quantile(0.95, sum by (le, site) (rate(...[5m]))) |
Latence p95 |
sum by (site) (telcea_site_up) |
État |
Value #A à Value #D) → Add field from calculation (débit / abonnés) → Organize → Sort by| Symptôme | Cause | Correction |
|---|---|---|
| Écart vide (« No data ») | Horodatages différents (15 s contre 1 min) | Même intervalle : Min interval 1m |
| Jointure sans effet | Champ Time d'un côté, time de l'autre |
Jointure sur le champ temps par défaut |
| Lignes dupliquées par site | Étiquettes différentes (region d'un seul côté) |
Mêmes étiquettes ou Organize |
| Calcul faux | Unités différentes (octets / bits) | Convertir dans la requête (* 8) |
bouton Table view de l'éditeur pour voir le résultat de chaque étape
-- Mixed --, une source par requêteValue #A en « Abonnés » ?25 min (S12.1 : 10 min · S12.2 : 15 min)
M07
NOC Telcéa supervisé, alerté, organisé
plugin.json d'un plugin et en déduire son type, son identifiant et sa compatibilité10 min
flowchart LR A["Générer<br/>create-plugin"] --> B["Développer<br/>React + TypeScript"] B --> C["Tester<br/>Docker, Playwright"] C --> D["Construire<br/>npm run build"] D --> E["Signer<br/>sign-plugin"] E --> F["Publier<br/>ou installer"]
@grafana/create-plugin 9.0.4), Docker, Gitnpx @grafana/create-plugin@latest \
--plugin-type=panel --plugin-name=noc-status --org-name=telcea --no-backendSortie relevée au banc (extrait) :
✓ Scaffolded telcea-nocstatus-panel panel plugin
✓ Added basic E2E test (Playwright)
✓ Configured development environment (Docker)<organisation>-<nom>-<type> → telcea-nocstatus-panel| Fichier | Rôle |
|---|---|
src/plugin.json |
Identité : type, id, nom, version minimale de Grafana (>=13.2.0) |
src/module.ts |
Point d'entrée : panel + options affichées dans l'éditeur |
src/components/SimplePanel.tsx |
Rendu React du panel (données reçues en data frames) |
docker-compose.yaml |
Grafana de développement avec le plugin monté |
tests/ |
Tests de bout en bout (Playwright) |
npm run dev (compilation continue), npm run build, npm run e2e, npm run sign| Étape | Commande | Résultat |
|---|---|---|
| Dépendances | npm install |
Modules Node installés |
| Compilation continue | npm run dev |
dist/ régénéré à chaque modification |
| Grafana de test | docker compose up |
http://localhost:3000, plugin chargé |
| Tests | npm run test, npm run e2e |
Tests unitaires (Jest), E2E (Playwright) |
| Signature | npm run sign (jeton grafana.com) |
MANIFEST.txt signé |
allow_loading_unsigned_plugins)15 min
flowchart LR J1["J1 Construire<br/>sources, tableaux<br/>de bord, graphiques"] --> J2a["J2 Exploiter<br/>variables, plugins<br/>partage"] J2a --> J2b["J2 Sécuriser<br/>alertes, droits<br/>croisement"]
grafana-training| Objectif | Modules | Note |
|---|---|---|
| Maîtriser les dashboards de Grafana | M04, M05, M06, M08 | 1 – 4 |
| Savoir configurer un flux de données source | M02, M03, M11 | 1 – 4 |
| Utiliser les plugins | M07, M12 | 1 – 4 |
| Alerter et gérer les accès | M09, M10 | 1 – 4 |
evaluation-finale.md)create-plugin → React / TypeScript → tests → build → signature → publicationplugin.json = identité et compatibilité du pluginnpx @grafana/create-plugin@latestgrafana cli plugins createnpm init grafanadocker compose upnpx @grafana/create-plugin@latest.README.mddocker-compose.yamlCHANGELOG.mdsrc/plugin.jsonsrc/plugin.json, champ grafanaDependency.NocStatustelcea-nocstatus-panelpanel_nocgrafana-telcea<organisation>-<nom>-<type>.npm run dev ?allow_loading_unsigned_plugins avec l'identifiant du pluginallow_loading_unsigned_plugins (section [plugins]), en développement uniquement.