> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# Observability dans Studio

Studio inclut les vues d’observabilité suivantes :

- **Metrics** pour les données de performances agrégées
- **Traces** pour l’inspection des requêtes individuelles
- **Logs** pour parcourir les journaux internes et ceux de l’application

Toutes exigent qu’un backend de stockage Observability soit configuré.

## Démarrage rapide

Pour des instructions détaillées, suivez les [instructions d’Observability](https://mastra.zisheng.pro/fr/docs/observability/overview). Pour démarrer rapidement, ajoutez le package `@mastra/observability` à votre projet et configurez-le avec [LibSQL](https://mastra.zisheng.pro/fr/reference/storage/libsql) et [DuckDB](https://mastra.zisheng.pro/fr/reference/vectors/duckdb) pour une configuration de développement local qui prend en charge à la fois les traces et les métriques.

**npm**:

```bash
npm install @mastra/observability @mastra/libsql @mastra/duckdb
```

**pnpm**:

```bash
pnpm add @mastra/observability @mastra/libsql @mastra/duckdb
```

**Yarn**:

```bash
yarn add @mastra/observability @mastra/libsql @mastra/duckdb
```

**Bun**:

```bash
bun add @mastra/observability @mastra/libsql @mastra/duckdb
```

Ajoutez ensuite ce qui suit à votre fichier `src/mastra/index.ts` :

```ts
import { Mastra } from '@mastra/core/mastra'
import { LibSQLStore } from '@mastra/libsql'
import { DuckDBStore } from '@mastra/duckdb'
import { MastraCompositeStore } from '@mastra/core/storage'
import {
  Observability,
  MastraStorageExporter,
  MastraPlatformExporter,
  SensitiveDataFilter,
} from '@mastra/observability'

export const mastra = new Mastra({
  storage: new MastraCompositeStore({
    id: 'composite-storage',
    default: new LibSQLStore({
      id: 'mastra-storage',
      url: 'file:./mastra.db',
    }),
    domains: {
      observability: await new DuckDBStore().getStore('observability'),
    },
  }),
  observability: new Observability({
    configs: {
      default: {
        serviceName: 'mastra',
        exporters: [
          new MastraStorageExporter(), // Persists observability events to Mastra Storage
          new MastraPlatformExporter(), // Sends observability events to Mastra platform (if MASTRA_PLATFORM_ACCESS_TOKEN is set)
        ],
        spanOutputProcessors: [
          new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys
        ],
      },
    },
  }),
})
```

## Plateforme Mastra

Pour des traces, journaux et métriques hébergés dans vos projets et déploiements, consultez [Observability sur la plateforme Mastra](https://mastra.zisheng.pro/fr/docs/mastra-platform/observability).

## Metrics

Un tableau de bord qui récapitule les performances des agents, workflows et tools sur une plage temporelle configurable, des dernières 24 heures à 30 jours. La première ligne présente le nombre total d’exécutions d’agents, le coût des modèles, la consommation de tokens et la performance moyenne des scorers. En dessous, des cartes détaillées ventilent l’utilisation et le coût par modèle, l’utilisation de tokens par agent, l’utilisation de tokens au fil du temps avec estimation du coût, le volume de traces avec les nombres de réussites et d’erreurs, les percentiles de latence (p50 et p95) et les tendances des scorers.

Consultez la [vue d’ensemble des métriques](https://mastra.zisheng.pro/fr/docs/observability/metrics/overview) pour plus de détails.

> **Remarque:** Les métriques requièrent un stockage OLAP distinct pour Observability. Les bases de données relationnelles telles que PostgreSQL et LibSQL ne prennent pas en charge les métriques. Le stockage en mémoire est réinitialisé au redémarrage.

## Traces

Lorsque vous exécutez un agent ou un workflow, l’onglet Observability affiche des traces qui mettent en évidence les principales opérations d’IA, comme les appels de modèle, les exécutions de tools et les étapes de workflow. Suivez ces traces pour voir comment les données circulent, où le temps est passé et ce qui se produit en interne.

Au-dessus de la liste des traces, ouvrez **Columns** pour afficher ou masquer les colonnes d’entrée, d’entité, de durée, de token d’entrée, de token de sortie, de coût estimé et de métadonnées personnalisées. Pour afficher des métadonnées personnalisées, ajoutez la clé de niveau supérieur utilisée dans `tracingOptions.metadata`. Studio enregistre la sélection dans le stockage du navigateur pour le serveur Mastra et le préfixe d’API actuels.

Les colonnes de tokens et de coût estimé nécessitent un stockage Observability qui prend en charge les métriques. Elles restent masquées dans la vue **Branches**, car plusieurs lignes de branche peuvent appartenir à la même trace.

Tracing filtre les détails du framework de bas niveau afin que vos traces restent ciblées et lisibles. Consultez la [vue d’ensemble du tracing](https://mastra.zisheng.pro/fr/docs/observability/tracing/overview) pour plus de détails.

Pour exporter une trace, sélectionnez **Download trace JSON** dans l’en-tête du panneau de trace. La trace entière est enregistrée dans un fichier `trace-<id>.json`, avec chaque span et ses entrées, sorties, métadonnées et attributs complets. Utilisez-le pour partager une trace, la joindre à un rapport de bug ou, alternativement, créer un jeu de données d’évaluation hors ligne.

## Logs

Parcourez les journaux internes Mastra transmis à votre stockage Observability. Les journaux fournissent une recherche en texte intégral, couvrant le contenu des messages, les noms d’entités et les ID de trace, des préréglages de dates, des dernières 24 heures à 30 jours, ainsi que des filtres à sélection multiple pour le niveau, le type d’entité et le nom de l’entité. Sélectionner un journal ouvre un panneau de détails qui affiche le message complet, les données structurées et les métadonnées. Si le journal est corrélé à une trace, vous pouvez accéder directement à la chronologie de la trace et des spans.

La transmission des journaux est activée par défaut lorsque vous configurez Observability. Consultez [logging](https://mastra.zisheng.pro/fr/docs/observability/logging) pour la configuration des niveaux, des exemples de requêtes et les détails de personnalisation.

## Pages connexes

- [Vue d’ensemble d’Observability](https://mastra.zisheng.pro/fr/docs/observability/overview)
- [Vue d’ensemble des métriques](https://mastra.zisheng.pro/fr/docs/observability/metrics/overview)
- [Vue d’ensemble du tracing](https://mastra.zisheng.pro/fr/docs/observability/tracing/overview)
- [Logging](https://mastra.zisheng.pro/fr/docs/observability/logging)
- [Observability de la plateforme Mastra](https://mastra.zisheng.pro/fr/docs/mastra-platform/observability)