Démarrer le monitoring Kubernetes avec kube-prometheus-stack en 15 minutes

Vous gérez un cluster Kubernetes sans visibilité sur son état réel ? Ce quickstart vous guide pour déployer kube-prometheus-stack, la stack de monitoring la plus adoptée : 75% des utilisateurs Kubernetes utilisent Prometheus et Grafana selon Grafana Labs.

En 15 minutes, vous aurez des dashboards fonctionnels affichant métriques CPU, mémoire et état des pods.

TL;DR : kube-prometheus-stack combine Prometheus, Grafana et Alertmanager en un seul Helm chart. Prérequis : cluster Kubernetes actif + Helm 3 installé. Résultat : dashboards de monitoring opérationnels accessibles via port-forward.

Cette compétence pratique est au cœur de la formation LFS458 Administration Kubernetes.

---

Pourquoi kube-prometheus-stack est-il le standard du monitoring Kubernetes ?

kube-prometheus-stack est un Helm chart qui déploie automatiquement Prometheus, Grafana, Alertmanager et les exporters essentiels. 82% des utilisateurs de conteneurs exécutent Kubernetes en production selon le CNCF Annual Survey 2025, et la majorité utilisent cette stack.

kube-prometheus-stack est une distribution préconfigurée qui inclut :

• Prometheus Operator : gère les instances Prometheus via CRDs
• Grafana : 40+ dashboards Kubernetes préinstallés
• Alertmanager : routage des alertes vers Slack, email, PagerDuty
• node-exporter : métriques système des nœuds
• kube-state-metrics : métriques des objets Kubernetes (Deployments, Pods, Services)

À retenir : kube-prometheus-stack réduit le temps de configuration de plusieurs heures à quelques minutes grâce aux valeurs par défaut optimisées pour Kubernetes.

Comme le souligne Chris Aniszczyk, CTO de la CNCF : "Kubernetes is no longer experimental but foundational." Le monitoring est désormais une exigence de production, pas un luxe.

---

Quels sont les prérequis pour ce quickstart ?

Avant de commencer, vérifiez ces éléments :

Clusters compatibles : minikube, kind, k3s, EKS, GKE, AKS. Pour un environnement local, minikube avec 4 Go de RAM suffit. Consultez notre guide sur les bonnes pratiques conteneurisation et Docker si vous débutez.

# Vérifier la connexion au cluster
kubectl cluster-info
kubectl get nodes

---

Étape 1 : Ajouter le repository Helm prometheus-community

Ajoutez le repository officiel contenant kube-prometheus-stack :

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update

Ce repository maintient les charts officiels de la communauté Prometheus. La version 68.x (février 2026) inclut Prometheus 2.54, Grafana 11.x et les derniers correctifs de sécurité.

À retenir : Exécutez helm repo update régulièrement pour bénéficier des mises à jour de sécurité et des nouvelles fonctionnalités.

---

Étape 2 : Créer le namespace monitoring

Isolez les composants de monitoring dans un namespace dédié :

kubectl create namespace monitoring

Cette isolation facilite la gestion des ressources, l'application de ResourceQuotas et la configuration RBAC. Les équipes IT passent en moyenne 34 jours ouvrés par an à résoudre des problèmes Kubernetes selon Cloud Native Now. Un namespace dédié simplifie le diagnostic.

---

Étape 3 : Installer kube-prometheus-stack avec Helm

Déployez la stack complète avec cette commande :

helm install prometheus-stack prometheus-community/kube-prometheus-stack \
  --namespace monitoring \
  --set grafana.adminPassword=VotreMotDePasse \
  --set prometheus.prometheusSpec.retention=7d \
  --set prometheus.prometheusSpec.resources.requests.memory=1Gi \
  --set prometheus.prometheusSpec.resources.requests.cpu=500m

Cette installation déploie :

• Prometheus avec 7 jours de rétention
• Grafana avec mot de passe admin personnalisé
• Alertmanager pour les notifications
• ServiceMonitors préconfigurés pour les composants Kubernetes

Vérifiez le déploiement :

kubectl get pods -n monitoring

Attendez que tous les pods affichent Running (2-3 minutes selon le cluster).

---

Étape 4 : Accéder à Grafana via port-forward

Exposez Grafana localement pour accéder aux dashboards :

kubectl port-forward -n monitoring svc/prometheus-stack-grafana 3000:80

Ouvrez votre navigateur sur http://localhost:3000 et connectez-vous :

• Utilisateur : admin
• Mot de passe : celui défini à l'étape 3

Grafana inclut plus de 40 dashboards préconfigurés. Pour approfondir la création de dashboards personnalisés, consultez notre guide sur l'architecture de monitoring Kubernetes en production.

---

Étape 5 : Explorer les dashboards Kubernetes essentiels

Naviguez vers Dashboards > Browse dans Grafana. Les dashboards clés pour commencer :

À retenir : Le dashboard "Kubernetes / Compute Resources / Cluster" doit être votre point d'entrée quotidien pour valider la santé globale du cluster.

Pour comprendre les métriques affichées, référez-vous à notre article sur l'observabilité Kubernetes : métriques, logs et traces.

---

Étape 6 : Vérifier la collecte des métriques Prometheus

Accédez à l'interface Prometheus pour valider la collecte :

kubectl port-forward -n monitoring svc/prometheus-stack-kube-prometheus-prometheus 9090:9090

Ouvrez http://localhost:9090 et testez ces requêtes PromQL :

# Utilisation CPU par namespace
sum(rate(container_cpu_usage_seconds_total{container!=""}[5m])) by (namespace)

# Mémoire utilisée par pod
sum(container_memory_working_set_bytes{container!=""}) by (pod)

# Nombre de pods par état
sum(kube_pod_status_phase) by (phase)

Ces requêtes constituent la base du monitoring Kubernetes. 70% des organisations utilisent Helm pour déployer leurs applications Kubernetes selon Orca Security 2025.

---

Étape 7 : Personnaliser les valeurs par défaut

Créez un fichier values.yaml pour vos configurations :

# values-custom.yaml
prometheus:
  prometheusSpec:
    retention: 15d
    storageSpec:
      volumeClaimTemplate:
        spec:
          accessModes: ["ReadWriteOnce"]
          resources:
            requests:
              storage: 50Gi

grafana:
  persistence:
    enabled: true
    size: 10Gi

alertmanager:
  config:
    route:
      receiver: 'slack-notifications'
    receivers:
      - name: 'slack-notifications'
        slack_configs:
          - channel: '#alertes-kubernetes'
            api_url: 'https://hooks.slack.com/services/xxx'

Appliquez les modifications :

helm upgrade prometheus-stack prometheus-community/kube-prometheus-stack \
  --namespace monitoring \
  -f values-custom.yaml

Pour un guide complet sur l'installation de Prometheus, consultez notre guide d'installation et configuration Prometheus sur Kubernetes.

---

Quelles sont les prochaines étapes après ce quickstart ?

Votre stack de monitoring est opérationnelle. Voici les actions recommandées :

1. Configurer des alertes : définissez des PrometheusRules pour les seuils critiques
2. Ajouter des ServiceMonitors : exposez les métriques de vos applications
3. Intégrer les logs : déployez Loki pour la corrélation métriques/logs
4. Sécuriser l'accès : configurez l'authentification Grafana avec OIDC

Comme le rappelle TealHQ : "Don't let your knowledge remain theoretical - set up a real Kubernetes environment to solidify your skills." Ce quickstart est votre premier pas. La formation LFS458 Administration Kubernetes vous permettra de maîtriser les configurations avancées nécessaires pour la production et vous préparer à la certification CKA.

---

Passez au niveau supérieur avec les formations SFEIR

Vous avez déployé votre première stack de monitoring. Pour aller plus loin :

• LFS458 Administration Kubernetes : 4 jours pour maîtriser l'administration de clusters incluant le monitoring en production. Prépare à la certification CKA.
• LFD459 Kubernetes pour les développeurs : intégrez l'observabilité dans vos applications cloud-native. Prépare à la certification CKAD.
• Kubernetes, les fondamentaux : découvrez les concepts essentiels en 1 jour si vous débutez. Pour approfondir, consultez notre formation monitoring et dépannage kubernetes paris présentiel.

Consultez notre guide complet Formation Kubernetes pour identifier le parcours adapté à votre profil. Pour un devis formation Kubernetes personnalisé, contactez nos conseillers.