1. Lens #
L'éditeur de visualisations.
Principe #
Lens propose la visualisation adaptée quand on glisse un champ : histogramme dans le temps pour @timestamp, top valeurs pour un champ texte, métrique pour un nombre. On change ensuite de type (barres, aires, tableau, jauge, carte de chaleur, camembert) sans tout refaire.
| Besoin | Visualisation Lens |
|---|---|
| Évolution d'un volume | Barres ou aires empilées sur @timestamp |
| Top N | Barres horizontales triées |
| Indicateur clé | Metric (avec tendance) |
| Distribution | Histogramme sur un champ numérique |
| Répartition géographique | Maps |
| Formule | count(kql='http.response.status_code >= 500') / count() |
Bonne Pratique : La formule Lens permet de calculer des ratios (taux d'erreur, taux de cache) sans pré-calcul dans Elasticsearch.
2. Dashboards #
Interactifs et partageables.
Bonnes constructions #
- En haut : les indicateurs clés (Metric) ; au milieu : les tendances ; en bas : les tableaux de détail.
- Ajouter des contrôles (listes de services, d'environnements) pour filtrer tout le dashboard.
- Utiliser les drilldowns pour passer d'un panneau à Discover ou à un autre dashboard filtré.
- Ranger les dashboards par espace (Spaces) et par tags.
3. Objets enregistrés comme du code #
Export, import, versionnement.
API #
# Exporter tous les dashboards et leurs dépendances
curl -s -X POST localhost:5601/api/saved_objects/_export -u elastic:$PASS \
-H 'kbn-xsrf: true' -H 'Content-Type: application/json' \
-d '{"type": ["dashboard"], "includeReferencesDeep": true}' > dashboards.ndjson
# Importer dans un autre Kibana (ou un autre espace)
curl -s -X POST 'localhost:5601/s/equipe-web/api/saved_objects/_import?overwrite=true' -u elastic:$PASS \
-H 'kbn-xsrf: true' -F file=@dashboards.ndjsonVersionner le fichier .ndjson dans Git et l'importer depuis la CI permet de promouvoir un dashboard de la préproduction à la production et de le restaurer en cas de mauvaise manipulation.
À savoir : Le préfixe /s/<espace> cible un espace Kibana ; sans préfixe, c'est l'espace par défaut.