Intégration d'agent · Windows · macOS · Linux

Connectez Devin à Observagent.

Exportez la télémétrie de session de l'agent Devin via OpenTelemetry, en utilisant soit les variables d'environnement OTLP standard, soit le bloc de configuration otel de Devin.

DevinÉvénements de session de l'agent
OTLP via HTTPSHTTP/protobuf
ObservagentJournaux + métriques
Comment ça marche

Utiliser l'export OpenTelemetry de Devin

Devin peut exporter les événements d'agent et métriques de chronométrage vers un collecteur OpenTelemetry, soit via les variables d'environnement standard OTEL_EXPORTER_OTLP_* que la plupart des SDK OpenTelemetry reconnaissent, soit via un bloc otel dans la propre configuration utilisateur de Devin. Observagent accepte les deux chemins via OTLP/HTTP.

  • Ceci couvre la propre télémétrie de session et d'étapes de Devin, pas l'API REST séparée ni les déclencheurs webhook Jira/Linear que Devin prend aussi en charge pour démarrer des sessions.
  • Devin est en développement actif ; les clés de configuration exactes et les champs d'événements disponibles peuvent changer entre les versions.
  • La télémétrie commence après configuration et un redémarrage ; les sessions existantes ne sont pas réintégrées.
Avant de commencer

Offre minimum requise

Non confirmée pour l’export OTLP externe.

  • Devin Free est l’offre minimum pour un usage limité du produit. Cela ne confirme pas l’accès à l’intégration OTLP externe décrite ici.
  • Nous n’avons pas vérifié l’offre minimum ni la prise en charge de cet export. Un compte Free, Pro ou Enterprise ne garantit pas un accès OTLP confirmé.
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

    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 Devin afin que Observagent puisse attribuer cette source de manière fiable.
  2. Étape 2

    Configurer l'exportateur OTLP

    Définissez les variables OTLP standard dans le shell qui lance Devin, ou utilisez le bloc otel équivalent dans le propre fichier de configuration de Devin si votre version installée en lit un.

    • Il s’agit des variables standard OTEL_EXPORTER_OTLP_* reconnues par la plupart des SDK OpenTelemetry.
    • Si votre version de Devin lit plutôt un bloc otel depuis son propre fichier de configuration, utilisez ces mêmes valeurs à cet endroit.
    PowerShell
    $env:OTEL_EXPORTER_OTLP_ENDPOINT = "https://dashboard.observagent.cloud"
    $env:OTEL_EXPORTER_OTLP_HEADERS = "Authorization=Bearer YOUR_PROJECT_KEY"
    $env:OTEL_EXPORTER_OTLP_PROTOCOL = "http/protobuf"
  3. Étape 3

    Redémarrer Devin et vérifier la livraison

    Redémarrez complètement la session Devin ou le processus CLI, exécutez une tâche qui atteint au moins un appel d'outil, puis vérifiez les journaux et métriques du projet dans Observagent.

    • Le redémarrage est nécessaire pour que Devin prenne en compte les nouvelles valeurs d’environnement ou de configuration.
    • La télémétrie démarre avec la nouvelle activité après configuration et ne réintègre pas les sessions précédentes.
Dépannage

Diagnostiquer les échecs de l'exportateur

  • Rien n'arrive : confirmez que les variables (ou le bloc de configuration) sont présentes dans le processus exact qui exécute Devin, et que la session a été redémarrée après le changement.
  • 401/403 d'Observagent : l'en-tête bearer est manquant, malformé, révoqué, ou manque de telemetry:write.
  • Configuration non reconnue : le schéma du bloc otel est représentatif ; vérifiez le changelog et la référence de configuration actuels de Devin pour les clés exactes attendues par votre version.
  • Seuls les événements de cycle de vie de session arrivent : confirmez que la tâche a bien atteint un appel d'outil ou une requête de modèle, pas seulement le démarrage de la session.
  • Les anciennes sessions sont manquantes : la télémétrie démarre avec la nouvelle activité après configuration et ne réintègre pas l'historique.
Confidentialité

Vérifier ce qui est exporté

Traitez l'export OpenTelemetry de Devin comme de la télémétrie opérationnelle de session et de chronométrage, pas un flux garanti sans invite. Consultez la documentation actuelle de Devin pour savoir exactement quels champs elle inclut avant d'activer ceci pour des sessions touchant des dépôts ou données sensibles. Observagent applique ses propres contrôles de contenu côté serveur comme limite supplémentaire.