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

# オートメーションのイベントとスコープ

> W&B オートメーションをトリガーするイベントとスコープについて学びます。これにはアーティファクトの変更、run ステータス、メトリクスの条件が含まれます。

オートメーションは、指定されたスコープ (組織、チーム、project、Registry、またはコレクション) 内で特定のイベントが発生したときに開始します。このページでは、各スコープ内でオートメーションをトリガーできるイベントについて説明します。これにより、オートメーションを構成する際に適切なトリガーを選択できます。オートメーションの詳細については、[オートメーションの概要](/ja/products/wandb/automations) または [オートメーションの作成](/ja/products/wandb/automations/create-automations) を参照してください。

スコープは階層構造になっています。組織にはチームが含まれ、チームには project とRegistryが含まれます。project とRegistryの両方にコレクションが含まれます。project にはログされたアーティファクト コレクションが含まれ、Registryにはアーティファクトのバージョンがリンクされたコレクションが含まれます。オートメーションは、スコープ内のすべて (後から作成された project、Registry、コレクションを含む) でイベントを監視します。1 つのイベントが複数のスコープのオートメーションに一致する場合があります。一致した各オートメーションは個別にトリガーされます。

広範なスコープでの過剰なトリガーを防ぐため、W\&B はオートメーションごとに rate limit とクールダウンを適用します。これらの保護機能により、同じオートメーションの繰り返しトリガーが遅延またはスキップされる場合があります。

<Note>
  チームおよび組織のスコープは、W\&B Multi-tenant Cloud および W\&B 専用クラウド (Server v0.83.0 以降) で利用できます。Registry および project のスコープは、すべてのデプロイメントタイプで利用できます。
</Note>

<h2 id="scope-reference">
  スコープ参照
</h2>

| スコープ | オートメーションが監視する対象 | W\&B アプリで利用可能なイベント |
| - | - | - |
| [組織](#organization) | 組織内のすべてのチーム、project、Registry、コレクション (将来作成されるものを含む) 。 | アーティファクトおよびコレクションのイベント (新しいバージョンの追加やリンク、エイリアスやタグの追加など) 。run ベースのイベントは利用できません。 |
| [チーム](#team) | チームが所有するすべてのproject、Registry、コレクション (将来作成されるものを含む) 。 | 組織スコープと同じアーティファクトおよびコレクションのイベント。run ベースのイベントは利用できません。 |
| [Registry](#registry) | 1 つの Registry 内のすべてのコレクション (将来追加されるコレクションを含む) 。 | [Registry イベント](#registry-events): コレクションに新しいバージョンがリンクされる、またはアーティファクトのエイリアスが追加される。 |
| [project](#project) | 1 つの project 内のすべてのコレクション。一部のイベントではスコープをさらに絞り込めます。 | [アーティファクトイベント](#artifact-events) および [run イベント](#run-events)。 |

以下のセクションで各スコープについて詳しく説明します。

<h2 id="organization">
  組織
</h2>

組織スコープを使用して、ポリシーを一度定義し、どこにでも適用できます。たとえば、組織内の任意のアーティファクトに `production` エイリアスが追加されたときに、コンプライアンスの Slack チャンネルに通知します。

run ベースのイベント ([run ステータスの変更](#run-status-change) および [run メトリクスの変更](#run-metrics-change) イベント) は、W\&B アプリの組織スコープでは利用できません。

<h2 id="team">
  チーム
</h2>

チームスコープを使用して、1つのチームが所有するすべてにポリシーを適用します。チームスコープのオートメーションは、組織スコープと同じアーティファクトとコレクションのイベントを監視します。run ベースのイベントは、W\&B アプリのチームスコープでは利用できません。

<h2 id="registry">
  Registry
</h2>

[Registry](/ja/products/registry) のオートメーションは、特定の registry 内の任意のコレクション (将来追加されるコレクションを含む) で発生するイベントを監視します。

<h3 id="events">
  イベント <a id="registry-events" aria-label="Registry のイベント" />
</h3>

Registry のオートメーションは、以下のイベントを監視できます。

* **コレクションに新しいバージョンがリンクされた場合**: Registry に追加された新しいモデルやデータセットをテストおよび検証します。
* **アーティファクトのエイリアスが追加された場合**: 新しいアーティファクトのバージョンに特定のエイリアスが適用されたときに、ワークフローの特定のステップをトリガーします。たとえば、`production` エイリアスが適用されたときにモデルをデプロイします。

オートメーションが webhook を呼び出すと、project-scoped オートメーションと同じチームレベルの webhook 設定と [チームシークレット](/ja/products/wandb/platform/secrets) にアクセスできます。

<h2 id="project">
  project
</h2>

project レベルのオートメーションは、[project](/ja/products/wandb/track/project-page) 内のいずれかのコレクションで発生するイベントを監視します。指定するイベントに応じて、オートメーションの適用範囲をさらに制限できます。

<h3 id="artifact-events">
  アーティファクトのイベント
</h3>

このセクションでは、アーティファクトに関連するイベントについて説明します。これらのイベントはオートメーションをトリガーできます。

* **アーティファクトに新しいバージョンが追加された場合**: アーティファクトの各バージョンに対して繰り返しの action を適用します。たとえば、新しいデータセット アーティファクトのバージョンが作成されたときにトレーニング ジョブを開始します。
* **アーティファクトのエイリアスが追加された場合**: project 内の新しいアーティファクトのバージョンに、指定した **エイリアス regex** に一致するエイリアスが適用されたときに、ワークフローの特定のステップをトリガーします。たとえば、アーティファクトに `test-set-quality-check` エイリアスが適用されたとき、または新しいアーティファクトのバージョンに `latest` エイリアスが適用されるたびに、一連の下流処理ステップを実行します。同じエイリアスを一度に持てるアーティファクトのバージョンは 1 つだけです。
* **アーティファクトのタグが追加された場合**: project 内のアーティファクトのバージョンに、指定した **Tag regex** に一致するタグが適用されたときに、ワークフローの特定のステップをトリガーします。たとえば、`^europe.*` を指定して、タグが文字列 `europe` で始まるものがアーティファクトのバージョンに追加されたときに、地理固有の ワークフローをトリガーします。グループ化とフィルターにアーティファクトのタグを使用します。同じタグを複数のアーティファクトのバージョンに assign できます。

<h3 id="run-events">
  run イベント
</h3>

以下のセクションでは、[run のステータス](/ja/products/wandb/runs/run-states)の変更、または [run のメトリクス値](/ja/products/wandb/track/log#what-data-is-logged-with-specific-wb-api-calls)の変更に基づいて開始するオートメーションの設定方法を説明します。

<h4 id="run-status-change">
  run ステータスの変更
</h4>

<Note>
  * 現在は [W\&B Multi-tenant Cloud](/ja/products/wandb/platform/hosting#wb-multi-tenant-cloud) と [専用クラウド](/ja/products/wandb/platform/hosting#wb-dedicated-cloud) でのみ利用できます。
  * **Killed** ステータスの run はオートメーションをトリガーできません。このステータスは、管理者が run を強制的に停止したことを示します。
</Note>

run の [ステータス](/ja/products/wandb/runs/run-states) が **Running**、**Finished**、または **Failed** に変わったときにワークフローをトリガーします。必要に応じて、ユーザーまたは run 名のフィルターを指定し、オートメーションをトリガーできる run をさらに絞り込むこともできます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/run_status_change.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=be965be8dda7da6ced6be15729fc1399" alt="run ステータス変更オートメーションを示すスクリーンショット" width="434" height="419" data-path="products/wandb/_media/run_status_change.png" />
</Frame>

run ステータスは run 全体のプロパティであるため、run ステータスのオートメーションは Workspace からは作成できず、**オートメーション** ページからのみ作成できます。

<h4 id="run-metrics-change">
  run のメトリクスの変化
</h4>

<Note>
  現在は [W\&B Multi-tenant Cloud](/ja/products/wandb/platform/hosting#wb-multi-tenant-cloud) と [専用クラウド](/ja/products/wandb/platform/hosting#wb-dedicated-cloud) でのみ利用できます。
</Note>

run の履歴にあるメトリクス、または CPU 使用率をトラッキングする `cpu` などの[システムメトリクス](/ja/products/wandb/ref/python/experiments/system-metrics)について、ログされた値に基づいてワークフローをトリガーします。W\&B はシステムメトリクスを 15 秒ごとに自動的にログします。

run のメトリクスに関するオートメーションは、project の **オートメーション** タブ、または Workspace のラインプロットパネルから直接作成できます。

run のメトリクスに関するオートメーションを設定するには、メトリクスの値と指定したしきい値を比較する方法を設定します。選択できる方法は、イベントのタイプと指定したフィルターによって異なります。

必要に応じて、ユーザーまたは run 名のフィルターを指定し、オートメーションをトリガーできる run をさらに絞り込めます。

<h5 id="threshold">
  しきい値
</h5>

メトリクスが固定値を超えたときにオートメーションを開始するには、しきい値イベントを使用します。**Run metrics threshold met** イベントでは、次を設定します。

1. 評価対象となる、直近のログされた値のウィンドウ (デフォルトは 5) 。
2. ウィンドウ内の **Average**、**Min**、**Max** のどれを評価するか。
3. 比較条件：
   * Above
   * Above or equal to
   * Below
   * Below or equal to
   * Not equal to
   * Equal to

たとえば、`accuracy` の平均値が `0.6` より大きいときにオートメーションを起動します。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/run_metrics_threshold_automation.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=88b9cebb9df9bf7efe974ca5d6440373" alt="run メトリクスのしきい値オートメーションを示すスクリーンショット" width="434" height="478" data-path="products/wandb/_media/run_metrics_threshold_automation.png" />
</Frame>

<h5 id="change-threshold">
  変更しきい値
</h5>

変更しきい値イベントを使用して、最近の 2 つの値のウィンドウ間でメトリクスが変化したときにオートメーションを開始します。**Run metrics change threshold met** イベントの場合、オートメーションは 2 つの値の「ウィンドウ」を使用して開始するかどうかを確認します。

* 考慮する最近ログされた値の\_現在のウィンドウ\_ (デフォルトは 10) 。
* 考慮する最近ログされた値の\_前のウィンドウ\_ (デフォルトは 50) 。

現在のウィンドウと前のウィンドウは連続しており、重複しません。

オートメーションを作成するには、次の項目を設定します。

1. ログされた値の現在のウィンドウ (デフォルトは 10) 。
2. ログされた値の前のウィンドウ (デフォルトは 50) 。
3. 値を相対または絶対として評価するかどうか (デフォルトは **Relative**) 。
4. 実行する比較：
   * 少なくとも増加
   * 少なくとも減少
   * 少なくとも増加または減少

たとえば、平均 `loss` が少なくとも `0.25` 減少したときにオートメーションをトリガーします。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/run_metrics_change_threshold_automation.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=ca0a2d5ae20d634ea840edc8b1f126ad" alt="run メトリクス変更しきい値オートメーションを示すスクリーンショット" width="434" height="703" data-path="products/wandb/_media/run_metrics_change_threshold_automation.png" />
</Frame>

<h4 id="run-metrics-z-score-change">
  runのメトリクスのzスコアの変化
</h4>

<Note>
  現在は [W\&B Multi-tenant Cloud](/ja/products/wandb/platform/hosting#wb-multi-tenant-cloud) と [専用クラウド](/ja/products/wandb/platform/hosting#wb-dedicated-cloud) でのみ利用できます。
</Note>

W\&Bでは、メトリクスのzスコア (標準得点) が指定したしきい値を超えると、オートメーションをトリガーできます。zスコアは、project内の設定可能なrunのウィンドウ (デフォルトは30件) を対象に、そのメトリクスの値が平均から標準偏差の何倍離れているかを示します。

zスコアをイベントのトリガーとして使用するには、**Run metrics z-score threshold met**イベントを選択します。

zスコアに基づくオートメーションを使用すると、モデルやトレーニングのプロセスの変化に伴って変わり得る絶対的なしきい値を確認しなくても、通常とは異なるパフォーマンスをチームに通知できます。

runのメトリクスのzスコアに基づくオートメーションは、projectの**オートメーション**タブ、またはWorkspaceのラインプロットパネルから直接作成できます。

zスコアに基づくオートメーションを作成するには、以下を設定します。

1. zスコアのしきい値。正の浮動小数点数で指定します (例: 2.0) 。
2. 平均値の算出に使用するログされた値のウィンドウ (デフォルトは30件) 。
3. 比較条件:
   * 上回る (パフォーマンスが通常より著しく高い場合にトリガー) 。
   * 下回る (パフォーマンスが通常より著しく低い場合にトリガー) 。
   * 上回る、または下回る。

たとえば、`accuracy`のzスコアが2を超えたときにオートメーションをトリガーできます。これは、そのrunのパフォーマンスがproject内のほかのrunを大きく上回っていることを意味します。

zスコアの値には、次の意味があります。

* zスコアが0の場合、そのメトリクスの値は平均と等しくなります。
* zスコアが+2.0の場合、そのメトリクスの値は平均より標準偏差2個分高いことを示します。
* zスコアが-2.0の場合、そのメトリクスの値は平均より標準偏差2個分低いことを示します。
* ±2を超える値は、統計的に有意な外れ値とみなされることがよくあります。

<h4 id="run-filters">
  run フィルター
</h4>

このセクションでは、オートメーションが評価対象の run をどのように選択するかを説明します。

デフォルトでは、project 内の任意の run がイベント発生時にオートメーションをトリガーします。以下のフィルターのいずれかを設定することで、どの run がオートメーションをトリガーするかを制限できます。

| フィルター | 説明 |
| - | - |
| **1 人のユーザーの run にフィルター** | 指定したユーザーが作成した run のみを含めます。 |
| **run 名でフィルター** | run 名が指定された正規表現に一致する run のみを含めます。 |

オートメーションは各 run を次のように評価します。

* 各 run は個別に考慮され、オートメーションをトリガーする可能性があります。
* 各 run の値は別々のウィンドウに配置され、しきい値と個別に比較されます。
* 24 時間以内に、特定のオートメーションは 1 つの run につき最大 1 回しか起動できません。

詳細については、[オートメーションの作成](/ja/products/wandb/automations/create-automations) を参照してください。

<h2 id="next-steps">
  次のステップ
</h2>

* [Slack オートメーションを作成する](/ja/products/wandb/automations/create-automations/slack)
* [webhook オートメーションを作成する](/ja/products/wandb/automations/create-automations/webhook)


## Related topics

- [オートメーションの概要](/ja/products/wandb/automations.md)