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

# De LogBrew CLI installeren en gebruiken

> Installeer de LogBrew CLI op macOS, Linux of Windows. Log in, kies een project en onderzoek issues met JSON-uitvoer.

Met de LogBrew-opdrachtregelinterface (CLI) lees je logs, issues, traces en
acties vanuit een terminal. De CLI kan ook de issuestatus wijzigen. Gebruik
`--json` voor gestructureerde uitvoer naar scripts en AI-agents.

Vervang elke placeholder tussen punthaken voordat je een opdracht uitvoert.
Gebruik project-, issue- en trace-ID's die LogBrew heeft teruggegeven.

## <span id="install-the-cli">De CLI installeren</span>

Kies één installatiemethode.

macOS of Linux:

```bash theme={null}
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/LogBrewCo/cli/releases/latest/download/logbrew-cli-installer.sh | sh
```

Windows (PowerShell):

```powershell theme={null}
powershell -ExecutionPolicy Bypass -c "irm https://github.com/LogBrewCo/cli/releases/latest/download/logbrew-cli-installer.ps1 | iex"
```

Homebrew:

```bash theme={null}
brew install LogBrewCo/tap/logbrew
```

npm:

```bash theme={null}
npm install -g logbrew-cli@latest
```

Cargo:

```bash theme={null}
cargo install logbrew-cli
```

Op Windows kun je ook de MSI installeren uit de
[nieuwste release](https://github.com/LogBrewCo/cli/releases/latest).

<Note>
  Cargo heeft Rust 1.87 of nieuwer nodig. De andere methoden installeren een
  native binary en hebben geen Rust nodig.
</Note>

## <span id="update-the-cli">De CLI bijwerken</span>

De CLI werkt zichzelf niet bij. Gebruik dezelfde methode waarmee je de CLI hebt
geïnstalleerd.

Homebrew:

```bash theme={null}
brew update && brew upgrade LogBrewCo/tap/logbrew
```

npm:

```bash theme={null}
npm install -g logbrew-cli@latest
```

Cargo:

```bash theme={null}
cargo install --locked logbrew-cli
```

Heb je de shell- of PowerShell-installer gebruikt? Voer de installer dan
opnieuw uit.

Lees daarna de versie. Vergelijk die met de
[nieuwste release](https://github.com/LogBrewCo/cli/releases/latest):

```bash theme={null}
logbrew version --json
```

De JSON bevat `ok`, `name`, `version`, `binary`, `os` en `arch`.

## <span id="sign-in-and-verify-the-session">Inloggen en de sessie controleren</span>

Lees uit welk account deze terminal gebruikt:

```bash theme={null}
logbrew status --json
logbrew whoami --json
```

Toont `whoami` het verwachte account? Ga dan verder. Zo niet, log dan in. Een
persoon rondt het inloggen bij de provider af in de browser. Een coding agent
moet een persoon vragen om deze stap te doen.

```bash theme={null}
logbrew login --provider github
```

De provider is `github` (standaard), `gitlab` of `bitbucket`. Gebruik
`--no-open` om de login-URL te tonen zonder een browser te openen. Ook `--json`
toont de login-overdracht zonder een browser te openen.

Voer na het inloggen opnieuw `status` en `whoami` uit. Zet geen
toegangsgegevens van je account in een prompt, rapport of bronbestand.

## <span id="plan-sdk-setup">De SDK-installatie plannen</span>

Ga naar de map met het pakket- of buildmanifest van de app. Kies in een
monorepo één app of service. Voer daarna uit:

```bash theme={null}
logbrew setup --json
```

Lees `detected`, `install_ready`, `install_plan` en `next`. Het plan noemt de
runtime, het framework, de pakketbeheerder en de installatieopdracht. De CLI
installeert geen pakketten en wijzigt geen bestanden. `logbrew init`,
`install`, `configure` en `sdk` geven hetzelfde plan.

<Warning>
  Zet een ingest-sleutel van het project in de SDK-configuratie. Gebruik nooit
  toegangsgegevens van je account als SDK-sleutel. Houd ingest-sleutels buiten
  versiebeheer.
</Warning>

Zie [SDK-integratie](/nl/guides/sdk-ingestion) voor de stappen per runtime.
Voer `logbrew examples` uit voor een korte lijst met veelgebruikte opdrachten.

## <span id="read-create-and-configure-projects">Projecten lezen, aanmaken en instellen</span>

Toon de actieve projecten in je account:

```bash theme={null}
logbrew projects --json
```

Kies een project-ID uit het resultaat. Gebruik dat ID voor sleutels en
leesacties.

Wil je een ingest-sleutel maken voor een bestaand project? Kies dan een nieuw
bestand buiten versiebeheer. De CLI schrijft de sleutel naar dat bestand, dat
alleen voor de eigenaar toegankelijk is. De CLI toont de sleutel en het
bestandspad niet.

```bash theme={null}
logbrew projects keys create "<project_id>" --ingest-key-file "<private_key_file>" --json
```

| Optie | Waarde |
| - | - |
| `--kind` | `sdk` (standaard), `browser`, `server`, `cli` of `artifact`. Met een `artifact`-sleutel upload je source maps en native debugbestanden. Telemetrie verzenden kan er niet mee. |
| `--label` | Een naam voor de sleutel, maximaal 120 tekens. De standaardwaarde is `CLI-created SDK key`. |

Het JSON-resultaat bevat `status`, `project_id`, `ingest_key`, `checks` en
`next`. `ingest_key` bevat de `id`, `label`, `kind`, `created_at` en
`expires_at` van de sleutel. Zie
[Een ingest-sleutel roteren](/nl/guides/rotate-ingest-key) om een sleutel te
vervangen.

Deze opdracht maakt toegangsgegevens aan. Controleer of het project klopt
voordat je de opdracht uitvoert. Is het resultaat onzeker? Voer dan dezelfde
opdracht opnieuw uit. De CLI hergebruikt dan de lopende poging. Gebruik
`--abandon-retry` alleen om een nieuwe poging te starten.

Volg de [snelstart](/nl/quickstart) om een nieuw project te maken. Die gebruikt
`logbrew projects create "<name>" --ingest-key-file "<private_key_file>"`, dat
de eerste sleutel op dezelfde manier opslaat. Voer
`logbrew setup --create-project` uit om de helptekst voor het maken van een project
te lezen. Die opdracht maakt geen project aan.

Na een installatiestap kun je die stap voor het project registreren. De waarde
van `--source` is `api`, `cli` of `sdk`:

```bash theme={null}
logbrew projects setup "<project_id>" --source cli --environment production --json
```

Lees daarna of het project klaar is:

```bash theme={null}
logbrew doctor --project "<project_id>" --json
```

Exitcode `0` betekent niet dat alle controles zijn geslaagd. Lees de `status`
van het rapport en elke controle. Zie de [referentie voor het
doctor-rapport](/nl/reference/cli#read-a-project-doctor-report).

## <span id="read-account-usage">Accountgebruik lezen</span>

Lees je gebruik en je limieten. Dit verandert niets aan je account of je
facturering.

```bash theme={null}
logbrew usage --json
```

`logbrew account usage --json` geeft hetzelfde resultaat. De response bevat je
abonnement, de status van je quotum, de resetdatum, het totale gebruik per
project en per soort telemetrie, en een volgende stap. Velden zijn onder meer
`plan`, `state`, `reset_at`, `by_project`, `by_stream` en `next`.

## <span id="common-investigations">Veelvoorkomende onderzoeken</span>

Filter elke leesactie op project. Voeg filters voor release, omgeving, tijd
of ernst toe als de opdracht ze ondersteunt. Zie
[Filters](/nl/reference/cli#filters).

<CardGroup cols={2}>
  <Card title="Issues in een release" icon="tag">
    ```bash theme={null}
    logbrew read issues --project "<project_id>" --release api@1.2.3 --status unresolved --json
    ```
  </Card>

  <Card title="Eén mislukt request" icon="route">
    ```bash theme={null}
    logbrew read trace "<trace_id>" --project "<project_id>" --json
    ```
  </Card>

  <Card title="Logs van een release" icon="file-text">
    ```bash theme={null}
    logbrew read logs --project "<project_id>" --release api@1.2.3 --since 24h --json
    ```
  </Card>

  <Card title="Issues die aan jou zijn toegewezen" icon="user">
    ```bash theme={null}
    logbrew read issues --project "<project_id>" --assignee me --status unresolved --json
    ```
  </Card>
</CardGroup>

## <span id="watch-live-events">Live-events volgen</span>

Gebruik watch om nieuwe events te zien terwijl je een wijziging test. Druk op
Ctrl+C om te stoppen.

```bash theme={null}
logbrew watch --severity error,critical --json
```

Watch streamt alleen JSON. Zonder `--json` stopt de opdracht met een fout.
Voeg `logs`, `issues` of `actions` toe om één type te volgen, zoals
`logbrew watch logs --json`. Watch ondersteunt geen traces of spans.

Watch heeft geen filter voor project, release of omgeving. Gebruik voor één
project de leesacties hierboven. Zie [Live volgen](/nl/reference/cli#live-watch)
voor de ondersteunde resources en filters.

## <span id="explain-before-you-change-code">Eerst de uitleg lezen, dan code wijzigen</span>

Lees de context voordat je een fix voorstelt.

<Steps>
  <Step title="Lees het issue">
    ```bash theme={null}
    logbrew read issue "<issue_id>" --json
    ```
  </Step>

  <Step title="Lees de trace">
    Doe deze stap alleen als het issue een trace-ID heeft. Een issue zonder
    trace is ook geldig.

    ```bash theme={null}
    logbrew read trace "<trace_id>" --project "<project_id>" --json
    ```
  </Step>

  <Step title="Lees de uitleg">
    ```bash theme={null}
    logbrew explain issue "<issue_id>" --json
    ```

    Gebruik voor een log `logbrew explain log "<log_id>" --json`. Gebruik voor
    een actie `logbrew explain action "<action_id>" --json`.
  </Step>

  <Step title="Los het issue op na verificatie">
    ```bash theme={null}
    logbrew set issue "<issue_id>" resolved --json
    ```

    Wil je de status, prioriteit of toewijzing van veel issues wijzigen? Zie
    [Issuestatus en prioriteit wijzigen](/nl/reference/cli#change-issue-status-and-priority)
    en de [issueworkflow](/nl/guides/issue-workflow).
  </Step>
</Steps>

## <span id="json-output">JSON-uitvoer</span>

* Zet `--json` vóór of na de opdracht, zoals `logbrew --json status` of
  `logbrew status --json`.
* Lees de exitcode voordat je de uitvoer gebruikt.
* JSON-fouten bevatten `ok`, `error`, `message` en `next`. Een time-out bewijst
  niet dat een schrijfactie is mislukt. Lees de regels voor nieuwe pogingen
  voordat je een schrijfactie herhaalt.
* Automatiseer niet met uitvoer zonder `--json`. Die uitvoer kan veranderen.

Zie [Resultaten en fouten lezen](/nl/reference/cli#read-results-and-errors) voor
exitcodes en voorbeelden van fouten.


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