04 / OBSERVABILITÉ

Ce qui répond.
Ce qui s’indexe.

Observer les requêtes et les collecteurs, repérer un retard et distinguer un refus d’une panne. Les chiffres proviennent du service en cours d’exécution.

Connexion…

Chargement des mesures…

Actualisation toutes les 15 secondes.

Requêtes

Fenêtre de 15 min · temps serveur, hors réseau du visiteur

Appels terminés

—

HTTP et fonctions MCP validées

Latence p95

—

Appels réussis uniquement

Erreurs techniques

—

Pannes et délais dépassés

Refus de capacité / validation

—

Comptés séparément des pannes

Débit observé

—

Appels terminés par seconde

En cours

—

À cet instant, tous parcours

Les métriques de requêtes démarrent avec le processus API.

Trafic par minute

Appels terminés

Réussites et documents absentsRefusErreurs techniques

Comparer les parcours

Latences en ms

Opération / accès	Moteur / profil	Appels	p50	p95	p99	Erreurs

Les percentiles portent sur les réussites du parcours, y compris la préparation et la construction de la réponse. SPARQL inclut le démarrage du processus et le chargement du graphe.

Derniers appels mesurés

30 derniers · aucun texte de requête conservé

Heure	Parcours	Résultat	Serveur	Appel moteur	Identifiant de diagnostic

Comment lire ces mesures ?

Le temps « appel moteur » mesure l’aller-retour HTTP vers Vespa ou le processus SPARQL complet. Il ne mesure pas le CPU interne du moteur. Les identifiants générés par le serveur sont renvoyés dans l’en-tête HTTP X-Request-ID ; ils ne constituent pas des traces distribuées.

Les routes de santé, les prévisualisations, le tableau de bord et les visites du site sont exclus. Un refus de validation MCP avant l’entrée dans la fonction n’est pas compté. Les erreurs d’un outil MCP sont instrumentées dans la fonction, même si son enveloppe HTTP répond 200.

Indexation

États persistants SQLite · historique échantillonné toutes les 15 s

Wikipédia FR · flux continu

Inconnu

Pages actives suivies

—

Pages en attente

—

Plus ancienne attente

—

Écritures / min

—

Délai de file p95

—

Erreurs cumulées

—

Définition du retard

Le délai est mesuré entre la première mise en file du titre et la dernière synchronisation acquittée. Le p95 porte sur le dernier passage de chaque page synchronisée dans les 15 dernières minutes, et non sur tous les événements. Une vérification sans modification du contenu peut aussi alimenter cette mesure.

Ce délai ne mesure pas le temps depuis la modification sur Wikipédia et ne garantit pas la fraîcheur globale. Les pages actives proviennent du registre du collecteur ; aucun recomptage Vespa n’est effectué par cette page.

Acquittements d’indexation

Écritures / min

Wikipédia FRSources structurées

Deux échantillons sont nécessaires pour calculer un débit.

Une activité nulle peut être normale : les sources structurées sont relues chaque jour et seules certaines modifications Wikipédia concernent les pages suivies. Le débit n’est pas une mesure de capacité maximale.

Sources structurées · collectes quotidiennes

Inconnu

Source	État	Dernier lot	Âge de la collecte réussie	Lot en reprise	Prochain essai	Dernière durée	Erreurs cumulées

L’âge mesure le temps depuis la collecte complète réussie, pas depuis la mise à jour des données chez le fournisseur. Un lot en reprise est rejoué intégralement ; sa taille n’est pas le nombre de documents restant à écrire. Une clé absente est un prérequis manquant, pas une panne de l’API.

Périmètre et limites

Aucune IP, identité de visiteur, clé API, texte de recherche ou contenu de document n’est enregistré par ces mesures. Les analytics de fréquentation restent dans leur tableau de bord privé.

Rétention, redémarrages et export

Requêtes : fenêtre de 15 minutes, au maximum 5 000 appels conservés en mémoire. Les percentiles utilisent le rang supérieur, sans interpolation. Une fenêtre tronquée est signalée.
Historique d’indexation : au maximum 61 instantanés, soit environ 15 minutes. Un redémarrage de l’API efface cet historique et les mesures des requêtes.
Les compteurs des collecteurs sont persistants. Les écritures structurées sont des tentatives acquittées depuis l’activation des mesures, y compris les répétitions après reprise ; un crash peut empêcher l’enregistrement du dernier acquittement.
Le tableau de bord reste disponible en cas d’erreur du moteur : il lit les mesures et les registres, sans lancer de recherche. En cas d’échec d’actualisation, les derniers chiffres restent affichés et sont signalés comme périmés.
Les mesures décrivent un seul processus API. Elles ne couvrent pas la mémoire, le CPU ou les files internes de Vespa et n’apportent aucune garantie de disponibilité.

Export : instantané JSON et compteurs Prometheus. Le service ne contient pas de stockage Prometheus ni de système d’alertes externes.

Ce qui répond.Ce qui s’indexe.