Aller au contenu principal

Observabilité managée

Analysez la télémétrie applicative et les signaux d'infrastructure SailOps depuis un workspace Grafana managé.

L'observabilité managée fournit à chaque organisation un workspace Grafana provisionné par SailOps, avec des datasources et des tableaux de bord préconfigurés. Utilisez-la lorsque vous avez besoin d'une analyse plus poussée que les pages Monitoring intégrées, notamment pour les métriques applicatives custom et l'analyse complète des traces.

Ce que l'observabilité managée inclut​

SignalSourceOù l'utiliser
Métriques customVos workloads exportent des métriques OTLP vers SailOpsDatasource Grafana Custom Metrics
TracesVos workloads exportent des traces OTLP vers SailOpsDatasource Grafana Traces
Dépendances de servicesSailOps dérive le graphe de services à partir de vos tracesDatasource Grafana Trace Dependencies
Métriques d'infrastructureSailOps collecte l'utilisation des ressources depuis le clusterTableaux de bord infra Grafana et métriques Monitoring
LogsSailOps collecte stdout et stderr des workloadsDatasource logs Grafana et Log Explorer
info

La page Metrics intégrée et Grafana managé sont complémentaires. Les métriques intégrées se concentrent sur l'utilisation des ressources SailOps, et la page Observability intégrée liste des traces ayant une activité récente, triées par heure de début. Grafana est l'endroit adapté pour les métriques OpenTelemetry custom, l'analyse des traces span par span et les tableaux de bord croisant plusieurs signaux.

Activer Grafana​

  1. Ouvrez Monitoring pour votre organisation.
  2. Allez dans Grafana.
  3. Cliquez sur Activate Grafana.
  4. Attendez que le statut passe à Ready.
  5. Cliquez sur Open Grafana.

L'activation provisionne un workspace Grafana au niveau de l'organisation et le connecte à SailOps via un accès authentifié. Les utilisateurs ouvrent Grafana via SailOps ; les datasources backend ne sont pas exposées directement. L'activation est idempotente — vous pouvez cliquer à nouveau sur Activate Grafana ou Retry activation en toute sécurité si le workspace reste bloqué en Provisioning ou passe en état Error.

attention

Vous devez avoir les permissions maintainer ou owner sur l'organisation pour activer Grafana. Ouvrir le workspace exige un accès monitoring au niveau organisation ; des permissions limitées à un projet ne donnent pas cet accès.

Accès Grafana et sécurité​

L'interface utilise votre session SailOps. SailOps traduit votre rôle d'organisation en rôle Grafana : les owners et maintainers deviennent Admin, les developers Editor, et les readers et accountants Viewer. Grafana applique ensuite ses permissions natives.

Le workspace contient une seule organisation Grafana et couvre toute votre organisation SailOps. Les filtres projet restreignent les résultats ; ils n'isolent pas l'accès à un projet. Les tokens de Service Account suivent les permissions Grafana, indépendamment des clés et scopes API SailOps.

La page Grafana affiche le statut du workspace, l'action Open Grafana, les projets connectés, les connexions OpenTelemetry et les signaux actifs.

Les datasources managées sont en lecture seule et leurs identifiants sont gérés par SailOps. Ne copiez pas ces identifiants hors de Grafana et ne les configurez pas dans vos workloads ; les workloads utilisent des tokens d'ingestion. Les requêtes aux datasources vérifient l'état de l'organisation et l'isolation des données entre organisations.

Le nom d'hôte public Grafana accepte également les tokens natifs de Service Account. L'accès direct contourne les vérifications du workspace et du cycle de vie effectuées par le proxy SailOps ; les requêtes aux datasources managées conservent leurs vérifications d'organisation. La suspension de l'organisation arrête Grafana de façon asynchrone.

Le proxy et la route publique Grafana bloquent les mêmes chemins pour les fonctions désactivées. Le proxy applique des restrictions supplémentaires à l'administration des datasources et des plugins. L'alerting Grafana, les snapshots, le partage public de tableaux de bord et les organisations Grafana supplémentaires sont désactivés.

Service Accounts pour les appels API​

  1. Ouvrez Grafana en tant qu'owner ou maintainer de l'organisation.
  2. Allez dans Administration > Users and access > Service accounts et créez un compte. Utilisez Viewer pour les requêtes en lecture seule.
  3. Ajoutez un token qui expire dans un délai maximal de 90 jours et conservez-le dans votre gestionnaire de secrets. Renouvelez les tokens et révoquez ceux qui sont inutilisés ou compromis dans Grafana.
  4. Envoyez-le en Bearer à l'URL Grafana SailOps de votre organisation :
curl --fail-with-body --max-time 20 \
--header "Authorization: Bearer ${GRAFANA_TOKEN}" \
"https://app.sailops.io/api/v1/organizations/${ORGANIZATION_ID}/observability/grafana/api/search"

Utilisez le même préfixe d'URL pour les endpoints de requête tels que api/ds/query. SailOps vérifie la disponibilité du workspace et l'état de l'organisation ; Grafana valide le token et ses permissions. Un token invalide est refusé même en présence d'une session navigateur. Les tokens de Service Account ne permettent pas d'ouvrir des connexions WebSocket via ce proxy.

Les nouveaux tokens doivent expirer dans un délai maximal de 90 jours. Les tokens existants, y compris ceux sans expiration, restent inchangés ; renouvelez-les pour appliquer cette limite.

Si un Service Account est compromis, supprimez tous ses tokens avant de changer son rôle ou de le réactiver. Désactiver le compte ou réduire ses permissions ne garantit pas une coupure d'accès immédiate, car Grafana met en cache l'état du compte et ses permissions. Pour modifier les permissions lors d'un renouvellement, révoquez d'abord les anciens tokens, changez le rôle, puis créez les tokens de remplacement.

Consultez la documentation des Service Accounts Grafana pour gérer les tokens et les rôles.

Tableaux de bord et datasources​

Grafana managé est provisionné avec des datasources pour :

  • Metrics - CPU, mémoire, stockage et utilisation des ressources collectés par SailOps
  • Logs - logs de workloads collectés par SailOps
  • Custom Metrics - métriques OTLP client stockées dans le backend de métriques managé
  • Traces - traces OTLP client stockées dans le backend de tracing managé
  • Trace Dependencies - le graphe de dépendances de services dérivé de vos traces

Le tableau de bord APM combine les métriques TraceQL et le graphe Trace Dependencies pour présenter le taux de requêtes, le taux d'erreurs, la latence p95 et les relations entre services.

Les tableaux de bord Grafana proposent des filtres projet et ressource lorsque ces informations sont disponibles. Les logs exposent des labels orientés ressource afin de filtrer par projet, type de workload, nom de ressource, namespace, pod, container et stream.

Traces sur la page Observability​

La page Observability inclut un panneau Traces sous les graphiques de métriques. Il affiche les traces les plus récentes reçues par SailOps pour l'organisation courante, triées par heure de début (les plus récentes en premier).

Chaque trace affiche :

ColonneDescription
StartHorodatage du span racine
ServiceNom du service issu du span racine
Root operationNom du span racine (ex. GET /api/orders)
DurationDurée totale de la trace
Trace IDIdentifiant tronqué (survolez pour l'identifiant complet)

Jusqu'à 20 traces sont affichées par requête. La fenêtre temporelle et le filtre Workload sont partagés avec les graphiques de métriques — sélectionner un nom de workload restreint à la fois les métriques et les traces. Le filtre Workload type s'applique uniquement aux métriques ; lorsqu'un type de workload autre que « All types » est sélectionné, une note précise que les traces suivent uniquement le filtre par nom de workload.

Si OpenTelemetry n'est pas activé pour l'organisation, le panneau affiche un lien vers la page d'activation. Si les traces ne se chargent pas, les métriques restent visibles et vous pouvez relancer les traces indépendamment.

astuce

Pour une analyse des traces span par span et une investigation croisant plusieurs signaux, ouvrez Grafana managé depuis la page Grafana.

Pages du Monitoring Center​

Le Monitoring Center fournit des vues intégrées autour du même système :

PageRôle
OverviewVue d'ensemble de l'organisation : nombre d'alertes ouvertes et répartition par sévérité, projets accessibles, état de la configuration OpenTelemetry, aperçu des alertes avec filtrage par sévérité et inspection détaillée, sparklines des métriques de ressources (CPU, mémoire, stockage, instances en cours d'exécution) sur une période configurable (jusqu'à 24 heures), utilisation de la télémétrie managée (échantillons de métriques, spans de traces, stockage, overage), état du workspace Grafana et liens rapides vers les Logs, Événements et l'historique des alertes. Chaque section est conditionnée par les permissions du lecteur.
ObservabilityPanneaux intégrés pour workloads, CPU, mémoire et stockage, ainsi que des traces ayant une activité dans la période sélectionnée (24 heures au maximum), triées par heure de début
Log ExplorerRecherche de logs côté serveur avec filtres projet, workload, niveau, stream, temps et texte
Project observabilityStatut d'injection OpenTelemetry pour les projets et workloads
GrafanaActivation et accès à Grafana managé

L'utilisation de télémétrie et de logs, les quotas et l'overage projeté se trouvent désormais dans les Paramètres de l'Organisation sous les pages dédiées Observability usage et Log usage dans la section Billing.

Sujets liés​

Interroger la datasource Metrics​

La datasource d'infrastructure Metrics accepte un sous-ensemble PromQL : metric{label="value"}, éventuellement enveloppé dans sum, avg, max ou min, avec by (labels) optionnel. Les filtres acceptent =, !=, =~, !~ et les guillemets simples ou doubles. Les fonctions, calculs arithmétiques et comparaisons sont indisponibles dans les requêtes ; utiliser les expressions Grafana Reduce, Math ou Threshold.

Les requêtes instantanées acceptent l'extension SailOps [d], par exemple sum(sailops_gateway_latency_avg_ms{project="mon-projet"}[1h]). Elle évalue sur cette fenêtre, sans produire un vecteur de plage Prometheus. Les compteurs et ratios utilisent 5 minutes par défaut. [d] est indisponible sur les requêtes de plage ; la fenêtre doit durer entre 30 s et 93 jours. Une syntaxe, un nom ou un label non pris en charge renvoie 400 bad_data ; une limite atteinte renvoie 422 execution et une panne backend 500. Filtrer avec project, pas avec le namespace interne.

Les horodatages marquent les débuts d'intervalles ; les données ont généralement 30 à 45 s de retard. Les plages finissent au dernier intervalle complet avant maintenant moins 30 s. Le pas augmente par multiples de 15 s pour rester sous 1 100 points. Sans données, aucun échantillon ; sans trafic, aucun ratio. Un compteur plat observé donne un vrai zéro. Une jauge instantanée disparaît environ 45 s après l'arrêt de l'ingestion.

Labels et séries des gateways​

project est commun aux familles. Les séries de conteneurs/workloads exposent workload, resource, workload_kind, pod, instance, product_id ; le stockage ajoute l'identité du volume ; les moteurs exposent leurs labels de cluster/instance. Les gateways exposent gateway, route, route_kind et gateway_scope (project ou shared). La portée décrit la gateway propriétaire, pas le locataire : les lignes partagées restent rattachées au projet de la route. La découverte indique les labels acceptés par chaque métrique.

Métrique de gatewaySignification
sailops_gateway_requests_per_secDébit HTTP/gRPC
sailops_gateway_requests_2xx_per_sec, sailops_gateway_requests_4xx_per_sec, sailops_gateway_requests_5xx_per_secDébits par classe HTTP
sailops_gateway_requests_other_per_secDébit 1xx et 3xx
sailops_gateway_5xx_ratio5xx / requêtes HTTP et gRPC
sailops_gateway_error_ratioAlias déprécié de sailops_gateway_5xx_ratio, sans les 4xx
sailops_gateway_latency_avg_msTemps de réponse upstream moyen pondéré
sailops_gateway_latency_sum_ms_per_sec, sailops_gateway_latency_count_per_secDébits de somme et de nombre d'échantillons
sailops_gateway_requests_le_500ms_per_secRéponses upstream complètes en au plus 500 ms
sailops_gateway_slow_requests_ratioRéponses upstream complètes au-delà de 500 ms / nombre d'échantillons
sailops_gateway_timeouts_per_secDébit de timeouts HTTP/gRPC
sailops_gateway_connection_failures_per_secTentatives de connexion échouées, séparées par route_kind
sailops_gateway_tcp_connections_per_secDébit de connexions TCPRoute et TLSRoute

Calculs pondérés et tableaux de bord​

Les ratios regroupent les deltas des sources Envoy et des routes : somme des numérateurs / somme des dénominateurs. sum, avg et l'absence d'agrégation utilisent ce regroupement ; min et max comparent les ratios pondérés des séries. Une moyenne non pondérée des moyennes d'intervalles peut déformer la plage entière.

Pour un temps de réponse moyen, interroger sailops_gateway_latency_sum_ms_per_sec et sailops_gateway_latency_count_per_sec, appliquer Reduce(sum) à chacun, puis Math $sum/$count. On peut aussi utiliser le sélecteur de fenêtre instantanée sur sailops_gateway_latency_avg_ms. Le débit de requêtes moins sailops_gateway_latency_count_per_sec estime sur une plage les réponses sans échantillon upstream complet ; le décalage de vidage des histogrammes peut rendre brièvement la différence négative.

Gateways & Traffic sépare le débit, le taux d'erreur 5xx et le temps de réponse upstream moyen sur la plage sélectionnée des séries temporelles par route. Les connexions TCP/TLS sont séparées du trafic HTTP. Le taux d'erreur de la console compte aussi les 4xx.

Alerting Grafana et alertes SailOps​

Les règles d'alerte, points de contact et notifications Grafana sont indisponibles dans Grafana managé. Les alertes SailOps du Monitoring Center sont une fonctionnalité distincte et restent disponibles.