Skip to main content
L’interfaccia a riga di comando (CLI) di LogBrew legge log, problemi, tracce e azioni da un terminale. Può anche aggiornare lo stato dei problemi. Usa --json per avere un output strutturato per script e agenti IA. Prima di eseguire un comando, sostituisci ogni segnaposto tra parentesi angolari. Usa gli ID di progetto, problema e traccia restituiti da LogBrew.

​
Installa la CLI

Scegli un metodo di installazione. macOS o Linux:
Windows (PowerShell):
Homebrew:
npm:
Cargo:
Su Windows puoi anche installare il pacchetto MSI dall’ultima release.
Cargo richiede Rust 1.87 o successivo. Gli altri metodi installano un binario nativo e non richiedono Rust.

​
Aggiorna la CLI

La CLI non si aggiorna da sola. Usa lo stesso metodo con cui l’hai installata. Homebrew:
npm:
Cargo:
Se hai usato l’installer per shell o PowerShell, eseguilo di nuovo. Poi leggi la versione e confrontala con l’ultima release:
Il JSON restituisce ok, name, version, binary, os e arch.

​
Accedi e verifica la sessione

Leggi l’account associato al terminale corrente:
Se whoami mostra l’account previsto, continua. Altrimenti, accedi. Una persona completa l’accesso al provider nel browser. Un agente di codifica deve chiedere a una persona di eseguire questo passaggio.
Il provider è github (predefinito), gitlab o bitbucket. Usa --no-open per stampare l’URL di accesso senza aprire un browser. Anche --json stampa i dati per completare l’accesso senza aprire un browser. Dopo l’accesso, esegui di nuovo status e whoami. Non inserire le credenziali dell’account in un prompt, in un report o in un file sorgente.

​
Pianifica la configurazione dell’SDK

Vai nella directory che contiene il manifest del pacchetto o della build dell’app. In un monorepo, scegli un’app o un servizio. Poi esegui:
Leggi detected, install_ready, install_plan e next. Il piano di installazione indica runtime, framework, gestore di pacchetti e comando di installazione. La CLI non installa pacchetti e non modifica file. logbrew init, install, configure e sdk restituiscono lo stesso piano.
Nella configurazione dell’SDK inserisci una chiave di ingestione del progetto. Non usare mai una credenziale dell’account come chiave dell’SDK. Tieni le chiavi di ingestione fuori dal controllo di versione.
Per i passaggi specifici di ogni runtime, vedi Invia telemetria con l’SDK. Esegui logbrew examples per un breve elenco dei comandi più comuni.

​
Leggi, crea e configura i progetti

Elenca i progetti attivi del tuo account:
Scegli un ID progetto dal risultato. Usalo per le chiavi e per le letture. Per creare una chiave di ingestione per un progetto esistente, scegli un nuovo file fuori dal controllo di versione. La CLI scrive la chiave in quel file, leggibile solo dal proprietario. Non stampa né la chiave né il percorso del file.
Il risultato JSON contiene status, project_id, ingest_key, checks e next. ingest_key contiene id, label, kind, created_at e expires_at della chiave. Per sostituire una chiave, vedi Ruota una chiave di ingestione. Questo comando crea una credenziale. Prima di eseguirlo, verifica che il progetto sia quello giusto. Se il risultato è incerto, esegui di nuovo lo stesso comando: la CLI riprende il tentativo in sospeso. Usa --abandon-retry solo per avviare un nuovo tentativo. Per creare un nuovo progetto, segui la guida rapida. La guida usa logbrew projects create "<name>" --ingest-key-file "<private_key_file>", che salva la prima chiave allo stesso modo. Esegui logbrew setup --create-project per leggere l’aiuto sulla creazione del progetto. Quel comando non crea un progetto. Dopo un passaggio di configurazione, puoi registrarlo nel progetto. Il valore di --source è api, cli o sdk:
Poi verifica se il progetto è pronto:
Il codice di uscita 0 non significa che tutti i controlli siano superati. Leggi lo status del report e ogni controllo. Vedi il riferimento del report di diagnostica.

​
Leggi l’utilizzo dell’account

Leggi utilizzo e limiti. Questo comando non cambia lo stato dell’account né della fatturazione.
logbrew account usage --json restituisce lo stesso risultato. La risposta indica il piano, lo stato della quota, la data di azzeramento, i totali di utilizzo per progetto e per tipo di telemetria, e un passo successivo. Tra i campi ci sono plan, state, reset_at, by_project, by_stream e next.

​
Indagini comuni

Filtra ogni lettura per progetto. Aggiungi filtri per release, ambiente, tempo o gravità quando il comando li supporta. Vedi Filtri.

Problemi in una release

Una richiesta non riuscita

Log di una release

Problemi assegnati a te

​
Segui gli eventi in tempo reale

Usa watch per vedere i nuovi eventi mentre provi una modifica. Premi Ctrl+C per fermarlo.
Watch trasmette solo JSON. Senza --json, il comando si interrompe con un errore. Aggiungi logs, issues o actions per seguire un solo tipo, come logbrew watch logs --json. Watch non supporta tracce né span. Watch non ha filtri per progetto, release o ambiente. Per un solo progetto, usa le letture qui sopra. Per le risorse e i filtri supportati, vedi Monitoraggio in tempo reale.

​
Spiega prima di modificare il codice

Leggi il contesto prima di proporre una correzione.
1

Leggi il problema

2

Leggi la traccia

Esegui questo passaggio solo se il problema ha un ID traccia. Un problema senza traccia è comunque valido.
3

Leggi la spiegazione

Per un log, usa logbrew explain log "<log_id>" --json. Per un’azione, usa logbrew explain action "<action_id>" --json.
4

Risolvi dopo la verifica

Per cambiare stato, priorità o assegnatario di molti problemi, vedi Cambia stato e priorità dei problemi e il flusso di lavoro dei problemi.

​
Output JSON

  • Metti --json prima o dopo il comando, come logbrew --json status o logbrew status --json.
  • Leggi il codice di uscita prima di usare l’output.
  • Gli errori JSON contengono ok, error, message e next. Un timeout non dimostra che una scrittura sia fallita. Prima di ripetere una scrittura, leggi le sue regole per i nuovi tentativi.
  • Non automatizzare con un output senza --json: può cambiare.
Per i codici di uscita e gli esempi di errori, vedi Leggi risultati ed errori.