Vai al contenuto principale
Usa l’API dell’account per leggere l’utilizzo, lo stato della quota, la cronologia dell’utilizzo e lo stato dell’abbonamento, e per disconnetterti. Le letture dell’account usano un token bearer dell’account o la sessione del browser. Non usare mai una chiave di ingestione del progetto per una richiesta dell’account. Non usare mai una credenziale dell’account nella configurazione dell’SDK o dell’ingestione. Gli errori usano il formato di errore standard dell’API. Una lettura senza un’autenticazione valida dell’account restituisce 401 con code: "unauthorized". Non mostrare questo errore come utilizzo zero, grafico vuoto o piano gratuito. Un metodo non supportato restituisce 405 con code: "method_not_allowed" e next indica la richiesta supportata. L’API dell’account riporta l’utilizzo della telemetria, non importi in denaro. Non riporta addebiti, fatture o stato dei pagamenti.

Utilizzo dell’account

GET /api/account/usage è l’endpoint di riferimento per utilizzo e quota. Usalo per i totali di utilizzo, l’orario di azzeramento, lo stato della quota e le suddivisioni per progetto e per flusso di telemetria. Non calcolare l’utilizzo da file dell’SDK, file della CLI o contatori del client. Il comando CLI logbrew usage legge questo endpoint. Consulta il riferimento della CLI.
Esempio di risposta con valori sintetici. Questo account gratuito ha 1 progetto e nel periodo corrente ha inviato solo log:

Eventi scartati dagli SDK

Invia response_version=2 per ricevere anche sdk_dropped_events. Senza questo parametro, o con response_version=1, la risposta non contiene questo campo.
sdk_dropped_events elenca gli eventi che gli SDK hanno segnalato come scartati prima dell’invio nel periodo corrente, per esempio perché la coda del client era piena. C’è 1 riga per ogni progetto e motivo:
Gli eventi scartati non sono mai arrivati a LogBrew. Non vengono fatturati e non contano in usage, by_project o by_stream. L’array è vuoto quando nessun SDK ha segnalato eventi scartati. L’array conta anche i record OTLP che LogBrew ha rifiutato, con il motivo otlp_rejected_record, oppure usage_limit_exceeded al limite del piano. Questi record sono arrivati a LogBrew, ma LogBrew non li ha salvati. Non vengono fatturati. Vedi OpenTelemetry (OTLP).

Offerta per i nuovi account

Gli account meno recenti hanno ricevuto gratis le quote di Pro per 6 mesi, contati dalla registrazione o, per gli account che esistevano il 2026-10-22, da quella data. Mantengono l’offerta fino al suo ends_at. I nuovi account partono con Free e non ricevono questa offerta. Pro include 1 mese di prova gratuita. Aggiungi una carta per iniziarla; poi si rinnova ogni mese finché non annulli. Invia response_version=3 per ricevere anche offer. Le versioni 1 e 2 non hanno questo campo. La versione 3 ha anche sdk_dropped_events.
offer è null quando nessuna offerta è attiva. Altrimenti ha questi campi:
Finché un’offerta è attiva, limits.retention_days, state, limit, percent_used e next_action usano le quote maggiori tra il piano proprio dell’account e l’offerta. plan mostra ancora il piano proprio dell’account. Dopo ends_at, l’account usa di nuovo il suo piano. Le versioni 1 e 2 seguono le stesse quote, ma non mostrano l’offerta. Il riepilogo di fatturazione, GET /api/billing/overview, ha lo stesso campo offer. Ha anche pro_trial_available, che è true quando un checkout di Pro avvia la prova gratuita.

Stati della quota

Usa state per la scelta principale. limit vale null solo quando state è ok. Questa tabella vale per le versioni 2 e 3. La versione 1, quella predefinita, ha 2 differenze: warning è true anche nello stato blocked, e nello stato warning il valore di next_action.target è account_usage. next_action.state, next_action.limit e next_action.reset_at ripetono i valori di primo livello. I valori di next_action.code includono anche check_usage_limits con il target account_usage. Se il tuo client riceve questa coppia, leggi di nuovo l’utilizzo e mostra next. LogBrew misura ogni tipo di telemetria rispetto alla sua quota. limit le raggruppa:
  • events comprende gli eventi dei problemi e gli span delle tracce.
  • bytes comprende i byte dei log e i byte delle metriche.
Se una quota è bloccata e un’altra è in avviso, limit indica la quota bloccata. Lo stato warning inizia quando l’utilizzo raggiunge warning_threshold di una quota. Lo stato blocked inizia quando l’utilizzo raggiunge la quota. Il testo di next può cambiare, per esempio quando i piani non sono in vendita. I valori di next_action non cambiano. Localizza a partire da next_action. Non analizzare next. Un limite di utilizzo dell’account non è un limite di frequenza dell’API. Quando l’ingestione supera una quota, la richiesta di ingestione restituisce 429 con usage_limit_exceeded e il corpo aggiunge limit e reset_at. In questo errore, limit indica la quota esatta: issue_events, log_bytes, metric_bytes o trace_spans. LogBrew rifiuta l’intera richiesta. Non inviare di nuovo quel tipo di telemetria fino a reset_at o finché il piano non cambia. Quando un client invia troppe richieste, l’API restituisce rate_limited. Consulta Errori API. La risposta è un’istantanea. Leggila di nuovo dopo una modifica all’account.
GET /api/logs/usage è una risposta legacy di compatibilità per mobile, con bytes_used, limit_bytes e month. Per le nuove integrazioni usa GET /api/account/usage.

Cronologia dell’utilizzo

GET /api/account/usage/history restituisce un numero limitato di fasce temporali (bucket) di utilizzo, riempite con zeri, per grafici e report. Imposta interval su un valore supportato. Se ometti interval, l’API usa monthly. La route non accetta altre chiavi di query.
Questa risposta yearly usa dati sintetici per una richiesta di giugno 2026. Tutto l’utilizzo è avvenuto a giugno:
Usa current.reset_at per l’azzeramento della quota. Non usare la fine dell’intervallo della cronologia. current non è la somma delle fasce e le sue date possono essere diverse da quelle dell’intervallo. L’ultima fascia contiene il periodo di calendario corrente, che non è completo. Il suo orario di fine futuro non significa che LogBrew abbia misurato un utilizzo futuro. Una fascia con zeri significa che LogBrew non ha contato alcun utilizzo in quella fascia. In una fascia, usage.projects conta i progetti che hanno un utilizzo in quella fascia. Non sommare questi conteggi per ottenere il numero di progetti. Usa current.usage.projects per il numero di progetti di proprietà. Rappresenta eventi e byte come serie separate, perché usano unità diverse. Le fasce contengono l’utilizzo, non i costi. Non etichettare il grafico come spesa, fatture o richieste API. Un valore di interval non supportato restituisce 422:
Anche una chiave di query sconosciuta restituisce 422 con validation_failed.

Piani e quote

GET /api/billing/catalog elenca i piani. Non richiede autenticazione. Ogni piano ha tutte le funzioni. Ogni piano ha membri e progetti illimitati. I piani differiscono per volume e conservazione. Le quote si azzerano a ogni mese di fatturazione. 1 GB sono 1.000.000.000 di byte. Puoi acquistare Pro e Business con il pagamento online, e checkout_available è true. Per Enterprise, scrivi all’indirizzo quote_email del piano per chiedere un preventivo. Un account con un’offerta per i nuovi account attiva riceve gratis le quote di Pro fino alla fine dell’offerta. Il catalogo e il riepilogo di fatturazione usano i valori tier developer, team, business e enterprise. Le risposte di utilizzo e di abbonamento usano free, pro e scale. I piani Business ed Enterprise sono entrambi scale.
La risposta elenca i piani in quest’ordine. Questo esempio mostra il piano Pro:

Conservazione dei dati

La conservazione è il numero di giorni per cui LogBrew conserva la telemetria di un account. La conservazione dell’account è la maggiore tra quella del suo piano e quella di un’offerta attiva per i nuovi account. Un contratto Enterprise stabilisce la propria conservazione.
  • Le letture restituiscono solo la telemetria compresa nella conservazione.
  • Ogni giorno LogBrew elimina la telemetria dell’account più vecchia della conservazione più 1 giorno.
  • Dopo un downgrade o la fine di un’offerta, la conservazione più breve si applica alla successiva eliminazione giornaliera.

Stato dell’abbonamento

GET /api/account/subscription è di sola lettura. Usalo per decidere se attivare i controlli delle organizzazioni. Per lo stato della quota usa l’endpoint dell’utilizzo.
Un account gratuito restituisce questa risposta. L’account_id è sintetico:
Il valore 9007199254740991 in members_per_organization e projects_per_organization significa illimitato. È il numero intero più grande che i client JSON leggono con esattezza. Mostra «Illimitato» per questo valore. Solo il numero di organizzazioni possedute da un account può bloccare la creazione di un’organizzazione. next è testo da mostrare. Mostra il testo restituito, oppure localizza a partire da next_action. Non fissare nel codice il nome di un piano ricavato da next. Valori enum: L’API non restituisce i motivi di blocco subscription_required e subscription_inactive. Ogni motivo di blocco ha una sola coppia next_action: I valori del tier sono identificatori, non nomi da mostrare. Mantienili invariati in un client localizzato. Controlla organization_creation_allowed prima di attivare la creazione di organizzazioni. Questo endpoint non crea organizzazioni, non invia inviti, non cambia ruoli e non modifica la fatturazione.

Inviti all’organizzazione

Un proprietario o un amministratore dell’organizzazione invita un collega via email. LogBrew invia al collega un’email con un link all’invito. L’invito scade dopo 7 giorni. Questi endpoint mostrano l’invito all’account invitato prima che lo accetti. Un invito è tuo quando è stato inviato all’indirizzo email del tuo account o di un metodo di accesso collegato al tuo account. Elenca i tuoi inviti in sospeso:
La risposta elenca gli inviti in sospeso non scaduti, dal più recente, fino a 100. Gli ID sono sintetici:
Leggi un invito dal suo link:
La risposta è un invito con gli stessi campi. Solo l’account invitato può leggere un invito. Un altro account, un ID invito sconosciuto e un’organizzazione sconosciuta ricevono tutti lo stesso 404 con code: "not_found". Accedi con l’indirizzo email invitato e riprova. Per accettare, invia POST a accept_path con l’account invitato. Una seconda accettazione dello stesso account restituisce la stessa appartenenza. Un invito scaduto o revocato restituisce 422 con code: "invite_invalid". Chiedi un nuovo invito a un proprietario o a un amministratore. Un account può inviare al massimo 20 inviti per giorno UTC, in tutte le sue organizzazioni. L’invito successivo restituisce 429 con code: "invitation_limit_exceeded" e limit: "invitations_per_inviter_per_day". Attendi reset_at. Vedi Errori API.

Disconnessione

Scegli l’ambito più piccolo adatto all’attività. Questi endpoint non eliminano l’account o i suoi progetti, non ruotano le chiavi di ingestione e non revocano l’autorizzazione concessa a un provider di accesso di terze parti.

Un accesso dell’app o della CLI

Invia la richiesta dal client che possiede il token di aggiornamento. Imposta Content-Type: application/json:
Non chiedere mai a una persona o a un agente di stampare o incollare un token di aggiornamento. Una risposta riuscita è 200:
Questa richiesta revoca una famiglia di token di aggiornamento. LogBrew rifiuta i successivi aggiornamenti per quell’accesso. Gli altri accessi dell’account non cambiano. Un token di accesso che il client possiede già resta valido fino alla scadenza. Se le credenziali dell’account potrebbero essere esposte, usa Ogni accesso a LogBrew. Dopo la risposta, il client rimuove le sue credenziali locali. Se invii di nuovo lo stesso token di aggiornamento valido, la risposta è lo stesso 200. Se il token non è valido, è scaduto o è un token di accesso, la risposta è 401 con code: "unauthorized" e next_action.code: "authorize_request". Anche in questo caso, rimuovi le credenziali locali. logbrew logout usa questo endpoint.

Ogni accesso a LogBrew

Questa richiesta disconnette ogni client dell’account. Ottieni l’approvazione del proprietario dell’account prima che un agente la invii.
Una risposta riuscita è 200:
revoked_before è incluso e ha una precisione al millisecondo. LogBrew rifiuta token di accesso, sessioni del browser e token di aggiornamento provenienti da un accesso eseguito in quell’istante o prima. Rifiuta anche un token aggiornato in seguito a partire da un accesso di questo tipo. Le sessioni attive del flusso in tempo reale terminano e la risposta cancella il cookie di sessione del browser. Un accesso eseguito dopo quell’istante resta valido. Ogni client deve rimuovere le proprie credenziali LogBrew locali ed eseguire di nuovo l’accesso. Non eseguire di nuovo l’accesso per poi ripetere questa richiesta in automatico. Una nuova richiesta revoca anche il nuovo accesso. Se la risposta va persa, non dichiarare che tutti gli accessi sono stati revocati. Un successivo 401 da una vecchia credenziale non sostituisce la risposta di successo. Per altri passaggi di ripristino, leggi Proteggi un account compromesso.

Sessione del browser

POST /api/auth/web/logout cancella il cookie logbrew_session del browser e restituisce 204 No Content senza corpo. Chiamalo dal browser. Non copiare il cookie di sessione in un comando. Questa richiesta non disconnette gli altri client e non revoca una copia del valore del cookie. Per revocare ogni sessione, usa Ogni accesso a LogBrew.

Risolvi un errore di disconnessione

Per le route, i filtri e la paginazione della telemetria, leggi API di telemetria.