SentryExporter

Envoie les données de Tracing à Sentry pour le traçage et la surveillance de l'IA au moyen des conventions sémantiques OpenTelemetry.

Constructeur

new SentryExporter(config: SentryExporterConfig)

SentryExporterConfig

interface SentryExporterConfig extends BaseExporterConfig {
  dsn?: string
  environment?: string
  tracesSampleRate?: number
  release?: string
  options?: Partial<Sentry.NodeOptions>
}

Étend BaseExporterConfig, qui comprend :

• logger?: IMastraLogger - Instance du Logger
• logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error' - Niveau de journalisation (par défaut : INFO)

Méthodes

exportTracingEvent

async exportTracingEvent(event: TracingEvent): Promise<void>

Exporte un événement de Tracing vers Sentry. Gère les événements SPAN_STARTED, SPAN_UPDATED et SPAN_ENDED.

flush

async flush(): Promise<void>

Force l'envoi à Sentry de tous les spans en attente sans arrêter l'Exporter. Attend jusqu'à 2 secondes l'envoi des données en attente. Cette méthode est utile dans les environnements sans serveur où vous devez vous assurer que les spans sont exportés avant la fin de l'environnement d'exécution.

shutdown

async shutdown(): Promise<void>

Termine tous les spans actifs, efface l'état interne et ferme la connexion Sentry. Attend jusqu'à 2 secondes l'envoi des données en attente.

Utilisation

Sans configuration (au moyen de variables d'environnement)

import { SentryExporter } from '@mastra/sentry'

// Reads from SENTRY_DSN, SENTRY_ENVIRONMENT, SENTRY_RELEASE
const exporter = new SentryExporter()

Configuration explicite

import { SentryExporter } from '@mastra/sentry'

const exporter = new SentryExporter({
  dsn: process.env.SENTRY_DSN,
  environment: 'production',
  tracesSampleRate: 1.0,
  release: '1.0.0',
})

Avec échantillonnage

const exporter = new SentryExporter({
  dsn: process.env.SENTRY_DSN,
  environment: 'production',
  tracesSampleRate: 0.1, // Send 10% of transactions to Sentry (recommended for high-load backends)
})

Avec des options Sentry personnalisées

const exporter = new SentryExporter({
  dsn: process.env.SENTRY_DSN,
  environment: 'production',
  options: {
    integrations: [
      // Custom Sentry integrations
    ],
    beforeSend: event => {
      // Custom event processing
      return event
    },
  },
})

Mappage des spans

Les types de spans Mastra sont associés aux opérations Sentry :

SpanType Mastra	Opération Sentry
AGENT_RUN	gen_ai.invoke_agent
MODEL_GENERATION	gen_ai.chat
MODEL_STEP	(ignoré)
MODEL_CHUNK	(ignoré)
TOOL_CALL	gen_ai.execute_tool
MCP_TOOL_CALL	gen_ai.execute_tool
PROVIDER_TOOL_CALL	gen_ai.execute_tool
WORKFLOW_RUN	workflow.run
WORKFLOW_STEP	workflow.step
WORKFLOW_CONDITIONAL	workflow.conditional
WORKFLOW_CONDITIONAL_EVAL	workflow.conditional
WORKFLOW_PARALLEL	workflow.parallel
WORKFLOW_LOOP	workflow.loop
WORKFLOW_SLEEP	workflow.sleep
WORKFLOW_WAIT_EVENT	workflow.wait
PROCESSOR_RUN	ai.processor
GENERIC	ai.span

Les spans MODEL_STEP et MODEL_CHUNK sont ignorés afin de simplifier la hiérarchie de la Trace. Leurs données sont agrégées dans les spans MODEL_GENERATION.

Variables d'environnement

L'Exporter lit sa configuration dans les variables d'environnement suivantes :

Variable	Description
SENTRY_DSN	Data Source Name : indique au SDK où envoyer les événements
SENTRY_ENVIRONMENT	Nom de l'environnement de déploiement
SENTRY_RELEASE	Version du code déployé

OpenTelemetry attributes

L'Exporter définit les attributs OpenTelemetry standard suivants :

Attributs communs (tous les spans) :

• sentry.origin : auto.ai.mastra (identifie les spans provenant de Mastra)
• ai.span.type : type de span Mastra
• gen_ai.conversation.id : identifiant du thread de conversation, défini à partir de metadata.threadId pour regrouper les spans dans la vue Conversations de Sentry

Spans MODEL_GENERATION :

• gen_ai.operation.name : chat
• gen_ai.system : Provider du modèle
• gen_ai.request.model : identifiant du modèle
• gen_ai.request.messages : messages ou prompts d'entrée (JSON)
• gen_ai.response.model : modèle de la réponse
• gen_ai.response.text : texte de sortie
• gen_ai.response.tool_calls : appels de Tool effectués pendant la génération (tableau JSON)
• gen_ai.usage.input_tokens : nombre de tokens d'entrée
• gen_ai.usage.output_tokens : nombre de tokens de sortie
• gen_ai.usage.total_tokens : nombre total de tokens
• gen_ai.request.stream : indicateur de streaming
• gen_ai.request.temperature : paramètre de température
• gen_ai.completion_start_time : heure du premier token

Spans TOOL_CALL :

• gen_ai.operation.name : execute_tool
• gen_ai.tool.name : identifiant du Tool
• gen_ai.tool.type : function
• gen_ai.tool.call.id : identifiant de l'appel de Tool
• gen_ai.tool.input : entrée du Tool
• gen_ai.tool.output : sortie du Tool
• tool.success : indicateur de réussite

Spans AGENT_RUN :

• gen_ai.operation.name : invoke_agent
• gen_ai.agent.name : identifiant de l'Agent
• gen_ai.pipeline.name : nom de l'Agent
• gen_ai.agent.instructions : instructions de l'Agent
• gen_ai.response.model : modèle de la génération enfant
• gen_ai.response.text : sortie de la génération enfant
• gen_ai.usage.* : utilisation des tokens de la génération enfant