# Configura 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. ## Servizio Node.js Usa il pacchetto Node.js quando un servizio backend ha bisogno di log, span delle richieste, azioni, release e metriche. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Segui il percorso del primo segnale con Node ## Servizio Express Usa il pacchetto Express quando un servizio Node gestisce le richieste tramite middleware Express. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Apri Aggiungi progetto ## Servizio Fastify Usa il pacchetto Fastify quando un servizio Node gestisce le route tramite plugin Fastify. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Apri Aggiungi progetto ## App JavaScript Usa il pacchetto JavaScript per browser nelle pagine frontend che inviano azioni di prodotto, log e segnali client leggeri. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Apri Aggiungi progetto ## App Next.js Usa il pacchetto Next.js quando route, rendering lato server e azioni client richiedono un unico percorso di configurazione. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Apri Aggiungi progetto ## App React Usa il pacchetto React per app web basate su componenti che inviano azioni degli utenti e stato dell’interfaccia. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Apri Aggiungi progetto ## App Angular Usa il pacchetto Angular quando il routing del framework e gli errori dell’app devono condividere un unico percorso di configurazione. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Apri Aggiungi progetto ## App Vue Usa il pacchetto Vue per app Vue che richiedono azioni di prodotto chiare e segnali lato browser. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Apri Aggiungi progetto ## App Svelte Usa il pacchetto Svelte per app Svelte che richiedono un percorso diretto di installazione dell’SDK. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Apri Aggiungi progetto ## Servizio NestJS Usa il pacchetto NestJS quando un servizio Node è organizzato in moduli Nest e gestione delle richieste. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Apri Aggiungi progetto ## Servizio Python Parti dal pacchetto principale per worker e servizi Python. ```bash python3 -m pip install logbrew-sdk ``` Next: Apri Aggiungi progetto ## App Django Usa il pacchetto Django per i segnali delle richieste e dell’app da un progetto Django. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Apri Aggiungi progetto ## Servizio FastAPI Usa il pacchetto FastAPI per API Python con span delle richieste e azioni espliciti. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Apri Aggiungi progetto ## Servizio .NET Installa il pacchetto .NET quando un servizio gestisce i segnali lato server. ```bash dotnet add package LogBrew ``` Next: Apri Aggiungi progetto ## App ASP.NET Core Usa il pacchetto ASP.NET Core quando la gestione delle richieste .NET e i segnali dell’app web richiedono un unico percorso di configurazione. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Apri Aggiungi progetto ## Servizio Java Usa il pacchetto JVM per servizi Java che richiedono log gestiti dall’app, span delle richieste e azioni di prodotto. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Apri Aggiungi progetto ## Servizio Go Aggiungi il pacchetto Go quando un servizio gestisce log, span, metriche e contesto di traccia espliciti. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Apri Aggiungi progetto ## App PHP Usa Composer per servizi PHP e segnali delle richieste gestiti dall’app. ```bash composer require logbrew/sdk ``` Next: Apri Aggiungi progetto ## Servizio Ruby Usa la gem Ruby per servizi Ruby che richiedono segnali espliciti dell’app e delle richieste. ```bash gem install logbrew-sdk ``` Next: Apri Aggiungi progetto ## Servizio Rust Aggiungi il crate Rust per servizi che creano da sé log, span, azioni e metriche. ```bash cargo add logbrew ``` Next: Apri Aggiungi progetto ## App iOS Usa il pacchetto per piattaforme Apple per app iOS che inviano segnali di prodotto espliciti. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Apri Aggiungi progetto ## App Android Usa il pacchetto Android per app che inviano segnali gestiti dall’app dal runtime Android. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Apri Aggiungi progetto ## App React Native Usa il pacchetto React Native per app mobile che condividono azioni di prodotto JavaScript. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Apri Aggiungi progetto ## App Unity Usa il pacchetto Unity per giochi o simulazioni che inviano azioni di prodotto e segnali di runtime. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Apri Aggiungi progetto ## App C Usa i sorgenti C per servizi nativi o app embedded che richiedono un controllo diretto dei segnali. ```bash cc -std=c99 -Wall -Wextra -Wpedantic -Iinclude src/logbrew.c src/logbrew_metric.c src/logbrew_recording_transport.c src/logbrew_timeline.c src/logbrew_trace.c your_app.c -o your_app ``` Next: Apri Aggiungi progetto ## App C++ Esegui il piano della CLI rilasciata in un progetto CMake 3.16+ C++17. Collega LogBrew::LogBrew. Abilita LogBrew::HttpTransport e libcurl solo quando serve la consegna ospitata. ```bash logbrew setup --json ``` Next: Apri Aggiungi progetto ## Il percorso di configurazione in breve Segui questo ordine per passare dalla documentazione a un’azione di prodotto verificata senza uscire dal flusso di configurazione. - Installa. Aggiungi il pacchetto: Parti dal pacchetto SDK per il tuo runtime. - Crea. Crea il progetto: Apri Aggiungi progetto e copia la credenziale del progetto. Viene mostrata una sola volta. - Invia. Invia un’azione di prodotto: Esegui un’azione di prodotto senza dati segreti prima di integrare l’app. - Verifica. Controlla i log: Conferma il segnale nei log o con la CLI. # 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. ## Cosa serve per il primo segnale L’ingestione diretta tramite SDK mantiene breve il percorso di configurazione. - Collector: Nessun agente locale. Installa il pacchetto SDK e invia i dati direttamente all’API di LogBrew. - Credenziale: Una credenziale per progetto. Copiala da Aggiungi progetto solo quando crei o configuri quel progetto. - Verifica: Controlla nei log. Invia un segnale info, poi confermalo prima di estendere la strumentazione. ## Contesto per l’assistente AI Dai a un agente la mappa pubblica di LogBrew prima che modifichi la tua app o il comando di configurazione. ```bash curl -L https://logbrew.co/llms.txt ``` ### prompt di installazione ```bash Leggi 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. ``` Next: Apri la guida per agenti ## Installa l’SDK Usa i pacchetti Node per un servizio backend che ha bisogno di log, span, azioni, release e metriche. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Crea il progetto Apri Aggiungi progetto, scegli una piattaforma e copia la credenziale di ingestione. Il pannello di configurazione la mostra una sola volta. Next: Apri Aggiungi progetto ## Invia un’azione di prodotto Esegui l’esempio incluso nel pacchetto prima di integrare il codice di produzione, così la prima struttura è nota e senza token. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Verifica in LogBrew Leggi il primo segnale info nei log prima di aggiungere altra strumentazione. ```bash logbrew logs info --json ``` # Invia a LogBrew il primo segnale dell’SDK Node 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. ```bash npm install @logbrew/sdk @logbrew/node ``` ## 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. ## Esegui 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. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## 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. ```bash logbrew logs info --json ``` # Scegli il tuo percorso ## Controlla se LogBrew è pronto Esegui prima status per confermare raggiungibilità, stato dell’accesso e la prossima lettura sicura. ```bash logbrew status --json ``` ## 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. ```bash logbrew logs error --json ``` ## Condividi una vista stabile dei problemi Elenca i problemi aperti quando un collega ha bisogno degli stessi gruppi di errori. ```bash logbrew issues open --json ``` # Mappa dei comandi ## Stato Controlla autenticazione locale, raggiungibilità dell’API e passaggi di ripristino prima di qualsiasi lettura privata. ```bash logbrew status --json ``` ## Log Parti dagli errori recenti quando una release, un progetto o una traccia richiede contesto. ```bash logbrew logs error --json ``` ## Problemi Elenca i gruppi di errori aperti prima di decidere se risolverli, chiuderli, ignorarli o riaprirli. ```bash logbrew issues open --json ``` ## Dettaglio traccia Leggi un ID traccia noto quando log o problemi indicano una singola richiesta non riuscita. ```bash logbrew trace --json ``` ## Azioni Filtra gli eventi degli utenti per nome quando il contesto importante è un’azione di prodotto. ```bash logbrew actions --name checkout_failed --json ``` ## Release Confronta il contesto del rilascio con i conteggi di log, problemi, span delle tracce e azioni. ```bash logbrew releases --json ``` ## 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. ## 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. ## 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. ## 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. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/it/docs - Docs Markdown: https://logbrew.co/it/docs.md - Agent guide: https://logbrew.co/it/agents - Home Markdown: https://logbrew.co/it/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml