OpenTelemetry et métriques custom
Envoyez les métriques et traces applicatives vers SailOps avec OTLP.
SailOps peut injecter la configuration OpenTelemetry dans les workloads compatibles ou fournir les variables d'environnement nécessaires pour une configuration manuelle. La télémétrie est rattachée à l'organisation, au projet et au workload afin d'apparaître dans les bons tableaux de bord Grafana et rapports d'utilisation.
Workloads supportés
Le Monitoring Center découvre actuellement les connexions OpenTelemetry prêtes à configurer pour :
- containers
- jobs
- cronjobs
Les autres ressources apparaissent toujours dans les métriques d'infrastructure et les logs intégrés, mais l'aide à la connexion OpenTelemetry automatique est limitée à ces types de workloads.
Activer l'observabilité projet
L'observabilité projet injecte des variables d'environnement OTLP gérées par SailOps dans les workloads compatibles d'un projet.
- Ouvrez Monitoring.
- Allez dans Project observability.
- Sélectionnez un projet.
- Cliquez sur Enable.
Après activation, la page affiche le statut de synchronisation de chaque projet et la couverture des workloads :
| Statut | Signification |
|---|---|
| Enabled | SailOps gère les variables OpenTelemetry du projet |
| Synced | Les workloads compatibles ont les variables attendues |
| Partial | Certains workloads sont configurés et d'autres demandent une action |
| Error | SailOps n'a pas pu synchroniser un ou plusieurs workloads |
| Missing token | Le secret d'ingestion du workload est manquant ou incomplet — resynchronisez ou effectuez une rotation du token projet pour le restaurer |
| Legacy token | Le workload utilise encore un ancien token et doit être rotaté ou resynchronisé |
Environnement injecté
SailOps injecte ces variables :
| Variable | Secret | Description |
|---|---|---|
OTEL_EXPORTER_OTLP_ENDPOINT | Non | Endpoint HTTP OTLP SailOps |
OTEL_EXPORTER_OTLP_HEADERS | Oui | Header d'autorisation avec le bearer token d'ingestion |
OTEL_RESOURCE_ATTRIBUTES | Non | Labels SailOps pour l'organisation, le projet et le workload |
OTEL_SERVICE_NAME | Non | Nom du workload utilisé comme nom de service OpenTelemetry |
Traitez OTEL_EXPORTER_OTLP_HEADERS comme un secret. L'interface le masque après création.
Configuration manuelle
Utilisez la configuration manuelle lorsqu'un workload ne peut pas utiliser l'injection au niveau projet ou lorsque vous voulez configurer un collector OpenTelemetry externe.
- Ouvrez Monitoring.
- Allez dans Project observability.
- Ouvrez Project env ou la fenêtre d'environnement d'un workload.
- Copiez les variables non secrètes et configurez le token secret via votre gestionnaire de secrets.
- Configurez votre SDK ou collector OpenTelemetry pour exporter en OTLP sur HTTP.
Le header d'autorisation doit utiliser un bearer token :
OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer <INGESTION_TOKEN>"
Rotation et révocation des tokens
Les maintainers peuvent rotater ou désactiver l'observabilité projet depuis la page Project observability.
| Action | Effet |
|---|---|
| Resync | Réapplique l'environnement OpenTelemetry attendu aux workloads compatibles. Si le secret d'ingestion d'un workload est manquant ou contient un token révoqué, la resynchronisation effectue automatiquement une rotation du token projet. |
| Rotate | Crée un token d'ingestion de remplacement et resynchronise les workloads compatibles |
| Disable | Retire l'injection d'observabilité gérée par SailOps lors de la resynchronisation |
Si un workload affiche le statut Missing token, utilisez Resync pour le restaurer. La resynchronisation détecte les credentials manquants ou révoqués et provisionne automatiquement un nouveau token d'ingestion si nécessaire.
Ce qui apparaît dans Grafana
Les métriques custom et les traces apparaissent dans Grafana managé après émission de données OTLP par votre application. Des traces ayant une activité récente sont aussi listées dans Monitoring → Observability, triées par heure de début. Les noms de métriques, labels et attributs de ressource viennent de votre configuration SDK ou collector OpenTelemetry, complétés par les attributs SailOps injectés par la plateforme.
Si les tableaux de bord sont vides :
- vérifiez que Grafana est Ready
- vérifiez que le projet ou le workload est Configured
- resynchronisez le projet si un workload affiche Missing token
- vérifiez que votre application exporte des métriques ou traces OTLP
- vérifiez que le workload utilise l'endpoint SailOps et le bearer header
Utilisation et quotas
SailOps suit l'utilisation d'observabilité pour les échantillons de métriques, spans de trace, séries actives et stockage de télémétrie retenu. Vous pouvez consulter cette utilisation dans Monitoring → Usage → Telemetry.
La page Usage affiche :
- les échantillons de métriques ingérés
- les spans de trace ingérés
- le stockage retenu en Gio-mois
- les séries actives en moyenne, p95 et maximum
- le quota inclus dans votre plan
- l'overage courant et projeté
- la répartition d'utilisation par projet