Observabilité

Surveillez vos applications IA avec le tracing, le logging et les hooks personnalisés dans Orka AI.

Observabilité Native & LLMOps

Ne naviguez plus à vue. Orka JS offre une introspection profonde de chaque appel LLM, exécution d'outil et récupération RAG. Surveillez la latence, la consommation de tokens et les erreurs via des hooks simples et puissants.

observability: {
  logLevel: 'info',
  hooks: [{
    onTraceEnd: (trace) => {
      // Direct integration with Datadog/Sentry
      reportMetrics(trace.totalLatencyMs, trace.totalTokens);
    },
    onError: (err, ctx) => alertDevTeam(err)
  }],
}

Suivi des Tokens : Consommation détaillée par trace pour une gestion précise des coûts.

Profilage de Latence : Identifiez instantanément les goulots d'étranglement dans vos chaînes RAG.

Configuration

observability-config.ts

const orka = createOrka({
  llm: new OpenAIAdapter({ apiKey: '...' }),
  vectorDB: new MemoryVectorAdapter(),
  observability: {
    logLevel: 'info', // 'debug' | 'info' | 'warn' | 'error'
    hooks: [{
      onTraceStart: (trace) => {
        console.log(`🔍 Trace started: ${trace.name}`);
      },
      onTraceEnd: (trace) => {
        console.log(`✅ Done: ${trace.totalLatencyMs}ms, ${trace.totalTokens} tokens`);
      },
      onError: (error, context) => {
        console.error(`❌ Error: ${error.message}`, context);
        // Send to Sentry, Datadog, etc.
      },
    }],
  },
});

Niveaux de Log

Niveau	Description
debug	Opérations internes détaillées
info	Opérations normales (défaut)
warn	Problèmes potentiels
error	Échecs uniquement

Tracing Manuel

tracing.ts

// Start a trace
const trace = orka.tracer.startTrace('my-pipeline', {
  userId: 'user-123',
});
 
// Add events
orka.tracer.addEvent(trace.id, {
  type: 'custom',
  name: 'preprocessing',
  startTime: Date.now(),
  endTime: Date.now() + 50,
});
 
// End the trace
const completed = orka.tracer.endTrace(trace.id);
console.log(`Total: ${completed?.totalLatencyMs}ms`);

💡 Conseil Production

En production, définissez logLevel: 'warn' pour réduire le bruit, et utilisez les hooks pour le monitoring structuré avec Datadog, Sentry, ou des tableaux de bord personnalisés.