Labels & Monitoring

Labels personnalises

Ajoutez des labels sur toutes les ressources Kubernetes et GCP de votre application :

labels:
  team: team-services
  bu: my-bu
  project: custom-project

Comportement

• Les labels sont propages sur toutes les ressources K8s : Deployment, Service, Worker, CronJob, Migration, ConfigMap, PDB, PodMonitoring.
• Les labels sont aussi ajoutes dans les default_labels du provider GCP, donc appliques automatiquement sur les Buckets, Cloud Functions, Pub/Sub, etc.
• Le label project est auto-injecte avec la valeur de APPSLUG si vous ne le definissez pas.
• Les labels systeme (app, appSlug, deployedBy, bu, env) ne peuvent pas etre ecrases par des labels custom.

Exemples d’utilisation

# Identifier l'equipe proprietaire
labels:
  team: team-services

# Ajouter un centre de cout
labels:
  team: team-services
  cost-center: CC-1234

# Tout laisser par defaut (project = APPSLUG)
labels: {}

Astuce

Le label project est automatiquement defini a partir du slug de l’application. Vous n’avez besoin de le definir que si vous voulez un nom different.

Monitoring Prometheus

Activez le scraping Prometheus via un PodMonitoring (Google Managed Prometheus) :

prometheusScrape:
  enabled: true
  path: /metrics
  port: 80
  interval: 30s

Proprietes

Propriete	Type	Defaut	Description
enabled	boolean	false	Activer le PodMonitoring
path	string	/metrics	Chemin de l’endpoint metriques
port	integer	80	Port a scraper
interval	string	30s	Intervalle de scraping

Comment ca marche

Quand prometheusScrape.enabled est true, le deployer cree une ressource PodMonitoring dans le namespace de l’application. Cette ressource est detectee par Google Managed Prometheus (GMP) qui scrape automatiquement les metriques.

Les metriques sont ensuite disponibles dans :

• Cloud Monitoring (console GCP)
• Grafana (si connecte a Cloud Monitoring comme datasource)

Prerequis

• Google Managed Prometheus doit etre active sur le cluster GKE (actif par defaut sur les clusters standards et Autopilot).
• L’application doit exposer un endpoint de metriques compatible Prometheus (format texte OpenMetrics).

Exemple complet

name: my-api
codeType: Web

labels:
  team: team-backend

prometheusScrape:
  enabled: true
  path: /metrics
  port: 8080
  interval: 15s

network:
  - name: default
    services:
      - name: http
        port: 8080
        path: /

Note

Le PodMonitoring n’est cree que pour les applications de type Web. Les types Static, Spa et Infra n’ont pas de pods a monitorer.

Dashboards GCP Monitoring

Provisionnez des dashboards GCP Cloud Monitoring directement depuis le deployer. Les dashboards sont geres par Terraform (google_monitoring_dashboard) : supprimer une entree du deployer.yaml supprime le dashboard au prochain deploy.

Configuration

dashboards:
  - name: my-dashboard
    jsonPath: ./monitoring/my-dashboard.json

Proprietes

Propriete	Type	Requis	Description
name	string	oui	Identifiant unique du dashboard (utilise pour le nommage Terraform)
jsonPath	string	oui	Chemin relatif vers le fichier JSON du dashboard

Comment obtenir le fichier JSON

1. Creez ou modifiez un dashboard dans la console GCP Monitoring.
2. Cliquez sur les trois points (⋮) > Telecharger le JSON.
3. Placez le fichier dans votre depot (ex: monitoring/my-dashboard.json).
4. Referencez-le dans deployer.yaml.

Exemple complet

name: my-api
codeType: Web

dashboards:
  - name: overview
    jsonPath: ./monitoring/overview.json
  - name: performance
    jsonPath: ./monitoring/performance.json

Astuce

Le fichier JSON doit etre un JSON valide. Le deployer valide le contenu avant de l’envoyer a Terraform.

---

Voir aussi : Toutes les proprietes | deployer.yaml