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

# Registro en archivos

> Usa la API experimental de registro en archivos de ServerRpc en Laravel Copilot SDK para escribir logs enmascarados mediante el logger del runtime en un destino aprobado por el host.

## Registro en archivos

Ámbito: ServerRpc (operaciones de todo el servidor vinculadas al Client)

Para una visión general de RPC y la lista de todas las páginas de RPC, consulta [RPC](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md).

`logging()->file()` escribe logs mediante el logger del runtime en un destino que permite el host nativo. No puedes indicar una ruta de archivo en la solicitud. Esta API es experimental.

## Abrir un logger y escribir en él

`open()` devuelve un `logId` opaco. El runtime enmascara en cada mensaje los valores que registres en `secretValues`. Deja que tus escrituras terminen en orden y luego llama a `flush()` o `close()`.

```php theme={null}
use Revolution\Copilot\Enums\FileLogLevel;
use Revolution\Copilot\Enums\FileLogOperation;
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Types\Rpc\LoggingFileOpenRequest;
use Revolution\Copilot\Types\Rpc\LoggingFileWriteRequest;

$fileLogger = Copilot::client()->rpc()->logging()->file();

$opened = $fileLogger->open(new LoggingFileOpenRequest(
    level: FileLogLevel::Info,
    debugEnvironmentVariables: ['APP_DEBUG'],
    secretValues: [$secret],
));

$fileLogger->write(new LoggingFileWriteRequest(
    logId: $opened->logId,
    operation: FileLogOperation::Info,
    message: 'Background task started',
));

$fileLogger->write(new LoggingFileWriteRequest(
    logId: $opened->logId,
    operation: FileLogOperation::StartGroup,
    message: 'Processing items',
    groupLevel: FileLogLevel::Debug,
));
```

`FileLogOperation` acepta `log`, `debug`, `info`, `notice`, `warning`, `error`, `startGroup` y `endGroup`. Para `endGroup`, pasa una cadena vacía como `message`.

## Vaciar y cerrar

```php theme={null}
use Revolution\Copilot\Types\Rpc\LoggingFileCloseRequest;
use Revolution\Copilot\Types\Rpc\LoggingFileFlushRequest;

$fileLogger->flush(new LoggingFileFlushRequest($opened->logId));
$fileLogger->close(new LoggingFileCloseRequest($opened->logId));
```

`flush()` espera hasta que todas las escrituras anteriores lleguen al archivo e informa de cualquier error. `close()` también vacía el logger y después lo cierra. Tras cerrarlo, no puedes volver a usar el mismo `logId`.


## Related topics

- [Resumen de ServerRpc](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [RPC (Remote Procedure Call)](https://kawax.biz/es/packages/laravel-copilot-sdk/rpc.md)
- [Registro de rutas y caché en paquetes](https://kawax.biz/es/advanced/package-routes.md)
- [Registro y nueva resolución de drivers de Storage en paquetes](https://kawax.biz/es/advanced/package-filesystem-drivers.md)
- [Registro dinámico de relaciones en paquetes](https://kawax.biz/es/advanced/package-dynamic-relations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.