Observagent
Intégration d'éditeur · Windows · macOS · Linux

Connectez Cursor à Observagent.

Utilisez l'export OpenTelemetry Enterprise de Cursor pour diffuser les métriques et journaux d'usage de toute l'équipe directement vers Observagent.

Choisir le système Voir les données envoyées
CursorÉvénements d'usage de l'équipe
OTLP/HTTP protobufPoint de terminaison du collecteur
ObservagentJournaux + métriques
Comment ça marche

Utiliser l'export OpenTelemetry Enterprise de Cursor

Cursor for Enterprise peut envoyer les données d'usage de toute l'équipe vers un collecteur que vous exécutez, plutôt que seulement le tableau de bord intégré. Observagent accepte ce flux directement, donc aucun proxy local n'est requis.

  • Les métriques incluent les jetons, appels d'outils, et le coût estimé, agrégés pour l'équipe.
  • Les journaux incluent les requêtes API, erreurs, corrections, compétences, hooks, plugins, et événements de cycle de vie de l'agent cloud.
  • 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 développeur.
Avant de commencer

Offre minimum requise

Cursor Enterprise.

  • Un administrateur de l’espace doit configurer et activer OpenTelemetry Export dans Team Settings. Les offres individuelles et les offres d’équipe en libre-service ne fournissent pas cette fonction Enterprise.
Accès ObservagentPréparez un projet Observagent avec la surveillance et les signaux nécessaires activés, ainsi qu’une clé de projet valide avec la permission telemetry:write.

Conditions examinées le .

Choisir le système

É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.

WindowsPowerShell
  1. Étape 1

    Confirmer votre offre et votre accès administrateur

    L'export OpenTelemetry est disponible sur l'offre Cursor Enterprise et se configure dans Team Settings par un administrateur de l'espace de travail.

    • Si votre espace de travail est sur une offre inférieure, utilisez l'export CSV du tableau de bord ou l'API Admin/Analytics à la place de ce chemin OpenTelemetry.
  2. É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.
  3. Étape 3

    Configurer l’export OpenTelemetry dans Cursor

    Dans Cursor, ouvrez Team Settings → OpenTelemetry Export et saisissez le point de terminaison du collecteur, le protocole OTLP/HTTP en protobuf binaire, et l'en-tête bearer. 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.
    PowerShell
    (Invoke-WebRequest https://dashboard.observagent.cloud/v1/metrics -Method Head).StatusCode
  4. É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 le collecteur est derrière un pare-feu, générez une activité normale de l'équipe, puis vérifiez les journaux et métriques du projet dans Observagent.

    • Cursor effectue des sorties depuis un ensemble fixe d’IP publiées dans sa documentation entreprise.
    • Vérifiez les journaux et métriques indépendamment ; l'arrivée d'un signal ne prouve pas que l'autre est arrivé.
Dépannage

Diagnostiquer les échecs d'export

  • Rien n'arrive : confirmez que l'espace de travail est sur l'offre Enterprise et que l'export OpenTelemetry est activé, pas seulement configuré.
  • 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/metrics et /v1/logs.
  • Les traces n'apparaissent jamais : ce chemin d'export n'inclut pas les traces ; c'est attendu.
  • Besoin de détail par développeur : combinez ce flux avec l'export CSV du tableau de bord ou l'API Admin/Analytics, qui peut couvrir des données que ce flux ne couvre pas.
Confidentialité

Vérifier ce que le flux inclut

L'export documenté couvre les métriques d'usage et les journaux opérationnels tels que requêtes, erreurs, corrections, et événements de cycle de vie, pas un flux de transcription à usage général. Le détail au niveau des champs peut changer entre les versions de Cursor, donc consultez la documentation OpenTelemetry entreprise actuelle de Cursor avant de connecter un espace de travail avec des dépôts sensibles. Observagent applique ses propres contrôles de contenu côté serveur comme limite supplémentaire.