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

# Registro de auditoría

> Mantén un registro local, opcional y solo de metadatos de las operaciones de PlayFab que realiza la CLI.

La XBOX CLI puede mantener un registro local de qué operaciones de PlayFab ejecutó, en
qué título y cuándo. Úsalo para ver después lo que hiciste tú o un agente que ejecuta la CLI por ti.
El registro está desactivado de forma predeterminada, permanece en tu máquina y no contiene cuerpos de solicitud, respuestas,
tokens ni identidades.

El registro solo recoge llamadas a PlayFab. Los comandos que trabajan con Partner Center y los servicios XBOX,
como `xbox xbl` y `xbox game`, no se registran.

## Activar el registro de auditoría

Establece `XBOX_AUDITLOG__ENABLED` en `true`. En bash o zsh:

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

En PowerShell:

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

## Ubicación del registro

La CLI escribe un archivo al día y conserva los 31 más recientes:

| Plataforma | Ruta |
| - | - |
| Windows | `%LOCALAPPDATA%\XboxDevCLI\audit<date>.jsonl` |
| Linux | `$XDG_DATA_HOME/XboxDevCLI/audit<date>.jsonl`, con `~/.local/share` como valor predeterminado |
| macOS | `~/Library/Application Support/XboxDevCLI/audit<date>.jsonl` |

Los archivos no tienen límite de tamaño, así que, si realizas muchas llamadas a la API al día, vigila el espacio en disco.

## Qué se registra

Cada llamada a PlayFab agrega una línea de [JSON compacto](https://clef-json.org/), tanto si la llamada
lee como si cambia algo:

```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 de la llamada |
| `ResolvedApiPath` | La ruta de la API de PlayFab, sin cadena de consulta |
| `TitleId` | El título de PlayFab al que se dirigió la llamada, o `null` para una API de estudio (`/Studio/*`) |
| `ExitStatus` | `0` si la llamada se realizó correctamente, `1` si produjo un error |

Una operación destructiva que rechazas en el mensaje de confirmación no se registra, porque
nunca llama a PlayFab.

## Cuando no se puede escribir el registro

El comando se sigue ejecutando y devuelve el mismo resultado, y la CLI muestra una advertencia en stderr para
que sepas que falta el registro.

## Registro de auditoría y telemetría

El registro de auditoría no forma parte de la [telemetría](https://docs.xbox.com/es/tools/xbox-cli/telemetry.md):

| | Telemetría | Registro de auditoría |
| - | - | - |
| Destino | Microsoft | Solo tu máquina |
| Id. de título de PlayFab | Nunca se registran | Se registran |
| Valor predeterminado | Activada; se puede desactivar | Desactivado; se debe activar |


## Related topics

- [Registros de auditoría](https://docs.xbox.com/es/services/playfab/live-service-management/gamemanager/audit-logs.md)
- [Notas de la versión de PlayFab de 2015](https://docs.xbox.com/es/announcements/playfab/2015.md)
- [Notas de la versión de PlayFab 2015](https://docs.xbox.com/es/services/playfab/release-notes/2015.md)
- [XBOX CLI](https://docs.xbox.com/es/tools/xbox-cli/index.md)
- [Referencia de Game Manager](https://docs.xbox.com/es/services/playfab/live-service-management/gamemanager/reference.md)
