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.
Eventi scartati dagli SDK
Inviaresponse_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 suoends_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
Usastate 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:
eventscomprende gli eventi dei problemi e gli span delle tracce.bytescomprende i byte dei log e i byte delle metriche.
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:
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:
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.
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.
account_id è sintetico:
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:
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. ImpostaContent-Type: application/json:
200:
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
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.
