AIS Tracing
Traceur d'identifiants de corrélation pour Azure Cosmos DB
Suivez une seule valeur — un identifiant de corrélation, une référence de commande — à travers tous les containers d'un compte Azure Cosmos DB, et voyez jusqu'où elle est allée. Échantillonne vos containers, détermine quel champ relie les documents entre eux, puis dessine chaque étape sur une timeline. Les lignes vides comptent autant que les pleines : elles montrent où la donnée n'est pas arrivée.
Gratuit pour un usage personnel, éducatif et non lucratif. L'usage commercial — y compris un consultant indépendant en mission — requiert une licence. Chaque build est produit par la CI de release et servi depuis mayorana.ch.
Le build macOS est signé avec un Apple Developer ID et notarisé : il s'ouvre d'un double-clic normal.
Lire les notes de versionAIS Tracing face aux alternatives
Seuls les points forts de AIS Tracing sont listés. Les autres font beaucoup de choses qu'il ne fait pas — ce tableau dit pourquoi le choisir.
| Fonctionnalité | AIS Tracing | Cosmos DB Data Explorer | Cosmos DB in VS Code | Turbo360 BAM |
|---|---|---|---|---|
| Une valeur recherchée dans tous les conteneurs en une passe | Une requête par conteneur | Une requête par conteneur | Flux instrumentés uniquement | |
| Champ de liaison déduit des données, aucun schéma à décrire | Propriétés suivies à définir | |||
| Étapes dessinées sur une frise, dans l'ordre | Pour les étapes instrumentées | |||
| Conteneurs jamais atteints affichés comme couloirs vides | Pour les étapes instrumentées | |||
| Fonctionne sur vos données existantes, rien à instrumenter |
Comparaison faite en octobre 2026 à partir de la documentation publique de chaque produit. Une information dépassée ? Dites-le-nous
Skill Claude
Permet à Claude de vous aider avec AIS Tracing : son fonctionnement, les erreurs connues et leurs solutions, et un rapport de bug que vous relisez avant de l'envoyer vous-même.
Comment l'installer
- claude.ai ou l'application Claude : Customize → Skills → + → Create skill → Upload a skill, puis choisissez le .zip. L'option « Code execution and file creation » doit être activée dans Settings → Capabilities.
- Claude Code : décompressez-le dans ~/.claude/skills/, pour que le skill se trouve dans ~/.claude/skills/ais-tracing/.
Vue d'ensemble
Quelque chose n'est pas arrivé. Vous avez un identifiant de corrélation, une référence de commande ou un numéro client, et un compte Cosmos DB avec plus de containers que personne ne se rappelle. La question est simple — jusqu'où cette valeur est-elle allée ? — et y répondre demande d'ordinaire d'écrire une requête par container.
AIS Tracing y répond en une étape. L'app échantillonne vos containers, détermine seule quel champ relie les documents entre eux, puis suit votre valeur à travers tous et dessine chaque étape sur une timeline.
Les trous sont l'essentiel. Une étape sans document n'est pas un résultat vide à faire défiler : c'est la réponse, qui montre précisément le saut que la donnée n'a jamais atteint.
Ce que fait l'app
Détection automatique du champ de liaison
Échantillonne les containers et déduit quel champ relie les documents d'un même flux, sans que vous ayez à décrire votre schéma au préalable.
Recherche sur tout le compte
Une valeur, tous les containers du compte, en une seule passe — plutôt qu'une requête par container écrite à la main.
Vue timeline
Chaque étape touchée par la valeur, dans l'ordre réel, pour que la latence entre les sauts se voie au lieu d'être déduite de timestamps comparés manuellement.
Les trous comme résultats à part entière
Les containers où la valeur n'est jamais apparue sont dessinés comme des voies vides. L'endroit où la piste s'arrête est généralement toute la réponse.
Prérequis
- macOS sur Apple Silicon, Windows, ou Linux x86_64
- Azure CLI connecté (az login) — l'app n'a pas de login propre et réutilise votre session
- Un compte Azure Cosmos DB accessible en lecture, y compris l'autorisation distincte sur le plan de données Cosmos
- Des containers portant un champ de corrélation commun aux documents
Conçu avec
Rust · Dioxus · Azure Cosmos DB
Nouveautés
Version 0.1.30, publiée le 7 octobre 2026. AIS Tracing évolue souvent : chaque version et ce qu’elle a changé sont listés sur la page des notes de version.
Lire les notes de versionLicence
Source disponible sous PolyForm Noncommercial License 1.0.0 : gratuit pour l'usage personnel, l'apprentissage, la recherche et les projets de loisir, ainsi que pour les associations, écoles, universités et institutions publiques. Les entreprises qui l'utilisent pour leur activité prennent une licence.
Code source
Le code est public et lisible. Forkez-le et rebrandez-le — le nom et le logo sont des marques et ne sont pas couverts par la licence.
Voir sur GitHubQuestions
Dois-je lui décrire mon schéma ?
Non. L'app échantillonne les containers, déduit le champ de liaison depuis les données, propose une clé de corrélation, et vous collez une valeur à suivre.
Un scan échoue en 403 — qu'est-ce que ça veut dire ?
L'accès aux données Cosmos DB est une autorisation distincte du RBAC Azure habituel : un compte qui voit la base ne peut pas pour autant en lire le contenu. L'app propose un bouton pour vous attribuer le rôle Built-in Data Reader.
Écrit-il dans Cosmos DB ?
Non. L'accès à votre compte est en lecture seule.
Et si mes données sont dans Log Analytics plutôt que Cosmos DB ?
AIS Analytics est le même traceur, pointé vers un espace de travail Log Analytics.
Fonctionne-t-il sur un gros compte ?
Il échantillonne au lieu de tout scanner : le nombre de containers compte davantage que le volume total de documents. Les comptes très larges demandent plus de temps à la première passe.
Une question sur cet outil ?
Renseignez-vous sur une licence commerciale pour votre équipe, signalez un problème ou dites-nous ce qui manque. Nous lisons chaque message.
Nous contacter