Connectez Grok Bot à Observagent.
Grok Bot est le produit de coéquipiers IA persistants de xAI, avec des applications de bureau et mobiles devant des Bots qui s'exécutent sur un ordinateur cloud avec navigateur, système de fichiers et terminal. Ses contrôles Enterprise, dont l'export OpenTelemetry, se trouvent dans le tableau de bord Cursor.
Grok Bot emprunte l'export OpenTelemetry Enterprise de Cursor
Grok Bot se présente sous forme d'applications de bureau (macOS, Windows, Linux) et mobiles, mais chaque Bot s'exécute sur un ordinateur cloud partagé et persistant, pas sur votre appareil. Consultez la section Offre requise ci-dessous pour les abonnements actuels donnant accès à Grok Bot. Ses contrôles d'administration de niveau Enterprise, notamment les journaux d'audit, la politique réseau, l'enregistrement des actions et l'export OpenTelemetry, se configurent depuis la page Grok Bot du tableau de bord Cursor.
Il n'existe pas de point de terminaison de télémétrie hébergé par xAI distinct pour Grok Bot. Lorsqu'un espace de travail Cursor Enterprise active l'export OpenTelemetry, ce flux transporte déjà l'activité de Grok Bot, marquée cursor.surface=grok_bot, aux côtés de l'usage normal de l'IDE Cursor. Si vous avez déjà suivi le guide d'intégration Cursor pour le même espace, activez aussi Action Recording pour recevoir les événements d’action Grok Bot dans ce projet.
- L’accès à Grok Bot et l’accès à l’export sont distincts ; Action Recording et OpenTelemetry Export nécessitent Enterprise.
- Cursor envoie uniquement via OTLP/HTTP protobuf binaire ; les encodages gRPC et JSON ne sont pas pris en charge.
- L'export est un paramètre au niveau de l'équipe configuré une fois par un administrateur, pas une bascule par Bot ou par appareil. L'enregistrement des actions doit aussi être activé pour les événements d'action de Grok Bot et il est désactivé par défaut.
- Contrairement à la plupart des autres intégrations de cette documentation, cet export peut inclure en option le texte brut des invites utilisateur et des réponses de l'assistant ; il s'agit d'un opt-in distinct, pas du comportement par défaut.
Offre minimum requise
Cursor Enterprise avec accès à Grok Bot.
- Un administrateur doit activer Action Recording et OpenTelemetry Export. L’accès au Bot avec un abonnement individuel ou d’équipe en libre-service n’inclut pas ces contrôles Enterprise.
- Grok Bot est inclus dans The X Subscription Premium, Super et Ultra. L’accès Enterprise et les contrôles doivent être activés pour votre organisation.
Conditions examinées le .
Étapes d'intégration
Sélectionnez une plateforme pour voir les commandes et chemins propres à votre ordinateur. La configuration du projet et la vérification de la livraison sont communes à toutes les plateformes.
- Étape 1
Confirmer que Grok Bot et l'export OpenTelemetry sont activés
Grok Bot lui-même est inclus dans les offres Cursor Pro, Pro+, Ultra et Teams, mais l'enregistrement des actions et l'export OpenTelemetry sont réservés à l'offre Enterprise. Dans le tableau de bord Grok Bot, activez l'enregistrement des actions pour les événements d'action des Bots, puis confirmez que l'export OpenTelemetry est disponible.
- Les journaux d'audit du plan de contrôle de Grok Bot (création de Bot, changements d'accès, routines) sont une fonctionnalité Enterprise distincte qui se diffuse vers un SIEM, pas vers ce flux OTLP.
- L'enregistrement des actions est désactivé par défaut et doit être activé pour que les événements d'action de Grok Bot passent par l'export OpenTelemetry.
- Étape 2
Créer un projet et une clé de projet
Dans Observagent, activez Journaux et Métriques sur un projet, activez la surveillance et générez une clé de projet avec la permission telemetry:write.
- Utilisez une clé distincte pour cette connexion afin que Observagent puisse attribuer le flux de manière fiable.
- Cet export n’inclut pas les traces ; laissez ce signal de projet inchangé pour cette connexion.
- Étape 3
Diriger l'export OpenTelemetry de Cursor vers Observagent
C'est le même bouton Team Settings → OpenTelemetry Export utilisé pour la télémétrie normale de l'IDE Cursor ; il n'existe pas de point de terminaison distinct pour Grok Bot. Saisissez le point de terminaison du collecteur, le protocole OTLP/HTTP protobuf binaire, et l'en-tête bearer, et confirmez que le point de terminaison répond avant d'enregistrer.
- Une réponse 200 ou 204 confirme que le point de terminaison est accessible avant d’enregistrer la configuration dans Cursor.
- Cursor envoie uniquement en OTLP/HTTP protobuf binaire ; les encodages gRPC et JSON ne sont pas pris en charge.
- L'export OpenTelemetry peut inclure en option le texte des invites utilisateur et des réponses de l'assistant ; laissez cette option désactivée sauf besoin spécifique.
PowerShell(Invoke-WebRequest https://dashboard.observagent.cloud/v1/metrics -Method Head).StatusCode - Étape 4
Autoriser votre point de terminaison et vérifier la livraison
Ajoutez les IP de sortie publiées de Cursor à votre liste blanche si nécessaire, exécutez une tâche Grok Bot jusqu'à son terme, puis vérifiez dans Observagent les événements marqués cursor.surface=grok_bot au milieu de votre trafic Cursor habituel.
- Cursor effectue des sorties depuis un ensemble fixe d’IP publiées dans sa documentation entreprise.
- Filtrez ou recherchez cursor.surface=grok_bot pour isoler l’activité Grok Bot d’un usage IDE normal dans le même flux.
Diagnostiquer les échecs d'export
- Rien n'arrive : confirmez que l'espace de travail est sur l'offre Enterprise et que l'enregistrement des actions ainsi que l'export OpenTelemetry sont activés, pas seulement configurés. L'accès à Grok Bot seul (Pro/Teams) n'inclut pas ces contrôles.
- Les événements Cursor IDE arrivent mais pas ceux de Grok Bot : confirmez qu'un Bot a réellement terminé une exécution ; ouvrir l'application de bureau ou mobile seule ne génère pas d'activité.
- Erreurs de connexion ou de délai : le point de terminaison n'est pas accessible publiquement, ou les IP de sortie publiées de Cursor ne sont pas autorisées de votre côté.
- 401/403 d'Observagent : la clé bearer est manquante, malformée, révoquée, ou manque de
telemetry:write. - Mauvais type de contenu rejeté : Cursor envoie uniquement en OTLP/HTTP protobuf binaire. Confirmez que votre chemin de collecteur accepte le protobuf, pas le JSON, sur
/v1/metricset/v1/logs. - Les traces n'apparaissent jamais : ce chemin d'export n'inclut pas les traces ; c'est attendu.
- Besoin de détail d'audit au niveau du Bot : la création de Bot, les changements d'accès et les routines sont couverts par les journaux d'audit Enterprise distincts de Grok Bot, qui se diffusent vers un SIEM, pas vers ce flux OTLP.
Vérifier ce que le flux inclut
Par défaut, traitez cet export comme des métriques et journaux opérationnels, notamment les requêtes, erreurs et événements de cycle de vie des Bots, pas comme un flux de transcription. L'export OpenTelemetry de Cursor dispose d'un opt-in distinct qui peut en plus inclure le texte des invites utilisateur et des réponses de l'assistant ; laissez-le désactivé sauf besoin spécifique de ce contenu, et gardez à l'esprit que les Bots lisent et écrivent des fichiers et agissent dans des applications connectées, si bien qu'une transcription complète peut contenir plus qu'un simple message de discussion. Le détail au niveau des champs peut changer entre les versions de Cursor et de Grok Bot, donc consultez la documentation actuelle de Cursor et de xAI avant de connecter un espace de travail avec des dépôts ou identifiants sensibles. Observagent applique ses propres contrôles de contenu côté serveur comme limite supplémentaire.