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
| Signal | Source | Où l'utiliser |
|---|---|---|
| Métriques custom | Vos workloads exportent des métriques OTLP vers SailOps | Datasource Grafana Custom Metrics |
| Traces | Vos workloads exportent des traces OTLP vers SailOps | Datasource Grafana Traces |
| Dépendances de services | SailOps dérive le graphe de services à partir de vos traces | Datasource Grafana Trace Dependencies |
| Métriques d'infrastructure | SailOps collecte l'utilisation des ressources depuis le cluster | Tableaux de bord infra Grafana et métriques Monitoring |
| Logs | SailOps collecte stdout et stderr des workloads | Datasource logs Grafana et Log Explorer |
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
- Ouvrez Monitoring pour votre organisation.
- Allez dans Grafana.
- Cliquez sur Activate Grafana.
- Attendez que le statut passe à Ready.
- 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.
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
- Ouvrez Grafana en tant qu'owner ou maintainer de l'organisation.
- Allez dans Administration > Users and access > Service accounts et créez un compte. Utilisez Viewer pour les requêtes en lecture seule.
- 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.
- 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 :
| Colonne | Description |
|---|---|
| Start | Horodatage du span racine |
| Service | Nom du service issu du span racine |
| Root operation | Nom du span racine (ex. GET /api/orders) |
| Duration | Durée totale de la trace |
| Trace ID | Identifiant 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.
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 :
| Page | Rôle |
|---|---|
| Overview | Vue 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. |
| Observability | Panneaux 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 Explorer | Recherche de logs côté serveur avec filtres projet, workload, niveau, stream, temps et texte |
| Project observability | Statut d'injection OpenTelemetry pour les projets et workloads |
| Grafana | Activation 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 gateway | Signification |
|---|---|
sailops_gateway_requests_per_sec | Débit HTTP/gRPC |
sailops_gateway_requests_2xx_per_sec, sailops_gateway_requests_4xx_per_sec, sailops_gateway_requests_5xx_per_sec | Débits par classe HTTP |
sailops_gateway_requests_other_per_sec | Débit 1xx et 3xx |
sailops_gateway_5xx_ratio | 5xx / requêtes HTTP et gRPC |
sailops_gateway_error_ratio | Alias déprécié de sailops_gateway_5xx_ratio, sans les 4xx |
sailops_gateway_latency_avg_ms | Temps de réponse upstream moyen pondéré |
sailops_gateway_latency_sum_ms_per_sec, sailops_gateway_latency_count_per_sec | Débits de somme et de nombre d'échantillons |
sailops_gateway_requests_le_500ms_per_sec | Réponses upstream complètes en au plus 500 ms |
sailops_gateway_slow_requests_ratio | Réponses upstream complètes au-delà de 500 ms / nombre d'échantillons |
sailops_gateway_timeouts_per_sec | Débit de timeouts HTTP/gRPC |
sailops_gateway_connection_failures_per_sec | Tentatives de connexion échouées, séparées par route_kind |
sailops_gateway_tcp_connections_per_sec | Dé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.