Este artículo está disponible en francés.
1. Organisations, équipes et dossiers #
Les trois niveaux de rangement et de partage.
La hiérarchie #
Disponible dans : ✓ OSS ✓ Enterprise ✓ Cloud
- Organisation : un espace étanche (utilisateurs, sources de données, dashboards, alertes). À réserver aux vrais cloisonnements, par exemple des clients différents : rien n'est partagé entre organisations.
- Équipe : un groupe d'utilisateurs d'une organisation, à qui l'on donne des droits. C'est le bon niveau pour « Production », « Infrastructure » ou « Développement ».
- Dossier : range dashboards, règles d'alerte et panneaux de bibliothèque. Les dossiers s'imbriquent et les sous-dossiers héritent des permissions.
Une organisation ou des équipes ? #
Bonne Pratique : Commencez par une seule organisation, des équipes et des dossiers par équipe. Les organisations multiples dupliquent les sources de données et empêchent tout dashboard transverse.
2. Rôles, permissions et RBAC #
Du rôle de base au contrôle fin.
Rôles de base #
| Rôle | Peut… |
|---|---|
| Grafana Admin | administrer l'instance : organisations, utilisateurs, réglages (rôle serveur) |
| Admin | administrer une organisation : sources de données, équipes, utilisateurs, plugins |
| Editor | créer et modifier dashboards et alertes, explorer les données |
| Viewer | consulter les dashboards autorisés |
| Aucun rôle de base | rien par défaut : tous les droits viennent des permissions données (dossiers, équipes) |
Permissions de dossiers et de dashboards #
Sur chaque dossier, on accorde Lecture, Modification ou Administration à un utilisateur, une équipe ou un rôle. Retirez la permission par défaut « Viewer : lecture » des dossiers sensibles, sinon tout le monde les voit.
RBAC et permissions des sources de données #
Disponible dans : ✕ OSS ✓ Enterprise ✓ Cloud
- Le RBAC ajoute des rôles fixes (par exemple « Data sources reader », « Alerting writer ») et des rôles personnalisés, assignables aux utilisateurs, équipes et comptes de service.
- Les permissions de sources de données limitent qui peut interroger une source : sans elles (Grafana OSS), tout utilisateur qui voit un dashboard peut interroger toutes les sources de l'organisation depuis Explore.
Attention : En OSS, une équipe qui ne doit pas voir certaines données doit être placée dans une autre organisation, avec ses propres sources : masquer un dashboard ne protège pas la source.
3. Comptes de service et jetons #
Les accès des scripts, de la CI et de Terraform.
Pourquoi des comptes de service ? #
Un compte de service est une identité technique avec un rôle et des permissions, qui porte un ou plusieurs jetons (préfixe glsa_). Il remplace les anciennes clés d'API, migrées automatiquement : n'utilisez jamais le compte d'une personne pour un script.
# Compte de service « ci-dashboards » avec le rôle Editor, puis un jeton valable 90 jours
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-X POST $GRAFANA/api/serviceaccounts -d '{"name":"ci-dashboards","role":"Editor"}'
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-X POST $GRAFANA/api/serviceaccounts/2/tokens -d '{"name":"gitlab-ci","secondsToLive":7776000}'Règles de sécurité #
- Un compte de service par usage (CI, Terraform, sauvegarde), avec le rôle le plus faible possible.
- Des jetons à durée limitée, stockés dans un coffre de secrets et renouvelés.
- Révoquez immédiatement un jeton exposé (dépôt Git, journal) : il donne les droits du compte de service.
Automatiser équipes et dossiers #
export GRAFANA=https://grafana.exemple.fr
export TOKEN=glsa_xxx # jeton d'un compte de service avec le rôle Admin de l'organisation
# Créer une équipe
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-X POST $GRAFANA/api/teams -d '{"name":"Production"}'
# Créer un dossier et le réserver à l'équipe (permission 1 = lecture, 2 = modification, 4 = administration)
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-X POST $GRAFANA/api/folders -d '{"uid":"prod","title":"Production"}'
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-X POST $GRAFANA/api/folders/prod/permissions \
-d '{"items":[{"teamId":1,"permission":2},{"role":"Viewer","permission":1}]}'4. Authentification : LDAP, OIDC, SAML et auth proxy #
Brancher Grafana sur l'annuaire de l'entreprise.
Quelle méthode ? #
| Méthode | Éditions | Usage |
|---|---|---|
| LDAP / Active Directory | OSS, Enterprise | annuaire interne ; rôles déduits des groupes |
| OAuth 2 / OIDC | OSS, Enterprise, Cloud | Keycloak, Microsoft Entra ID, Okta, Google, GitLab… : le choix par défaut aujourd'hui |
| SAML | Enterprise, Cloud | fournisseurs d'identité d'entreprise sans OIDC |
| Auth proxy | OSS, Enterprise | un reverse proxy déjà authentifié transmet l'identité dans un en-tête |
| Synchronisation des équipes | Enterprise, Cloud | appartenance aux équipes Grafana tirée des groupes du fournisseur |
OIDC #
# grafana.ini : connexion via un fournisseur OIDC (ici Keycloak)
[auth.generic_oauth]
enabled = true
name = Keycloak
client_id = grafana
client_secret = $__file{/run/secrets/grafana_oidc_secret}
scopes = openid email profile groups
auth_url = https://sso.exemple.fr/realms/it/protocol/openid-connect/auth
token_url = https://sso.exemple.fr/realms/it/protocol/openid-connect/token
api_url = https://sso.exemple.fr/realms/it/protocol/openid-connect/userinfo
# Rôle Grafana déduit des groupes du fournisseur d'identité
role_attribute_path = contains(groups[*], 'grafana-admins') && 'Admin' || contains(groups[*], 'grafana-editors') && 'Editor' || 'Viewer'
allow_sign_up = trueLDAP #
# grafana.ini
[auth.ldap]
enabled = true
config_file = /etc/grafana/ldap.toml
# ldap.toml (extrait)
[[servers]]
host = "ldap.exemple.fr"
port = 636
use_ssl = true
bind_dn = "cn=grafana,ou=services,dc=exemple,dc=fr"
bind_password = "$__file{/run/secrets/ldap_password}"
search_filter = "(uid=%s)"
search_base_dns = ["ou=people,dc=exemple,dc=fr"]
[[servers.group_mappings]]
group_dn = "cn=supervision-admins,ou=groups,dc=exemple,dc=fr"
org_role = "Admin"
[[servers.group_mappings]]
group_dn = "*"
org_role = "Viewer"Auth proxy #
# grafana.ini : le reverse proxy authentifie et transmet l'identifiant dans un en-tête
[auth.proxy]
enabled = true
header_name = X-WEBAUTH-USER
header_property = username
auto_sign_up = true
whitelist = 10.0.0.10, 10.0.0.11 # seules les adresses du proxy peuvent fournir l'en-têteAttention : Sans liste blanche, n'importe qui pouvant joindre Grafana enverrait l'en-tête et se connecterait sous n'importe quelle identité. Grafana ne doit être joignable que par le proxy.
5. Protéger les secrets #
Mots de passe des sources, clés et jetons.
Ce que Grafana chiffre #
Les mots de passe et jetons des sources de données, des points de contact d'alerte et des plugins sont chiffrés dans la base de données avec la clé secret_key (chiffrement par enveloppe). Perdre cette clé rend ces secrets illisibles : sauvegardez-la à part, et utilisez la même sur toutes les instances.
Ne pas écrire les secrets en clair #
- Dans
grafana.iniet le provisioning, lisez les valeurs depuis un fichier ou l'environnement :$__file{/run/secrets/x},$__env{VAR}. - Grafana Enterprise peut aussi lire les secrets dans HashiCorp Vault (
$__vault{…}) et confier la clé de chiffrement à un KMS (AWS, Azure, Google Cloud, Vault). - Désactivez l'inscription libre (
allow_sign_up = falsepour la connexion locale) et changez le mot de passeadmininitial.
Commandes à connaître #
Commandes à connaître
grafana cli admin reset-admin-password <mdp>: réinitialiser le mot de passe de l'administrateurGET /api/org/users: lister les utilisateurs de l'organisation et leur rôlePOST /api/teams: créer une équipePOST /api/folders/:uid/permissions: définir les permissions d'un dossierPOST /api/serviceaccounts: créer un compte de servicePOST /api/serviceaccounts/:id/tokens: créer un jeton (secondsToLive)$__file{/run/secrets/x}: lire un secret depuis un fichier dans la configuration
Mi seguimiento
Inicia sesión para seguir tu progreso y tomar notas. Iniciar sesión
💬 Debates recientes del curso
- Grafana : une variable « service » qui dépend de la variable « environnement »✓ resuelto · 1 respuesta(s)
Hacer una pregunta sobre esta lección →Ver todos los debates del curso
Glossaire de la formation
Observabilidad
La capacidad de conocer el estado interno de un sistema a partir de los datos que emite.Estos datos se clasifican en 3 pilares: logs (registros)métric...
Grafana
Plataforma de código abierto para la visualización de datos y el análisis de métricas interactivas.
Prometheus
Sistema de monitorización y alertas de código abierto, particularmente adaptado para la recopilación de métricas en entornos dinámicos (como Kubernete...
APM (Application Performance Monitoring)
Monitorización del rendimiento de aplicaciones para identificar, diagnosticar y resolver problemas complejos relacionados con el rendimiento y la disp...
k6
Herramienta de código abierto para pruebas de carga (load testing) diseñada para ingeniería de rendimiento, que permite evaluar la fiabilidad y escala...
Trazas distribuidas
Técnica (proveniente del pilar de Trazas) que permite seguir el recorrido completo de una solicitud a través de múltiples microservicios para identifi...
Métricas
Medidas numéricas recopiladas a intervalos regulares (ej: CPU, RAM, tiempo de respuesta) utilizadas para evaluar el estado de salud general de un sist...
Alerting (Alertas)
Proceso que consiste en notificar a los equipos (vía email, Slack, Teams) cuando se detecta un evento específico, un umbral superado o una anomalía.
Código HTTP (HTTP Code)
Códigos de estado HTTP estandarizados que indican el resultado del procesamiento de una solicitud.1xx (Información): 100 Continue, 101 Switching Proto...
Access Log (Registro de acceso)
Archivo de registro que guarda las solicitudes procesadas por un servidor web (Apache, Nginx, Lighttpd, etc.). Permite rastrear la actividad del servi...
Client IP (IP del Cliente)
La dirección IP del usuario que realiza la solicitud hacia el servidor web. Cuando un usuario pasa por un Load Balancer o un proxy (ej: Cloudflare), l...
Timestamp (Marca de tiempo)
La fecha y la hora exactas en las que el servidor recibió la solicitud.Configuración: %t en Apache, $time_local o $time_iso8601 en Nginx.
Request (Solicitud)
La línea de solicitud inicial del cliente. Generalmente incluye el método HTTP (ej: GET), la URL solicitada y la versión del protocolo HTTP.Configurac...
Status Code (Código de estado)
El código de estado HTTP final devuelto por el servidor al cliente (ej: 200 para un éxito, 404 para recurso no encontrado).Configuración: %>s en Apach...
Size (Tamaño)
El volumen de datos devuelto al cliente, medido en bytes (generalmente sin los encabezados HTTP).Configuración: %b u %O en Apache, $body_bytes_sent en...
Referrer (Referente)
La URL de la página web desde la que el cliente hizo clic o siguió un enlace para acceder al recurso actual.Configuración: %{Referer}i en Apache, $htt...
User-Agent
La información de identificación proporcionada por el cliente sobre su navegador, su sistema operativo y su dispositivo. Su estructura estándar a menu...
Response Time (Tiempo de respuesta)
El tiempo total que tarda el servidor en procesar la solicitud y devolver la respuesta al cliente.Configuración: %D (microsegundos) o %T (segundos) en...
Artículos recomendados
Les fonctions Enterprise
Les fonctions de Grafana Enterprise (et des offres payantes de Grafana Cloud) : RBAC fin, permiss...
Automatiser Grafana : API HTTP, Terraform et cycle de vie des dashboards
Industrialiser Grafana : API HTTP (dossiers, dashboards, utilisateurs, sources), fournisseur Terr...
Banner de anuncio en Grafana: informar a todos los usuarios
Muestra un mensaje en la parte superior de todas las páginas de Grafana: activación, campo Messag...
Bonnes pratiques Grafana : dashboards, provisioning, performances et sécurité
Bonnes pratiques Grafana : conception de dashboards lisibles, variables, dashboards as code, prov...
Grafana Assistant : L'IA au service de l'observabilité
Découvrez Grafana Assistant, l'assistant d'IA de Grafana (Cloud, OSS et Enterprise). Apprenez com...
Grafana Provisioning : Automatisez la gestion de vos tableaux de bord et sources de données
Découvrez comment utiliser le provisioning de Grafana pour gérer vos configurations (dashboards, ...
Git Sync en Grafana: versionar los dashboards en GitHub
Sincroniza dashboards y carpetas de Grafana con un repositorio de GitHub: requisitos, token, conf...
La stack LGTM (Loki, Grafana, Tempo, Mimir) : architecture et mise en place
La stack LGTM de Grafana Labs : Loki pour les logs, Grafana pour la visualisation, Tempo pour les...
Cross-dashboard variables Grafana : partager des variables entre dashboards
Créez une fois vos variables Grafana et réutilisez-les partout : portée globale ou par dossier, a...