監査ログを取得した後は、Pandas、Amazon Redshift、Google BigQuery、Microsoft Fabric などのツールで分析できます。一部の監査ログ分析ツールは JSON をサポートしていません。分析前に JSON 形式の監査ログを変換するためのガイドラインや要件については、使用する分析ツールのドキュメントを参照してください。
ログ形式の詳細については、監査ログスキーマ と アクション を参照してください。
監査ログの保持
- 監査ログを一定期間保持する必要がある場合、W&B では、storage buckets または Audit Logging API を使用して、ログを長期ストレージに定期的に転送することを推奨します。
- 1996年医療保険の携行性と責任に関する法律 (HIPAA) の適用対象である場合、監査ログは、法令で義務付けられた保持期間が終了するまで、社内外のいかなる関係者も削除または変更できない環境で、少なくとも 6 年間保持する必要があります。BYOB を使用する HIPAA 準拠の専用クラウドインスタンスでは、長期保持用ストレージを含む管理対象ストレージに対するガードレールを設定する必要があります。
監査ログスキーマ
個人を特定できる情報 (PII)
- セルフマネージド と 専用クラウド では、組織管理者は 監査ログ の取得時に PII を除外 できます。
- Multi-tenant Cloud では、API endpoint は常に PII を含む 監査ログ の関連フィールドを返します。これは設定できません。
始める前に
-
組織レベルの管理者は監査ログを取得できます。
403エラーが返される場合は、ご自身またはサービスアカウントに十分な権限があることを確認してください。 -
Multi-tenant Cloud: 複数の Multi-tenant Cloud 組織に所属している場合、監査ログ API 呼び出しの送信先を決定する Default API organization を 必ず 設定する必要があります。設定しないと、次のエラーが表示されます。
デフォルトの API 組織を指定するには、次の手順を実行します。
- プロフィール画像をクリックし、User Settings をクリックします。
- Default API organization で、組織を選択します。
監査ログを取得する
- 専用クラウドまたはセルフマネージド
- Multi-tenant Cloud
このタブは 専用クラウド または セルフマネージド のインスタンス向けです。Audit Logging API のエンドポイントには、お使いのインスタンスの URL を使用します。レスポンスは次の例のようになります。次のページを取得するには、解決済みの日付範囲と Self-Managed および Dedicated Cloud では、W&B の組織管理者またはインスタンス管理者が、監査ログの取得時に PII を除外できます。Multi-tenant Cloud では、API endpoint は PII を含む監査ログの関連フィールドを常に返します。この動作は変更できません。PII を除外するには、URL パラメーター
- 専用クラウド:
https://[INSTANCE-NAME].wandb.io/admin/audit_logs - セルフマネージド:
https://[WANDB-PLATFORM-URL]/admin/audit_logs
[INSTANCE-NAME]: 専用クラウドインスタンスの名前。[WANDB-PLATFORM-URL]: セルフマネージドインスタンスの URL。[API-ENDPOINT]: インスタンスのエンドポイント。[BASE64-USERNAME-API-KEY]:[USERNAME]:[API-KEY]形式の文字列を base64 エンコードしたもの。[NEXT-CURSOR]: 前回のレスポンスに含まれるnext_cursorの値。
anonymize: URL にanonymize=trueが含まれる場合、W&B は監査ログに PII フィールドを追加しません。含まれない場合は PII が含まれます。詳細は, 監査ログ取得時に PII を除外する を参照してください。startDate: 日付範囲の開始日時 (この日時を含む) を UTC で指定します。サポートされる形式はYYYY-MM-DD、YYYY-MM-DDTHH、YYYY-MM-DDTHH:mm、YYYY-MM-DDTHH:mm:ssです。省略された時刻部分は 0 として扱われます。たとえば、2026-08-03T01は2026-08-03T01:00:00Zを意味します。startDateを省略した場合、範囲は本日の UTC 午前 0 時から開始します。numDaysを設定している場合は、本日のnumDays日前から開始します。numDays: 0 以上の整数です。W&B はstartDateからその後numDays日分のログを取得します。numDaysを省略するか0に設定した場合、W&B はstartDate当日分のログのみを取得します。numDaysはendDateと併用できません。endDate: 日付範囲の終了日時 (この日時を含まない) を UTC で指定します。サポートされる形式はstartDateと同じです。endDateを設定すると、limitを設定していなくてもページ分割された JSON レスポンスが返されます。endDateはnumDaysと併用できません。limit: ページ分割されたレスポンスで返す監査ログエントリの最大数です。20,000までの正の整数を指定してください。limitを設定すると、W&B はページ分割された JSON レスポンスを返します。ページ分割されたリクエストでのデフォルトは20,000です。cursor: 前回のレスポンスのnext_cursorフィールドで返された不透明なカーソルです。カーソルを再利用する際は、解決済みの日付範囲とanonymizeの値を前回と同じにしてください。cursorを設定する場合は、limitまたはendDateも設定する必要があります。
limit または endDate を設定しない場合、API は元のストリーミングレスポンス形式を維持します。レスポンスには、改行区切りの JSON オブジェクトが含まれます。各オブジェクトには Audit log schema に記載のフィールドが含まれ、instance-level bucket に同期されるログと同じ内容になります。3 日間の範囲について、改行区切り JSON のストリーミングレスポンスを取得し、PII を除外するには、次を実行します。limit または endDate を設定した場合、API は次のフィールドを持つ JSON オブジェクトを返します。audit_logs: 監査ログエントリの配列です。各エントリには Audit log schema に記載されているフィールドが含まれます。range_start_time: 解決された日付範囲の開始時刻 (UTC) です。range_end_time: 解決された日付範囲の終了時刻 (UTC) です。この時刻は範囲に含まれません。count: このレスポンスで返された監査ログエントリの数です。next_cursor: 次のページの結果を取得するための不透明なカーソルです。このフィールドがnullの場合、選択した日付範囲にはこれ以上の結果がありません。
anonymize の値を同じにしてリクエストを再実行します。cursor には、前回のレスポンスの next_cursor の値を設定してください。next_cursor が null になるまで繰り返します。anonymize=true を指定します。たとえば、過去 1 週間のユーザーアクティビティの監査ログを PII を除外して取得する場合、W&B インスタンスの URL が https://mycompany.wandb.io であれば、次のような API endpoint を使用します:基本認証を使用する
Authorization ヘッダーに、文字列 Basic、半角スペース 1 つ、続けて [USERNAME]:[API-KEY] 形式の文字列をbase64エンコードした値を設定します。つまり、username と API-KEY を : で区切った実際の値に置き換え、その結果をbase64エンコードします。たとえば、demo:p@55w0rd として認証する場合、ヘッダーを Authorization: Basic ZGVtbzpwQDU1dzByZA== に設定します。
アクション
action フィールドを解釈する際は、このリファレンスを参照してください。この表では、W&B が記録できるアクションをアルファベット順に示します。