ff-oce-kusto

Par microsoft · fluidframework

Utilisez cette skill pour toute requête Kusto ou investigation de télémétrie spécifiquement liée à Fluid Framework ou à ses partenaires. Les déclencheurs incluent : l'écriture ou l'exécution d'une requête Kusto contre la base de données Office Fluid, l'investigation de la télémétrie Fluid Framework ou des taux d'erreurs, l'interrogation des tables `Office_Fluid_FluidRuntime_*`, la recherche d'une session Fluid par `Session_Id` ou `docId`, l'investigation d'une erreur liée à Fluid dans la télémétrie Loop ou Whiteboard, la surveillance d'un bump FF ou d'un déploiement en anneau partenaire, la vérification de la fiabilité du rendu Fluid ou des erreurs Scriptor, ou lorsque l'utilisateur mentionne des tables spécifiques à Fluid (`Office_Fluid_FluidRuntime_*`, `OwhLoads`, `HostTracker`, `Scriptor`) ou des types d'erreurs spécifiques à Fluid (`dataCorruptionError`, `dataProcessingError`, `DeltaConnectionFailureToConnect`, `ICE`, `ACE`). Ne PAS déclencher pour des questions générales sur Kusto qui ne sont pas liées à Fluid Framework.

npx skills add https://github.com/microsoft/fluidframework --skill ff-oce-kusto

Référence Kusto Fluid Framework

Cette skill fournit une référence complète pour l'investigation de la télémétrie Fluid Framework dans Kusto. Chargez-la chaque fois qu'une requête Kusto doit être écrite, interprétée ou exécutée sur la base de données Office Fluid.

VPN requis. Le cluster Kusto Office Fluid (https://kusto.aria.microsoft.com) n'est accessible que sur le réseau interne Microsoft. Si une requête échoue à se connecter ou retourne des résultats inattendus, rappelez à l'utilisateur de vérifier que son VPN est activé avant de poursuivre le dépannage.

Cluster & Accès

  • Cluster: https://kusto.aria.microsoft.com
  • Base de données principale: Office Fluid
  • ID de base de données: 6a8929bcfc6d44e9b13fee392ada9cf0 (utilisez cet identifiant, pas le nom lisible, comme paramètre database dans kusto_query)
  • Base de données automation/stress test: Office Fluid Test
  • ID de base de données: 742fa5a288b045e5beab1a2b8e445a71 — contient les tables office_fluid_ffautomation_* utilisées pour la télémétrie stress test / pipeline. Ces tables ne se trouvent PAS dans la base de données principale "Office Fluid".
  • Rétention: ~28 jours
  • VPN: Requis (réseau interne Microsoft)
  • Condition d'accès: Appartenance au groupe M365HeartbeatTenantUsers

Orientation rapide

Les tables principales sont :

  • Office_Fluid_FluidRuntime_Error — tous les erreurs (premier arrêt)
  • Office_Fluid_FluidRuntime_Performance — événements de timing
  • Office_Fluid_FluidRuntime_Generic — tout le reste
  • union Office_Fluid_FluidRuntime_* — les trois à la fois
  • OwhLoads (fonction stockée) — dénominateur pour les requêtes de taux d'erreur ICE/ACE

Hiérarchie clé des ID de corrélation : Session_Id/Data_hostCorrelationId → Data_pageCorrelationId → Data_docId → Data_containerId

Champ de ring de déploiement clé : Loop_Audience (tables FluidRuntime), Release_AudienceGroup (tables OWH/QoS)

Utiliser la référence complète

Avant d'écrire toute requête Kusto non triviale, consultez le fichier de référence complet :

references/kusto-query-reference.md

Cette référence contient :

  • Partie 1 — Toutes les tables, champs, ID de corrélation, champs de version, fonctions stockées, schémas des bases de données partenaires (OneNote, OWA, Loop FFX, Video, Scriptor, HostTracker, automation)
  • Partie 2 — Query Cookbook avec ~20 sections de requêtes prêtes à l'emploi (recherche de session, timecharts d'erreurs, évaluation de breadth, corrélation de version, calculs de taux ICE, requêtes globales EU, changements de flight ODSP, etc.)
  • Partie 3 — Patterns du playbook d'investigation (incident partenaire entrant, triage dataCorruptionError, taux d'erreur ICE, notes importantes)
  • Partie 4 — Sections de requête supplémentaires : suivi des bumps FF (5 requêtes), fiabilité de rendu, erreurs Scriptor, télémétrie Video (10+ requêtes), reconnexions de container / WhyIsTheContainerStuck(), automation stress test (FindBuildErrors, DidSummarizerRecover, SummarizerView)

Points clés à retenir

  • Utilisez toujours des timestamps absolus dans les notes IcM (pas ago()) pour que les requêtes restent reproductibles
  • Filtrez toujours Data_stack !has '.goskope.com' et Data_channelFactoryType !has '.myshn.net' dans les requêtes de corruption pour exclure les reverse proxies connus
  • Le pattern hll() / dcount_hll(hll_merge(...)) est requis pour les comptes d'utilisateurs distincts conformes EU sur plusieurs clusters
  • Pour les données EU, utilisez macro-expand force_remote = true officefluid_global as X (...) | summarize ...
  • Loop_Audience (FluidRuntime) et Release_AudienceGroup (OWH/QoS) sont le même concept ; filtrez == "Production" pour exclure le bruit dogfood

Skills similaires

llm-obs-eval-bootstrap
datadog-labs / agent-skills

Générer une suite d'évaluateurs prêts à l'emploi à partir de traces LLM en production.

158
agent-observability-eval-bootstrap
datadog-labs / agent-skills

Analyser des traces LLM de production pour générer et publier une suite d'évaluateurs Datadog.

158
agent-observability-session-classify
datadog-labs / agent-skills

Classifier la satisfaction des sessions d'agents IA via Datadog LLM Observability.

158
agent-observability-auto-experiment
datadog-labs / agent-skills

Automatiser une boucle d'amélioration itérative locale de code via évaluations et commits git.

158
ff-oce-dashboard
microsoft / fluidframework

Générer un tableau de bord de statut de shift consolidé depuis plusieurs sources internes.

4 945