> ## 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`과 같이 Partner Center 및 XBOX services를
사용하는 명령은 기록되지 않습니다.

## 감사 로그 켜기

`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/ko/tools/xbox-cli/telemetry.md)의 일부가 아닙니다.

| | 원격 분석 | 감사 로그 |
| - | - | - |
| 대상 | Microsoft | 사용자의 컴퓨터만 |
| PlayFab 타이틀 ID | 기록되지 않음 | 기록됨 |
| 기본값 | 켜짐, 옵트아웃 | 꺼짐, 옵트인 |


## Related topics

- [XBOX CLI](https://docs.xbox.com/ko/tools/xbox-cli/index.md)
- [감사 로그](https://docs.xbox.com/ko/services/playfab/live-service-management/gamemanager/audit-logs.md)
- [PlayFab Party SDK의 진단 추적/로깅](https://docs.xbox.com/ko/services/playfab/multiplayer/networking/party-logging.md)
- [Economy v2의 드롭 테이블 및 무작위 루트](https://docs.xbox.com/ko/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot.md)
- [PlayFab Lobby 및 Matchmaking SDK의 진단 추적/로깅](https://docs.xbox.com/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-logging.md)
