> ## 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.

# サンドボックスの使用状況を表示する

> サンドボックスの請求、クライアントのアクティビティ、フリートのリソースメトリクスをトラッキングします。

サーバーレスサンドボックスの使用状況は、組織内の他の課金対象プロダクトと同様に Forge コンソールに表示されます。組織管理者は、すべてのチームの使用状況を確認できます。チーム管理者も同じチャートを確認できますが、表示されるのは自身が管理するチームの分のみです。

<h2 id="view-usage-over-time">
  使用量の推移を表示する
</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>

デプロイメントタイプを選択してください。

<Tabs>
  <Tab title="Multi-tenant Cloud">
    1. 右上隅にあるユーザープロフィールアイコンをクリックします。
    2. **Account** セクションで **Billing** をクリックします。
    3. **使用量とアラート** タブをクリックします。
    4. サイドバーで **Sandboxes** を選択すると、**使用量の推移** チャートが表示されます。
  </Tab>

  <Tab title="専用クラウドとセルフマネージド">
    1. 右上隅にあるユーザープロフィールアイコンをクリックします。
    2. **Organization Dashboard** をクリックします。
    3. **使用量とアラート** をクリックします。
    4. サイドバーで **Sandboxes** を選択すると、**使用量の推移** チャートが表示されます。
  </Tab>
</Tabs>

チャートの操作方法やその他の使用量カテゴリについては、[請求設定を管理する](/ja/products/wandb/platform/app/settings-page/billing-settings#view-usage-over-time)を参照してください。

Forge のサンドボックスの請求では、どのプランでも使用量アラートと支出アラートはサポートされていません。

<h2 id="log-sandbox-metrics-to-a-wb-run">
  サンドボックスのメトリクスを Weights & Biases の run にログする
</h2>

`Session` を使用すると、作成されたサンドボックス数、実行数、成功率、起動時間などのクライアント側のサンドボックスメトリクスを、実行中の Weights & Biases の run にログできます。これらのメトリクスは、コードがサンドボックスをどのように使用しているかを示すもので、CPU やメモリの使用量は含まれません。有効化の方法とメトリクスの完全なリストについては、[RL トレーニング](/ja/products/sandboxes/client/guides/rl-training)の Weights & Biases メトリクスインテグレーションのセクションを参照してください。

<h2 id="monitor-coreweave-organization-metrics">
  CoreWeave の組織メトリクスを監視する
</h2>

CoreWeave Sandboxes は、実行中のすべてのサンドボックスの状態を示すメトリクスを組織単位でパブリッシュします。具体的には、実行中のサンドボックスの数、リクエストされたリソース、CPU とメモリの消費量などです。これらのメトリクスを使用して、フリートのアクティビティのトラッキング、使用量の内訳の把握、独自のダッシュボードやアラートの構築を行えます。

<h3 id="prerequisites">
  前提条件
</h3>

メトリクスは、CoreWeave がホストする Grafana インスタンスの [Explore セクション](/observability/managed-grafana)で確認できます。Grafana にアクセスするには、CoreWeave Cloud Console にログインしたうえで、`admin`、`metrics`、`write` のいずれかのグループのメンバーである必要があります。

API アクセストークンを使用すれば、`observe.coreweave.com` の [メトリクス API](/observability/logs-metrics/introduction) から同じメトリクスをプログラムでクエリすることもできます。

<Info>
  クエリの対象は、自動的にお客様の組織に限定されます。`cluster` または `cluster_org` のセレクターはお客様の組織に書き換えられるため、別の組織を参照するクエリを実行しても、空の結果ではなくお客様自身のデータが返されます。
</Info>

<h3 id="common-labels">
  共通ラベル
</h3>

すべての `cwsandbox_*` メトリクスには、次のラベルが付与されます。

| ラベル | 説明 | 例 | メモ |
| - | - | - | - |
| `org_id` | お客様の組織 ID | `abc123` | 常にお客様自身の組織です。 |
| `cluster` | 定数 (`org_id` と同じ値) | `abc123` | サンドボックスの配置場所に関係なく、サンドボックスのメトリクスは常にこの疑似クラスターの下に格納されます。 |
| `cluster_org` | 組織 ID | `abc123` | クエリの対象範囲は自動的にその組織に限定されます。 |
| `region` | サンドボックスフリートを提供するリージョン | `US-EAST-02` | [リージョンの一覧](/platform/regions/about-regions-and-azs)を参照してください。 |
| `zone` | サンドボックスフリートを提供するゾーン | `US-EAST-02A` | [アベイラビリティゾーンの一覧](/platform/regions/about-regions-and-azs)を参照してください。 |

ラベルの仕様は、サンドボックスを CoreWeave が管理する共有キャパシティ上で実行する場合も、[マネージドランナー](/ja/products/sandboxes/operations/managed-runners)を使用してお客様自身の CoreWeave Kubernetes Service (CKS) クラスター上で実行する場合も同じです。配置先ごとに使用量を分析するには、`cwsandbox_sandbox_info` の `runner_id` ラベルでグループ化してください。

<h3 id="lifecycle-metrics">
  ライフサイクルメトリクス
</h3>

これらのメトリクスはサンドボックスのコントロールプレーンから取得され、約 30 秒ごとに更新されます。サンドボックスごとの時系列は、サンドボックスが実行中の間は存在し、停止後まもなく消去されます。

<h4 id="metric-cwsandbox_sandboxes">
  メトリクス `cwsandbox_sandboxes`
</h4>

各ライフサイクル状態にある実行中のサンドボックスの数です。単位はサンドボックス (個) です。

フィルタリングとグループ化には、次のラベルを使用できます。

| ラベル | 説明 | 例 | メモ |
| - | - | - | - |
| `state` | ライフサイクル状態 | `RUNNING` | 値は `PLACING`、`CREATING`、`RUNNING`、`TERMINATING` のいずれかです。停止済みおよび完了済みのサンドボックスは含まれません。 |

<h4 id="metric-cwsandbox_sandbox_info">
  メトリクス `cwsandbox_sandbox_info`
</h4>

実行中の各サンドボックスのアイデンティティを保持する、値が常に `1` の時系列です。使用状況メトリクスにアイデンティティラベルを結合する際に使用します。

次のラベルを使用して、フィルタリングやグループ化を行えます。

| ラベル | 説明 | 例 | メモ |
| - | - | - | - |
| `sandbox_id` | サンドボックス ID | `0e0394fc-877b-4971-8e97-b99ea4f6bcd5` | サンドボックスの起動時に返された ID と一致します。 |
| `profile_id` | サンドボックスの配置に使用されたプロフィール | `default` | [プロフィール](/ja/products/sandboxes/profiles/profiles)を参照してください。 |
| `runner_id` | サンドボックスを処理しているランナー | `prod-east-14-managed` | 独自の[マネージドランナー](/ja/products/sandboxes/operations/managed-runners)を含め、配置先を識別します。 |
| `image` | サンドボックスのコンテナーイメージ | `python:3.11-slim` | サンドボックスの起動に使用されたイメージです。 |

<h4 id="metric-cwsandbox_sandbox_age_seconds">
  メトリクス `cwsandbox_sandbox_age_seconds`
</h4>

実行中の各サンドボックスの、作成時からの経過時間です。単位は秒です。`sandbox_id` ラベルが付与されます。

<h4 id="metric-cwsandbox_sandbox_requested_cpu_millicores">
  メトリクス `cwsandbox_sandbox_requested_cpu_millicores`
</h4>

各サンドボックスが受け入れ時にリクエストした CPU 量です。測定使用量ではありません。単位はミリコアです。`sandbox_id` ラベルが付与されます。

<h4 id="metric-cwsandbox_sandbox_requested_memory_bytes">
  メトリクス `cwsandbox_sandbox_requested_memory_bytes`
</h4>

各サンドボックスが受け入れ時にリクエストしたメモリ量です (測定使用量ではありません)。単位はバイトです。`sandbox_id` ラベルが付与されます。

<h4 id="metric-cwsandbox_sandbox_requested_gpus">
  メトリクス `cwsandbox_sandbox_requested_gpus`
</h4>

各サンドボックスが受け入れ時にリクエストした GPU 数です。単位は GPU です。`sandbox_id` と `gpu_type` のラベルが付与されます。

<h3 id="usage-metrics">
  使用状況メトリクス
</h3>

これらのメトリクスは、各サンドボックスが実行されているノード上で測定され、約 30 秒ごとに更新されます。

<h4 id="metric-cwsandbox_sandbox_cpu_usage_seconds_total">
  メトリクス `cwsandbox_sandbox_cpu_usage_seconds_total`
</h4>

各サンドボックスが消費した CPU 時間を表すカウンターです。単位は CPU 秒です。`sandbox_id` のラベルが付与されます。ウィンドウ内の消費量を算出するには、`rate()` または `increase()` を使用してください。

<h4 id="metric-cwsandbox_sandbox_memory_working_set_bytes">
  メトリクス `cwsandbox_sandbox_memory_working_set_bytes`
</h4>

各サンドボックスの現在のワーキングセットメモリです。単位はバイトです。`sandbox_id` のラベルが付与されます。

<Info>
  使用量の値は、サンドボックスのワークロードコンテナーの値を反映しています。microVM 分離で実行されているサンドボックスの場合、値はゲスト内部から取得されるため、仮想化のオーバーヘッドやプラットフォームのサイドカープロセスは含まれません。ワークロードコンテナーが再起動すると CPU カウンターはリセットされますが、`rate()` と `increase()` によって自動的に処理されます。時系列に短い欠落がある場合は、データの収集が一時的に中断されたことを示します。古い値が報告されることはありません。
</Info>

<h3 id="promql-examples">
  PromQL のサンプル
</h3>

<h4 id="running-sandboxes-over-time">
  実行中のサンドボックス数の推移
</h4>

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

<h4 id="cpu-cores-in-use-per-sandbox">
  サンドボックスごとの使用中の CPU コア数
</h4>

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

<h4 id="cpu-usage-enriched-with-profile-and-runner">
  プロフィールとランナーの情報を付加した CPU 使用量
</h4>

使用量カウンターを `sandbox_id` をキーにして `cwsandbox_sandbox_info` と結合し、アイデンティティラベルを付加します。

```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">
  フリート全体で使用中のメモリの合計
</h4>

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

<h4 id="cpu-efficiency-used-versus-requested">
  CPU 効率 (使用量とリクエスト量の比較)
</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数
</h4>

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

<h4 id="longest-running-sandboxes">
  実行時間が最も長いサンドボックス
</h4>

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