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

# Dateiprotokollierung

> Mit der experimentellen Dateiprotokollierungs-API von ServerRpc im Laravel Copilot SDK schreiben Sie maskierte Logs über den Logger der Runtime an ein vom Host genehmigtes Ziel.

## Dateiprotokollierung

Geltungsbereich: ServerRpc (serverweite Operationen, die an den Client gebunden sind)

Eine Übersicht über RPC und die Liste aller RPC-Seiten finden Sie unter [RPC](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md).

`logging()->file()` schreibt Logs über den Logger der Runtime an ein Ziel, das der native Host erlaubt. In der Anfrage können Sie keinen Dateipfad angeben. Diese API ist experimentell.

## Logger öffnen und schreiben

`open()` gibt eine opake `logId` zurück. Die Runtime maskiert die in `secretValues` registrierten Werte in jeder Nachricht. Lassen Sie Ihre Schreibvorgänge der Reihe nach abschließen und rufen Sie dann `flush()` oder `close()` auf.

```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` akzeptiert `log`, `debug`, `info`, `notice`, `warning`, `error`, `startGroup` und `endGroup`. Übergeben Sie bei `endGroup` einen leeren String als `message`.

## Flush und Schließen

```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()` wartet, bis alle vorherigen Schreibvorgänge die Datei erreicht haben, und meldet eventuelle Fehler. `close()` führt ebenfalls ein Flush aus und schließt dann den Logger. Nach dem Schließen können Sie dieselbe `logId` nicht mehr verwenden.


## Related topics

- [ServerRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/server-overview.md)
- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)


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