Supervision de la plateforme

Mettez en place la supervision de l'infrastructure de votre déploiement kuploy-cloud. Cette page couvre l'intégration à Prometheus, les règles d'alerte, les points d'accès de santé et l'agrégation des journaux.

Pour la supervision au niveau des applications (journaux, métriques et alertes du point de vue du développeur), voir Supervision et journaux.

Les points d'accès de santé

Kuploy expose deux points d'accès de santé, destinés aux sondes de vivacité et de disponibilité :

Point d'accès	Rôle
/api/health	Contrôle de santé élémentaire : le processus tourne-t-il ?
/api/health/ready	Contrôle de disponibilité : la base de données est-elle connectée ?

# Depuis l'intérieur du cluster
kubectl exec -it deployment/kuploy -n kuploy -- curl -s localhost:3000/api/health

# Depuis l'extérieur, si l'ingress est configuré
curl -s https://console.example.com/api/health

Les métriques Prometheus

Kuploy expose des métriques compatibles Prometheus sur /metrics. Pour les collecter, créez un ServiceMonitor :

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: kuploy
  namespace: kuploy
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: kuploy
  endpoints:
  - port: http
    path: /metrics

Les règles d'alerte

Quelques alertes, pour l'Alertmanager de Prometheus :

groups:
- name: kuploy
  rules:
  - alert: KuployDown
    expr: up{job="kuploy"} == 0
    for: 5m
    labels:
      severity: critical
    annotations:
      summary: "Kuploy is down"
  - alert: KuployHighErrorRate
    expr: rate(http_requests_total{job="kuploy",status=~"5.."}[5m]) > 0.1
    for: 5m
    labels:
      severity: warning

Les intégrations de supervision externes

Exportez vos métriques vers la plateforme de supervision de votre choix :

• Prometheus — le point d'accès des métriques est disponible sur /metrics ;
• Datadog — par l'intégration de l'agent Datadog ;
• New Relic — en installant l'agent New Relic ;
• Grafana — en le branchant sur le point d'accès Prometheus.

L'agrégation des journaux

Transférez vos journaux vers des services externes, pour les analyser au même endroit :

• Papertrail — configurez un transfert syslog ;
• Logtail — utilisez le collecteur Logtail ;
• Datadog Logs — configurez le transfert de journaux ;
• Elasticsearch — mettez en place une expédition de journaux.

Pour configurer un transfert de journaux :

1. Allez dans Settings → Log Drains
2. Cliquez sur Add Drain
3. Choisissez votre prestataire
4. Saisissez les informations de connexion
5. Cliquez sur Save