Aller au contenu principal

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.

  1. Ouvrez Monitoring.
  2. Allez dans Project observability.
  3. Sélectionnez un projet.
  4. Cliquez sur Enable.

Après activation, la page affiche le statut de synchronisation de chaque projet et la couverture des workloads :

StatutSignification
EnabledSailOps gère les variables OpenTelemetry du projet
SyncedLes workloads compatibles ont les variables attendues
PartialCertains workloads sont configurés et d'autres demandent une action
ErrorSailOps n'a pas pu synchroniser un ou plusieurs workloads
Missing tokenLe secret d'ingestion du workload est manquant ou incomplet — resynchronisez ou effectuez une rotation du token projet pour le restaurer
Legacy tokenLe workload utilise encore un ancien token et doit être rotaté ou resynchronisé

Environnement injecté​

SailOps injecte ces variables :

VariableSecretDescription
OTEL_EXPORTER_OTLP_ENDPOINTNonEndpoint HTTP OTLP SailOps
OTEL_EXPORTER_OTLP_HEADERSOuiHeader d'autorisation avec le bearer token d'ingestion
OTEL_RESOURCE_ATTRIBUTESNonLabels SailOps pour l'organisation, le projet et le workload
OTEL_SERVICE_NAMENonNom du workload utilisé comme nom de service OpenTelemetry
attention

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.

  1. Ouvrez Monitoring.
  2. Allez dans Project observability.
  3. Ouvrez Project env ou la fenêtre d'environnement d'un workload.
  4. Copiez les variables non secrètes et configurez le token secret via votre gestionnaire de secrets.
  5. 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.

ActionEffet
ResyncRé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.
RotateCrée un token d'ingestion de remplacement et resynchronise les workloads compatibles
DisableRetire l'injection d'observabilité gérée par SailOps lors de la resynchronisation
astuce

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

Sujets liés​