docs.logbrew.co
Sito completo della documentazione
Usa il sito dedicato alla documentazione per configurazioni dettagliate, dettagli dell’API ed esempi che non devono affollare le pagine del prodotto.
Apri il sito della documentazioneConfigura la telemetria LogBrew
Scegli un’app o un framework, crea un progetto e verifica un segnale sicuro.
Scegli la piattaforma
Scegli l’app o il framework che invia la telemetria. Fai la stessa scelta in Aggiungi progetto.
Comando di installazione
Prima esecuzione riuscita dell’SDK
Mantieni la prima sessione essenziale: installa il pacchetto, crea il progetto, invia un’azione di prodotto senza dati segreti, poi confermala in LogBrew.
- 1Installa l’SDKUsa i pacchetti Node per un servizio backend che ha bisogno di log, span, azioni, release e metriche.
npm install @logbrew/sdk @logbrew/nodeCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio. - 2Crea il progettoApri Aggiungi progetto, scegli una piattaforma e copia la credenziale di ingestione. Il pannello di configurazione la mostra una sola volta.Apri Aggiungi progetto
- 3Invia un’azione di prodottoEsegui l’esempio incluso nel pacchetto prima di integrare il codice di produzione, così la prima struttura è nota e senza token.
node node_modules/@logbrew/node/examples/first-useful-telemetry.mjsCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio. - 4Verifica in LogBrewLeggi il primo segnale info nei log prima di aggiungere altra strumentazione.
logbrew logs info --jsonCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.
Dai a un agente la mappa pubblica di LogBrew prima che modifichi la tua app o il comando di configurazione.
curl -L https://logbrew.co/llms.txtCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.prompt di installazioneCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.
Apri la guida per agentiLeggi https://logbrew.co/llms.txt, poi scegli la scheda SDK corrispondente in https://logbrew.co/en/docs#docs-sdk-choice-title. Usa npm install @logbrew/sdk @logbrew/node solo per un servizio Node.js lato server; per Next.js, React, iOS, Android o React Native, usa la scheda scelta e il prompt di Aggiungi progetto. Chiedi all'utente che ha effettuato l'accesso di aprire Aggiungi progetto e di inserire le credenziali solo nell'ambiente dell'app corrispondente. Per Node.js lato server, la variabile d'ambiente è LOGBREW_SERVER_API_KEY. Esegui node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs solo per i servizi Node, poi verifica con logbrew logs info --json. Non chiedere credenziali in chat o nei commit.Configura un servizio Node.js e verifica la sua prima telemetria. Aggiungi progetto crea il progetto e mostra una sola volta la sua credenziale di ingestione. I passaggi seguenti coprono installazione e verifica.
Aggiungi i pacchetti dell’SDK JavaScript
Parti dall’SDK principale e dall’helper Node quando un servizio backend ha bisogno di log, span delle richieste, azioni, release e metriche.
npm install @logbrew/sdk @logbrew/nodeCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.Crea il progetto da Aggiungi progetto
Accedi, apri Aggiungi progetto, scegli una piattaforma e copia la credenziale di ingestione. Viene mostrata una sola volta. Il sito web non la mostra di nuovo dopo che hai lasciato il pannello di configurazione.
Apri Aggiungi progettoEsegui l’esempio del primo segnale SDK
Usa l’esempio del pacchetto installato per esaminare la struttura di release, ambiente, span della richiesta, azione di prodotto, tappa di rete e metrica prima di integrare la tua app.
node node_modules/@logbrew/node/examples/first-useful-telemetry.mjsCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.Leggi il primo segnale in LogBrew
Dopo che l’SDK ha inviato un segnale info con la credenziale del progetto, usa la CLI o la vista dei log nella dashboard per confermare che sia arrivato prima di aggiungere altra strumentazione.
logbrew logs info --jsonCopiato. Incollalo nel terminale o nell’assistente, poi passa al prossimo passaggio.
Testo semplice
Copia Markdown della documentazione
Usa la copia Markdown localizzata quando un agente o un flusso nel terminale ha bisogno della stessa documentazione senza lo stato del browser.
Apri MarkdownTesto semplice
Copie per agenti
Usa llms.txt, le copie Markdown, robots e sitemap quando un agente ha bisogno di percorsi di lettura pubblici prevedibili.
Apri llms.txtConfigura
Controlla se LogBrew è pronto
Esegui prima status per confermare raggiungibilità, stato dell’accesso e la prossima lettura sicura.
logbrew status --jsonTriage
Parti dagli errori più recenti
Leggi i log di errore recenti, poi passa a problemi o tracce quando una release o un progetto richiede contesto.
logbrew logs error --jsonCondividi
Condividi una vista stabile dei problemi
Elenca i problemi aperti quando un collega ha bisogno degli stessi gruppi di errori.
logbrew issues open --jsonMappa dei comandi
Stato
Controlla autenticazione locale, raggiungibilità dell’API e passaggi di ripristino prima di qualsiasi lettura privata.
logbrew status --jsonMappa dei comandi
Log
Parti dagli errori recenti quando una release, un progetto o una traccia richiede contesto.
logbrew logs error --jsonMappa dei comandi
Problemi
Elenca i gruppi di errori aperti prima di decidere se risolverli, chiuderli, ignorarli o riaprirli.
logbrew issues open --jsonMappa dei comandi
Dettaglio traccia
Leggi un ID traccia noto quando log o problemi indicano una singola richiesta non riuscita.
logbrew trace <trace_id> --jsonMappa dei comandi
Azioni
Filtra gli eventi degli utenti per nome quando il contesto importante è un’azione di prodotto.
logbrew actions --name checkout_failed --jsonMappa dei comandi
Release
Confronta il contesto del rilascio con i conteggi di log, problemi, span delle tracce e azioni.
logbrew releases --jsonPrima la CLI
Controlla autenticazione locale e raggiungibilità dell’API
La prima lettura deve dirti se la CLI raggiunge l’API di LogBrew senza esporre materiale dei token.
- Usa la modalità JSON quando uno script o un’automazione ha bisogno di campi stabili.
- Usa l’output leggibile quando uno sviluppatore ha bisogno del prossimo comando.
- Fai in modo che il ripristino dell’autenticazione rimandi sempre ad accesso e stato.
Osserva
Leggi i segnali di produzione per risorsa
Parti dal segnale che risponde alla tua domanda. Apri i suoi dettagli per vedere le prove correlate.
- I log mantengono i filtri per gravità, release, ambiente, progetto, traccia e ricerca.
- Controlla lo stato e l’ultima occorrenza di un problema prima di indagare.
- Le tracce mantengono nomi degli span, contesto di release, contesto di ambiente e ambito del progetto.
Condividi
Invia contesto utile senza esporre i dati del progetto
Usa la documentazione pubblica, il Markdown e i comandi copiabili quando qualcuno ha bisogno di aiuto con la configurazione o di un passaggio di consegne sicuro.
- Condividi un link alla documentazione quando il prossimo passo è la configurazione o la scoperta dei comandi.
- Condividi il Markdown quando il testo semplice è più comodo di uno screenshot.
- Condividi i dati privati del progetto solo con chi ha il permesso di vederli.
Letture API
Scegli il progetto e l’intervallo di tempo
Usa il riferimento dell’API di telemetria per route, filtri ed esempi di successo e di errore supportati.
- Autenticati prima di richiedere dati privati del progetto.
- Seleziona il progetto e l’intervallo di tempo prima di confrontare i risultati.
- Segui i passaggi di ripristino restituiti quando una richiesta non riesce.
- Tieni le prove mancanti separate da quelle che non è stato possibile caricare.