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

# Logs, Shell, Nutzung, Telemetrie und Authentifizierung

> Mit SessionRpc des Laravel Copilot SDK nutzen Sie Logs, Shell, Nutzung, Telemetrie, Authentifizierung und die Kontoauswahl.

## Logs, Shell, Nutzung, Telemetrie und Authentifizierung

Geltungsbereich: SessionRpc (sessionbezogene Operationen, die an eine Session 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).

```php theme={null}
// log: Nachrichten in der Session-Timeline protokollieren
$session->rpc()->log()->log(new LogRequest(message: 'Processing started'));
$session->rpc()->log()->log(new LogRequest(message: 'Disk usage is high', level: LogLevel::WARNING));
$session->rpc()->log()->log(new LogRequest(message: 'An error occurred', level: LogLevel::ERROR));
$session->rpc()->log()->log(new LogRequest(message: 'Debug info', ephemeral: true));

// shell: Shell-Befehle innerhalb der Session ausführen
$result = $session->rpc()->shell()->exec(new ShellExecRequest(command: 'ls -la'));
// Über $result->processId die Prozess-ID abrufen und für kill oder das Verfolgen der Ausgabe verwenden

$session->rpc()->shell()->exec(new ShellExecRequest(
    command: 'npm test',
    cwd: '/path/to/project',
    timeout: 60000, // Millisekunden
));

// Laufenden Shell-Prozess stoppen
$session->rpc()->shell()->kill(new ShellKillRequest(
    processId: $result->processId,
    signal: 'SIGTERM', // SIGTERM (Standard), SIGKILL, SIGINT
));

// Vom Benutzer angeforderten Shell-Befehl abbrechen
use Revolution\Copilot\Types\Rpc\ShellExecuteUserRequestedRequest;
use Revolution\Copilot\Types\Rpc\ShellCancelUserRequestedRequest;

$execution = $session->rpc()->shell()->executeUserRequested(new ShellExecuteUserRequestedRequest(
    requestId: 'req-123',
    command: 'pwd',
), timeout: 120.0); // Wartezeit auf die CLI-Antwort (Sekunden). Standardmäßig 30 Sekunden
// $execution->toolCallId / success / output / exitCode / error
// Zum Abbrechen während der Ausführung aus einem anderen Ablauf dieselbe requestId angeben

$cancelled = $session->rpc()->shell()->cancelUserRequested(
    new ShellCancelUserRequestedRequest(requestId: 'req-123')
);
// $cancelled->cancelled - Ob der Abbruch erfolgreich war

// usage (experimental: Nutzungsmetriken der Session)
$metrics = $session->rpc()->usage()->getMetrics();
// $metrics->totalPremiumRequestCost - Gesamtkosten der Premium-Anfragen
// $metrics->totalUserRequests - Gesamtzahl der Benutzeranfragen
// $metrics->codeChanges - Metriken zu Codeänderungen (hinzugefügte Zeilen, gelöschte Zeilen, geänderte Dateien)
// $metrics->modelMetrics - Token-Nutzung und Anzahl der Anfragen pro Modell
// $metrics->currentModel - Bezeichner des aktuellen Modells

// telemetry (experimental: Session-Telemetrie)
use Revolution\Copilot\Types\Rpc\TelemetrySetFeatureOverridesRequest;

$telemetry = $session->rpc()->telemetry();
$engagement = $telemetry->getEngagementId();
// $engagement->engagementId - Engagement-ID, falls verfügbar, sonst null

$telemetry->setFeatureOverrides(new TelemetrySetFeatureOverridesRequest(
    features: ['feature-key' => 'override-value'],
));
// Die Overrides werden an spätere Telemetrie-Events angehängt und ersetzen vorherige Overrides.
// Dies ist unabhängig von SessionConfig::$enableSessionTelemetry (aktiviert die interne Telemetrie).

// auth: Authentifizierungsstatus der Session abrufen
$status = $session->rpc()->gitHubAuth()->getStatus();
// $status->isAuthenticated - Ob authentifiziert
// $status->authType - Authentifizierungstyp (AuthInfoType enum: gh-cli, token, env usw.)
// $status->login - GitHub-Anmeldename
// $status->host - GitHub-Host
// $status->copilotPlan - Copilot-Plan (individual, business usw.)
// $status->statusMessage - Meldung zum Authentifizierungsstatus
```

## accounts (Kontoauswahl für die interaktive Anmeldung)

Mit `accounts()` zählen Sie die gespeicherten Konten auf, die für die Anmeldung verfügbar sind, und starten eine interaktive Anmeldung. Das `label` jedes Eintrags dient der Anzeige, und `active` gibt an, ob die Identität mit dem aktiven Konto der aktuellen Session übereinstimmt. `accountId` ist eine undurchsichtige ID, die dem Provider gehört. Übergeben Sie sie unverändert an die Anmeldeanfrage, ohne sie zu parsen oder zu verändern.

```php theme={null}
use Revolution\Copilot\Enums\AuthLoginMode;
use Revolution\Copilot\Enums\LoginProviderKind;
use Revolution\Copilot\Types\Rpc\AuthLoginBeginRequest;

$accounts = $session->rpc()->accounts();
$identities = $accounts->enumerate(
    'loginAccounts',
    provider: LoginProviderKind::ENTRA,
);

if (isset($identities[0])) {
    $accounts->begin(new AuthLoginBeginRequest(
        kind: LoginProviderKind::ENTRA,
        mode: AuthLoginMode::Default,
        accountId: $identities[0]->accountId,
    ));
}
```

Verwenden Sie `mode: 'default'`, um eine gespeicherte Identität mit dem normalen Verhalten des Providers wiederzuverwenden. Verwenden Sie `mode: 'selectAccount'`, um ausdrücklich die Kontoauswahl des Providers anzuzeigen. Übergeben Sie in diesem Fall kein `accountId`. Details finden Sie unter [Authentifizierung](https://kawax.biz/de/packages/laravel-copilot-sdk/auth.md).


## Related topics

- [RPC (Remote Procedure Call)](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc.md)
- [Telemetrie](https://kawax.biz/de/packages/laravel-copilot-sdk/telemetry.md)
- [Einführung in die Authentifizierung](https://kawax.biz/de/authentication.md)
- [SessionRpc-Übersicht](https://kawax.biz/de/packages/laravel-copilot-sdk/rpc/session-overview.md)
- [PHP, Composer und Node.js mit WSL installieren (Windows)](https://kawax.biz/de/blog/windows-setup.md)


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