> ## 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 的代理执行了哪些操作。该日志默认处于关闭状态,仅保留在你的计算机上,
并且不包含请求正文、响应、令牌或身份信息。

该日志仅记录 PlayFab 调用。使用 Partner Center 和 XBOX 服务的命令(例如 `xbox xbl` 和 `xbox game`)不会被记录。

## 启用审核日志

将 `XBOX_AUDITLOG__ENABLED` 设置为 `true`。在 bash 或 zsh 中:

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

在 PowerShell 中:

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

## 日志的存储位置

CLI 每天写入一个文件,并保留最近的 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` |

这些文件没有大小限制,因此如果你每天进行大量 API 调用,请注意磁盘空间。

## 记录的内容

每次 PlayFab 调用都会添加一行[紧凑 JSON](https://clef-json.org/),无论该调用是读取还是更改内容:

```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/zh-CN/tools/xbox-cli/telemetry.md):

| | 遥测 | 审核日志 |
| - | - | - |
| 目标位置 | Microsoft | 仅你的计算机 |
| PlayFab 游戏 ID | 从不记录 | 记录 |
| 默认值 | 开启;可选择退出 | 关闭;可选择启用 |


## Related topics

- [PlayFab 2015 年发行说明](https://docs.xbox.com/zh-CN/announcements/playfab/2015.md)
- [XBOX CLI](https://docs.xbox.com/zh-CN/tools/xbox-cli/index.md)
- [配置](https://docs.xbox.com/zh-CN/tools/xbox-cli/configuration.md)
- [审计日志](https://docs.xbox.com/zh-CN/services/playfab/live-service-management/gamemanager/audit-logs.md)
- [使用文本审核](https://docs.xbox.com/zh-CN/services/playfab/community/voice-communications/concepts-text-moderation.md)
