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

# 監査ログ

> CLI が実行する PlayFab 操作について、オプトイン方式でローカルにメタデータのみの記録を保持します。

XBOX CLI では、どの PlayFab 操作を、どのタイトルに対して、いつ実行したかの記録をローカルに
保持できます。この記録を使用すると、自分自身、または自分の代わりに CLI を実行するエージェントが何を行ったかを後から
確認できます。ログは既定でオフになっており、自分のマシン上にのみ保存され、リクエスト本文、レスポンス、
トークン、ID 情報は含まれません。

ログには PlayFab の呼び出しのみが記録されます。`xbox xbl` や `xbox game` など、パートナー センターや XBOX サービスを
操作するコマンドは記録されません。

## 監査ログを有効にする

`XBOX_AUDITLOG__ENABLED` を `true` に設定します。bash または zsh の場合:

```bash theme={null}
export XBOX_AUDITLOG__ENABLED=true
```

PowerShell の場合:

```powershell theme={null}
$env:XBOX_AUDITLOG__ENABLED = "true"
```

## ログの保存場所

CLI は 1 日に 1 つのファイルを書き込み、直近の 31 個を保持します。

| プラットフォーム | パス |
| - | - |
| Windows | `%LOCALAPPDATA%\XboxDevCLI\audit<date>.jsonl` |
| Linux | `$XDG_DATA_HOME/XboxDevCLI/audit<date>.jsonl` (既定値は `~/.local/share`) |
| macOS | `~/Library/Application Support/XboxDevCLI/audit<date>.jsonl` |

ファイルにはサイズの上限がないため、1 日に多数の API 呼び出しを行う場合は、ディスク容量に注意してください。

## 記録される内容

PlayFab の呼び出しごとに、読み取りか変更かにかかわらず、[コンパクト JSON](https://clef-json.org/) の行が
1 行追加されます。

```json theme={null}
{"@t":"2026-08-25T16:59:47.3966336Z","@mt":"PlayFab invocation {ResolvedApiPath} {TitleId} {ExitStatus}","ResolvedApiPath":"/Admin/GetTitleData","TitleId":"ABC123","ExitStatus":0}
```

| フィールド | 意味 |
| - | - |
| `@t` | 呼び出しの UTC 時刻 |
| `ResolvedApiPath` | クエリ文字列を除いた PlayFab API のパス |
| `TitleId` | 呼び出しの対象となった PlayFab タイトル。スタジオ API (`/Studio/*`) の場合は `null` |
| `ExitStatus` | 呼び出しが成功した場合は `0`、失敗した場合は `1` |

確認プロンプトで拒否した破壊的な操作は、PlayFab を呼び出さないため、記録されません。

## ログを書き込めない場合

コマンドはそのまま実行されて同じ結果を返し、記録が欠落していることがわかるように、CLI は stderr に
警告を出力します。

## 監査ログとテレメトリ

監査ログは[テレメトリ](https://docs.xbox.com/ja-jp/tools/xbox-cli/telemetry.md)の一部ではありません。

| | テレメトリ | 監査ログ |
| - | - | - |
| 送信先 | Microsoft | 自分のマシンのみ |
| PlayFab タイトル ID | 記録されない | 記録される |
| 既定 | オン (オプトアウト) | オフ (オプトイン) |


## Related topics

- [監査ログ](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/gamemanager/audit-logs.md)
- [PlayFab リリース ノート 2015](https://docs.xbox.com/ja-jp/services/playfab/release-notes/2015.md)
- [PlayFab ライブ サービス管理ドキュメント](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/index.md)
- [XBOX CLI](https://docs.xbox.com/ja-jp/tools/xbox-cli/index.md)
- [Game Manager リファレンス](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/gamemanager/reference.md)
