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

# Log de auditoria

> Mantenha um registro local, opcional e somente de metadados das operações do PlayFab que a CLI executa.

A XBOX CLI pode manter um registro local de quais operações do PlayFab ela executou, em qual
título e quando. Use-o para ver depois o que você, ou um agente executando a CLI para você,
fez. O log fica desativado por padrão, permanece no seu computador e não contém corpos de solicitação, respostas,
tokens nem identidade.

O log registra somente chamadas ao PlayFab. Os comandos que trabalham com o Partner Center e os serviços do XBOX,
como `xbox xbl` e `xbox game`, não são registrados.

## Ativar o log de auditoria

Defina `XBOX_AUDITLOG__ENABLED` como `true`. No bash ou zsh:

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

No PowerShell:

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

## Onde o log fica

A CLI grava um arquivo por dia e mantém os 31 mais recentes:

| Plataforma | Caminho |
| - | - |
| Windows | `%LOCALAPPDATA%\XboxDevCLI\audit<date>.jsonl` |
| Linux | `$XDG_DATA_HOME/XboxDevCLI/audit<date>.jsonl`, com padrão `~/.local/share` |
| macOS | `~/Library/Application Support/XboxDevCLI/audit<date>.jsonl` |

Os arquivos não têm limite de tamanho; portanto, se você fizer muitas chamadas de API por dia, fique atento ao espaço em disco.

## O que é registrado

Cada chamada ao PlayFab adiciona uma linha de [JSON compacto](https://clef-json.org/), seja a chamada
de leitura ou de alteração:

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

| Campo | Significado |
| - | - |
| `@t` | Hora UTC da chamada |
| `ResolvedApiPath` | O caminho da API do PlayFab, sem cadeia de consulta |
| `TitleId` | O título do PlayFab ao qual a chamada se destinou, ou `null` para uma API de estúdio (`/Studio/*`) |
| `ExitStatus` | `0` quando a chamada foi bem-sucedida, `1` quando falhou |

Uma operação destrutiva que você recusa no prompt de confirmação não é registrada, porque
ela nunca chama o PlayFab.

## Quando o log não pode ser gravado

O comando ainda é executado e retorna o mesmo resultado, e a CLI imprime um aviso em stderr para que
você saiba que o registro está faltando.

## Log de auditoria e telemetria

O log de auditoria não faz parte da [telemetria](https://docs.xbox.com/pt-BR/tools/xbox-cli/telemetry.md):

| | Telemetria | Log de auditoria |
| - | - | - |
| Destino | Microsoft | Somente o seu computador |
| IDs de título do PlayFab | Nunca registradas | Registradas |
| Padrão | Ativada; recusa opcional | Desativado; adesão opcional |


## Related topics

- [Logs de auditoria](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/gamemanager/audit-logs.md)
- [Notas de versão do PlayFab de 2015](https://docs.xbox.com/pt-BR/announcements/playfab/2015.md)
- [Notas de versão do PlayFab 2015](https://docs.xbox.com/pt-BR/services/playfab/release-notes/2015.md)
- [XBOX CLI](https://docs.xbox.com/pt-BR/tools/xbox-cli/index.md)
- [Referência do Game Manager](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/gamemanager/reference.md)
