Métriques
Métriques complètes pour toutes vos ressources.
Vue d'Ensemble
SailOps collecte et affiche les métriques pour :
- Conteneurs - CPU, mémoire, réseau, stockage
- Bases de données - Connexions, requêtes, stockage
- Cache - Mémoire, opérations, taux de hits
- Gateways - Requêtes, latence, erreurs
Voir les Métriques
Métriques par Ressource
- Naviguez vers une ressource (Conteneur, Base de données, etc.)
- Cliquez sur l'onglet Métriques
- Sélectionnez la période
- Consultez les graphiques et données
Métriques du Tableau de Bord
Le tableau de bord affiche une vue d'ensemble :
- Utilisation des ressources de tous les conteneurs
- Nombre de connexions des bases de données
- Taux de hits du cache
Périodes
La collecte a lieu toutes les 15 s. Le trafic des gateways, routes et sites utilise des intervalles complets fixes : le plus petit pas parmi 30, 60, 120, 300, 600, 900, 1800, 3600, 7200, 10800, 21600 et 43200 secondes qui limite la plage demandée à 100 points. Les autres graphiques de ressources utilisent plage/100, avec un minimum de 30 s.
| Plage demandée | Intervalle du trafic |
|---|---|
| 15 minutes | 30 s |
| 1 heure | 1 min |
| 3 heures | 2 min |
| 6 heures | 5 min |
| 12 heures | 10 min |
| 24 heures | 15 min |
| 7 jours | 2 h |
| 30 jours | 12 h |
Les horodatages du trafic indiquent le début des intervalles. L'intervalle en cours est omis : la série finit au dernier intervalle complet précédant la fin demandée ou maintenant moins 30 s, selon la borne la plus ancienne.
Les périodes proposées dans la barre d'outils dépendent du plan de support de votre organisation. Chaque plan définit une durée maximale de rétention des métriques — seules les périodes dans cette limite sont proposées. Les plages personnalisées sont également validées par rapport à cette limite.
Certains types de ressources ont des limites intégrées plus courtes, quel que soit votre plan. Par exemple, les métriques moteur des bases de données, du cache, de NATS et des gateways sont disponibles sur 30 jours maximum, et les métriques d'observabilité au niveau de l'organisation sur 24 heures maximum. Un message sous la barre d'outils indique quand une plage a été tronquée.
Métriques des Conteneurs
Utilisation CPU
Mesure l'utilisation du processeur :
Utilisation CPU (%) = (Temps CPU utilisé / Temps CPU alloué) × 100
| Niveau | Signification |
|---|---|
| 0-60% | Fonctionnement normal |
| 60-80% | Envisager le scaling |
| 80-100% | Critique, scaler immédiatement |
Utilisation Mémoire
Mesure l'utilisation de la RAM :
Utilisation Mémoire = Mémoire Working Set / Limite Mémoire
| Niveau | Signification |
|---|---|
| 0-70% | Sain |
| 70-85% | Surveiller de près |
| 85-100% | Risque d'OOM |
I/O Réseau
Mesure le transfert de données :
- Octets Reçus - Données entrantes
- Octets Transmis - Données sortantes
- Paquets - Comptage des paquets réseau
I/O Stockage
Mesure les opérations disque :
- Octets Lus - Données lues depuis le disque
- Octets Écrits - Données écrites sur le disque
- IOPS - Opérations I/O par seconde
Métriques Spécifiques Conteneur
| Métrique | Description |
|---|---|
| Redémarrages | Nombre de redémarrages du conteneur |
| Uptime | Temps depuis le dernier redémarrage |
| Réplicas | Instances en cours vs. désirées |
Métriques Base de Données
Métriques de Connexion
| Métrique | Description |
|---|---|
| Connexions Actives | Clients actuellement connectés |
| Connexions Inactives | Connexions inactives |
| Max Connexions | Limite de connexions |
| Attente Connexion | Temps d'attente pour les connexions |
Métriques de Requêtes
| Métrique | Description |
|---|---|
| Requêtes/seconde | Débit de requêtes |
| Latence des Requêtes | Temps de requête moyen |
| Requêtes Lentes | Requêtes dépassant le seuil |
| Transactions | Nombre de transactions |
Métriques de Stockage
| Métrique | Description |
|---|---|
| Taille Base de Données | Taille totale des données |
| Taille des Tables | Stockage par table |
| Taille des Index | Stockage des index |
| Taille WAL | Taille du Write-Ahead Log |
Métriques de Réplication (HA)
| Métrique | Description |
|---|---|
| Retard de Réplication | Octets en retard sur le primaire |
| Statut Standby | État du réplica |
| Position WAL | Position actuelle du log |
Métriques du Cache
Métriques Mémoire
| Métrique | Description |
|---|---|
| Mémoire Utilisée | Utilisation mémoire actuelle |
| Mémoire Peak | Mémoire maximale utilisée |
| Fragmentation Mémoire | Fragmentation interne |
| Clés Évincées | Clés supprimées pour mémoire |
Métriques d'Opérations
| Métrique | Description |
|---|---|
| Commandes/seconde | Débit d'opérations |
| Taux de Hits | Pourcentage de hits cache |
| Misses | Nombre de cache miss |
| Keyspace | Nombre total de clés |
Métriques de Connexion
| Métrique | Description |
|---|---|
| Clients Connectés | Connexions actuelles |
| Clients Bloqués | Clients en opérations bloquantes |
| Connexions Refusées | Connexions refusées |
Métriques de Gateway
Où consulter le trafic
- Vue d'ensemble d'une gateway : graphiques compacts ; Observabilité : toutes les routes ou une route HTTP, gRPC, TCP ou TLS.
- Vue d'ensemble d'un conteneur : routes associées, requêtes/s sur les 5 dernières minutes et p99 du temps de réponse upstream du dernier intervalle complet. Les routes partagées portent la mention
Partagée avec {N} services · chiffres de la route entièreet sont exclues de l'agrégat du conteneur. Observabilité présente le trafic par route. - Vue d'ensemble et Observabilité d'un site : somme des HTTPRoutes Quick Expose et de domaine personnalisé sur les gateways. Les réponses du cache CDN et les routes créées hors SailOps ne sont pas attribuées.
- Grafana managé : Gateways & Traffic.
Définitions du trafic
| Métrique | Définition |
|---|---|
| Débit de requêtes | Requêtes HTTP et gRPC de chaque intervalle divisées par sa durée, en req/s. Les connexions TCP/TLS restent séparées. |
| Requêtes sur la plage | Requêtes HTTP et gRPC des intervalles observés. Les intervalles avec remise à zéro ou interruption de collecte sont exclus. Les connexions TCP/TLS sont comptées séparément. |
| Taux de succès | (total − 4xx − 5xx) / total. Les 1xx, dont les upgrades WebSocket 101, redirections et 304 sont des succès. Les erreurs gRPC portées par grpc-status avec HTTP 200 restent des succès HTTP. |
| Taux d'erreur (4xx + 5xx) | (4xx + 5xx) / requêtes HTTP et gRPC. Le panneau Grafana des erreurs 5xx sur la plage utilise sailops_gateway_5xx_ratio, qui compte seulement les 5xx et peut être inférieur. |
| Erreurs | Comptages par intervalle affiché. Un timeout avant les en-têtes compte aussi comme 504 ; après les en-têtes, il conserve le statut. Timeouts et échecs de connexion recoupent les classes de statut et ne sont pas ajoutés au taux d'erreur. |
| Requêtes sans réponse upstream complète | Somme des requêtes moins le nombre d'échantillons de temps de réponse sur la plage, hors intervalles non observés. Inclut les timeouts après en-têtes, resets client et upgrades WebSocket. |
| Requêtes HTTP de la gateway | Requêtes reçues, réponses envoyées et réponses 4xx/5xx sur les listeners de la gateway. Inclut les réponses transmises et celles générées par la gateway. Disponible même sans compteurs de routes, y compris pour une gateway sans route. |
| Réponses de la gateway | Requêtes traitées directement par Envoy : aucune route (404), aucun backend disponible (503), refus de policy (401/403/429), redirections. Non attribuées à une route. Les tentatives upstream réessayées peuvent en masquer une partie. |
| Requêtes fermées avant une réponse | Requêtes du listener moins réponses, sommées sur la plage puis ramenées à zéro si négatives. Agrégat de gateway uniquement ; les abandons client par route ne sont pas mesurés. |
| Connexions TCP/TLS | Connexions ouvertes via TCPRoute et TLSRoute, avec échecs de connexion séparés. Exclues des totaux et ratios HTTP. |
Les compteurs des routes décrivent le trafic transmis à un backend. Une route sans endpoint backend peut donc n'afficher aucun trafic routé. Requêtes HTTP de la gateway affiche alors le trafic observé des listeners, y compris les réponses 404 ou 503. Réponses de la gateway exige des observations de routes et de listeners ; cette attribution reste indisponible si les compteurs des routes manquent. L'état Aucun backend disponible existe au niveau de l'agrégat de gateway lorsque cette attribution montre ses propres 5xx positifs ; il ne vérifie pas le statut backend de chaque route. Les chiffres des listeners couvrent tout le listener, y compris les routes de namespaces système. La gateway partagée n'expose pas ses totaux de listener à un projet individuel. Les différences listener−upstream sont signées par intervalle : sommer sur la plage avant de ramener à zéro les valeurs négatives, car chaque tentative upstream est comptée lors des retries.
Aucun trafic signifie un intervalle observé sans requête HTTP ; Aucun trafic HTTP indique du TCP/TLS seul. Aucune donnée de trafic signifie que les données sont indisponibles. Les intervalles manquants restent des trous ; l'absence de trafic ne donne ni ratio de succès/erreur ni temps de réponse.
Temps de réponse upstream
Temps entre la réception complète de la requête par la gateway et la fin de la réponse upstream. Exclut les requêtes sans réponse complète : timeouts après en-têtes, resets client et upgrades WebSocket. Mesuré en millisecondes entières.
Il inclut l'attente du pool de connexions upstream, la connexion, les retries, le traitement backend et le transfert de la réponse vers la gateway. Il exclut TLS côté client, envoi de la requête, filtres avant le routeur et hits du cache CDN. La quantification en millisecondes peut sous-estimer les moyennes inférieures à environ 10 ms de jusqu'à 0,5 ms.
Un flux terminé proprement par le backend (SSE, gRPC server-streaming, gros téléchargement) compte une fois pour toute sa durée, dans l'intervalle où il se termine. Un flux interrompu par le timeout ou le client ne compte aucun échantillon. Configurer un timeout de requête adapté, ou 0s pour un flux illimité. Un upgrade WebSocket compte une fois comme succès 101, sans échantillon de temps de réponse upstream.
Les histogrammes sont vidés toutes les 5 s : un échantillon peut arriver dans l'intervalle suivant. Comparer les réponses incomplètes sur une plage. Les percentiles sont interpolés linéairement dans les buckets comme Prometheus histogram_quantile. Ceux qui dépassent la plus grande borne sont affichés comme des bornes inférieures (> X ms).
Visualisation des Métriques
Types de Graphiques
Graphiques Linéaires
- Montrent les tendances dans le temps
- Comparent plusieurs métriques
- Identifient les patterns
Graphiques en Aires
- Montrent les valeurs cumulées
- Empilent plusieurs séries
- Visualisent les totaux
Graphiques à Barres
- Comparent des valeurs discrètes
- Montrent les distributions
- Mettent en évidence les pics
Interactions avec les Graphiques
- Survol - Voir les valeurs exactes
- Zoom - Focus sur une période
- Défilement - Naviguer dans le temps
- Légende - Basculer les séries
Alertes et métriques
Consulter les alertes et les règles Grafana. Configurer le traitement des données absentes.
Accéder aux Métriques
Via le Tableau de Bord
Toutes les métriques sont disponibles via le tableau de bord SailOps :
- Naviguez vers n'importe quelle ressource
- Cliquez sur l'onglet Métriques
- Sélectionnez la période
- Consultez les graphiques et données en temps réel
Rétention des Métriques
La profondeur d'historique des métriques dépend du plan de support de votre organisation :
| Plan | Rétention Maximale |
|---|---|
| Basic | 7 jours |
| Starter | 30 jours |
| Business | 90 jours |
| Custom | 365 jours |
Les échantillons sont agrégés à la lecture, sans réduction préalable de résolution. Le trafic des gateways, routes et sites est limité à 30 jours et à la limite du plan.
Bonnes Pratiques
1. Créer des Tableaux de Bord
Créez des vues personnalisées pour :
- Santé de la production
- Métriques de développement
- Optimisation des coûts
2. Établir des Baselines
Connaissez ce qui est normal :
- Enregistrez les valeurs de référence
- Comprenez les patterns quotidiens
- Documentez les plages attendues
3. Définir des Alertes Pertinentes
Alertez sur des conditions actionnables :
- Évitez la fatigue d'alerte
- Définissez des seuils appropriés
- Incluez du contexte
4. Réviser Régulièrement
Revues hebdomadaires des métriques :
- Identifiez les tendances
- Repérez les anomalies tôt
- Planifiez la capacité
Dépannage
Métriques Non Affichées
- Vérifiez que la ressource est en cours d'exécution
- Vérifiez la sélection de période
- Attendez la collecte des données (1-2 minutes)
- Rafraîchissez la page
Métriques Incorrectes
- Vérifiez les paramètres de fuseau horaire
- Vérifiez le calcul de la métrique
- Comparez avec le statut de la ressource
- Contactez le support si nécessaire
Données Historiques Manquantes
- Vérifiez la politique de rétention
- Vérifiez que la période existe