> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulter l’utilisation des sandboxes

> Suivez la facturation des sandboxes, l’activité des clients et les métriques de ressources de la flotte.

L’utilisation des sandboxes sans serveur figure dans la Console Forge, aux côtés des autres produits facturables de votre organisation. Les administrateurs de l’organisation voient l’utilisation de l’ensemble des équipes. Les administrateurs d’équipe voient les mêmes graphiques, mais limités aux équipes qu’ils administrent.

<h2 id="view-usage-over-time">
  Voir l’utilisation au fil du temps
</h2>

<Note>
  This feature isn't enabled for every organization yet. If you don't see it, contact [Support](mailto:forge-support@coreweave.com) or your AISE.
</Note>

Sélectionnez votre type de déploiement :

<Tabs>
  <Tab title="Cloud mutualisé">
    1. Dans le coin supérieur droit, cliquez sur l’icône de votre profil utilisateur.
    2. Dans la section **Compte**, cliquez sur **Facturation**.
    3. Cliquez sur l’onglet **Utilisation & alertes**.
    4. Dans la barre latérale, sélectionnez **Sandbox** pour afficher le graphique **Utilisation au fil du temps** correspondant.
  </Tab>

  <Tab title="Cloud dédié et autogéré">
    1. Dans le coin supérieur droit, cliquez sur l’icône de votre profil utilisateur.
    2. Cliquez sur **Tableau de bord de l’organisation**.
    3. Cliquez sur **Utilisation & alertes**.
    4. Dans la barre latérale, sélectionnez **Sandbox** pour afficher le graphique **Utilisation au fil du temps** correspondant.
  </Tab>
</Tabs>

Pour en savoir plus sur les commandes du graphique et les autres catégories d’utilisation, consultez [Gérer les paramètres de facturation](/fr/products/wandb/platform/app/settings-page/billing-settings#view-usage-over-time).

Quelle que soit l’offre, la facturation des sandboxes Forge ne prend pas en charge les alertes d’utilisation ou de dépenses.

<h2 id="log-sandbox-metrics-to-a-wb-run">
  Journaliser les métriques de sandbox dans un run Weights & Biases
</h2>

Une `Session` peut journaliser des métriques de sandbox côté client, telles que le nombre de sandboxes créés, les exécutions, les taux de réussite et les temps de démarrage, dans votre run Weights & Biases actif. Ces métriques décrivent la manière dont votre code utilise les sandboxes. Elles ne mesurent pas l’utilisation du CPU ni de la mémoire. Pour les activer et consulter la liste complète, voir la section consacrée à l’intégration des métriques Weights & Biases dans [Entraînement RL](/fr/products/sandboxes/client/guides/rl-training).

<h2 id="monitor-coreweave-organization-metrics">
  Surveiller les métriques de l’organisation CoreWeave
</h2>

CoreWeave Sandboxes publie des métriques par organisation qui décrivent chaque sandbox actif : le nombre de sandboxes en cours d’exécution, les ressources qu’ils ont demandées et la quantité de CPU et de mémoire qu’ils consomment. Utilisez ces métriques pour suivre l’activité de votre flotte, imputer l’utilisation des ressources et créer vos propres tableaux de bord et alertes.

<h3 id="prerequisites">
  Prérequis
</h3>

Les métriques sont disponibles dans la [section Explore](/observability/managed-grafana) de l’instance Grafana hébergée par CoreWeave. Pour accéder à Grafana, vous devez être connecté à la Cloud Console CoreWeave et être membre de l’un des groupes `admin`, `metrics` ou `write`.

Vous pouvez également interroger ces mêmes métriques par programmation via l’[API de métriques](/observability/logs-metrics/introduction), à l’adresse `observe.coreweave.com`, à l’aide d’un jeton d’accès API.

<Info>
  Les requêtes sont automatiquement limitées à votre organisation. Les sélecteurs portant sur `cluster` ou `cluster_org` sont réécrits pour cibler votre organisation : une requête qui fait référence à une autre organisation renvoie donc vos propres données, et non un résultat vide.
</Info>

<h3 id="common-labels">
  Libellés communs
</h3>

Toutes les métriques `cwsandbox_*` portent les libellés suivants :

| Libellé | Description | Exemple | Notes |
| - | - | - | - |
| `org_id` | Identifiant de votre organisation | `abc123` | Toujours votre propre organisation. |
| `cluster` | Constante, égale à `org_id` | `abc123` | Les métriques des sandboxes se trouvent toujours sous ce pseudo-cluster, quel que soit l’endroit où les sandboxes sont placés. |
| `cluster_org` | Identifiant de l’organisation | `abc123` | Les requêtes sont automatiquement limitées à l’organisation. |
| `region` | Région qui dessert la flotte de sandboxes | `US-EAST-02` | Voir [la liste des Régions](/platform/regions/about-regions-and-azs). |
| `zone` | Zone qui dessert la flotte de sandboxes | `US-EAST-02A` | Voir [la liste des Availability Zones](/platform/regions/about-regions-and-azs). |

Le contrat de libellés reste le même, que vos sandboxes s’exécutent sur la capacité partagée managée par CoreWeave ou sur vos propres clusters CoreWeave Kubernetes Service (CKS) avec un [exécuteur géré](/fr/products/sandboxes/operations/managed-runners). Pour ventiler l’utilisation par placement, regroupez les données selon le libellé `runner_id` de `cwsandbox_sandbox_info`.

<h3 id="lifecycle-metrics">
  Métriques de cycle de vie
</h3>

Ces métriques proviennent du plan de contrôle des sandboxes et sont actualisées toutes les 30 secondes environ. Les séries propres à chaque sandbox existent tant que la sandbox est active et disparaissent peu après son arrêt.

<h4 id="metric-cwsandbox_sandboxes">
  Métrique `cwsandbox_sandboxes`
</h4>

Nombre de sandboxes actifs dans chaque état du cycle de vie. L’unité est le sandbox.

Les libellés suivants sont disponibles pour le filtrage et le regroupement :

| Libellé | Description | Exemple | Notes |
| - | - | - | - |
| `state` | État du cycle de vie | `RUNNING` | Valeurs possibles : `PLACING`, `CREATING`, `RUNNING` et `TERMINATING`. Les sandboxes arrêtés ou terminés sont exclus. |

<h4 id="metric-cwsandbox_sandbox_info">
  Métrique `cwsandbox_sandbox_info`
</h4>

Une série de valeur constante `1` qui porte l’identité de chaque sandbox actif. Utilisez-la pour associer les libellés d’identité aux métriques d’utilisation.

Les libellés suivants sont disponibles pour le filtrage et le regroupement :

| Libellé | Description | Exemple | Notes |
| - | - | - | - |
| `sandbox_id` | L’ID de la sandbox | `0e0394fc-877b-4971-8e97-b99ea4f6bcd5` | Correspond à l’ID renvoyé au démarrage de la sandbox. |
| `profile_id` | Le profil utilisé pour le placement de la sandbox | `default` | Voir [profils](/fr/products/sandboxes/profiles/profiles). |
| `runner_id` | L’exécuteur qui héberge la sandbox | `prod-east-14-managed` | Identifie le placement, y compris vos propres [exécuteurs gérés](/fr/products/sandboxes/operations/managed-runners). |
| `image` | L’image de conteneur de la sandbox | `python:3.11-slim` | L’image utilisée au démarrage de la sandbox. |

<h4 id="metric-cwsandbox_sandbox_age_seconds">
  Métrique `cwsandbox_sandbox_age_seconds`
</h4>

Âge de chaque sandbox actif depuis sa création, exprimé en secondes. Cette métrique porte l’étiquette `sandbox_id`.

<h4 id="metric-cwsandbox_sandbox_requested_cpu_millicores">
  Métrique `cwsandbox_sandbox_requested_cpu_millicores`
</h4>

Ressources CPU demandées par chaque sandbox lors de l’admission, et non l’utilisation mesurée. Valeurs exprimées en millicœurs. Étiquette : `sandbox_id`.

<h4 id="metric-cwsandbox_sandbox_requested_memory_bytes">
  Métrique `cwsandbox_sandbox_requested_memory_bytes`
</h4>

Mémoire demandée par chaque sandbox lors de l’admission, et non l’utilisation mesurée. Valeur exprimée en octets. Étiquette : `sandbox_id`.

<h4 id="metric-cwsandbox_sandbox_requested_gpus">
  Métrique `cwsandbox_sandbox_requested_gpus`
</h4>

Nombre de GPU demandés par chaque sandbox lors de l’admission. Unité : GPU. Étiquettes : `sandbox_id` et `gpu_type`.

<h3 id="usage-metrics">
  Métriques d’utilisation
</h3>

Ces métriques sont mesurées sur le nœud qui exécute chaque sandbox et sont actualisées environ toutes les 30 secondes.

<h4 id="metric-cwsandbox_sandbox_cpu_usage_seconds_total">
  Métrique `cwsandbox_sandbox_cpu_usage_seconds_total`
</h4>

Compteur du temps CPU consommé par chaque sandbox, exprimé en secondes CPU. Ce compteur porte l’étiquette `sandbox_id`. Utilisez `rate()` ou `increase()` pour calculer la consommation sur une fenêtre donnée.

<h4 id="metric-cwsandbox_sandbox_memory_working_set_bytes">
  Métrique `cwsandbox_sandbox_memory_working_set_bytes`
</h4>

Mémoire actuelle de l’ensemble de travail (working set) de chaque sandbox, exprimée en octets. Étiquetée par `sandbox_id`.

<Info>
  Les valeurs d’utilisation reflètent le conteneur de charge de travail de la sandbox. Pour les sandboxes exécutées avec une isolation microVM, les valeurs sont mesurées à l’intérieur de l’invité et excluent la surcharge liée à la virtualisation ainsi que les processus sidecar de la plateforme. Le compteur CPU est réinitialisé si le conteneur de charge de travail redémarre, ce que `rate()` et `increase()` gèrent automatiquement. Une brève lacune dans une série indique que la collecte a été momentanément interrompue. Les valeurs obsolètes ne sont jamais rapportées.
</Info>

<h3 id="promql-examples">
  Exemples PromQL
</h3>

<h4 id="running-sandboxes-over-time">
  Sandboxes en cours d’exécution dans le temps
</h4>

```promql theme={"system"}
sum(cwsandbox_sandboxes{state="RUNNING"})
```

<h4 id="cpu-cores-in-use-per-sandbox">
  Cœurs de CPU utilisés par sandbox
</h4>

```promql theme={"system"}
rate(cwsandbox_sandbox_cpu_usage_seconds_total[5m])
```

<h4 id="cpu-usage-enriched-with-profile-and-runner">
  Utilisation du CPU enrichie du profil et de l’exécuteur
</h4>

Effectuez une jointure du compteur d’utilisation avec `cwsandbox_sandbox_info` sur `sandbox_id` pour y joindre les libellés d’identité :

```promql theme={"system"}
rate(cwsandbox_sandbox_cpu_usage_seconds_total[5m])
* on (sandbox_id) group_left (profile_id, runner_id, image)
cwsandbox_sandbox_info
```

<h4 id="total-memory-in-use-across-the-fleet">
  Mémoire totale utilisée sur l’ensemble de la flotte
</h4>

```promql theme={"system"}
sum(cwsandbox_sandbox_memory_working_set_bytes)
```

<h4 id="cpu-efficiency-used-versus-requested">
  Efficacité CPU, utilisation réelle par rapport aux requêtes
</h4>

```promql theme={"system"}
sum(rate(cwsandbox_sandbox_cpu_usage_seconds_total[5m]))
/
(sum(cwsandbox_sandbox_requested_cpu_millicores) / 1000)
```

<h4 id="requested-gpus-by-type">
  GPU demandés par type
</h4>

```promql theme={"system"}
sum by (gpu_type) (cwsandbox_sandbox_requested_gpus)
```

<h4 id="longest-running-sandboxes">
  Sandboxes en cours d’exécution depuis le plus longtemps
</h4>

```promql theme={"system"}
topk(10, cwsandbox_sandbox_age_seconds)
```