# LogBrew-telemetrie instellen Kies een app of framework, maak een project aan en controleer één veilig signaal. # Kies een platform Kies de app of het framework dat telemetrie stuurt. Maak dezelfde keuze in Project toevoegen. ## Node.js-service Gebruik het Node.js-pakket als een backendservice logs, request-spans, acties, releases en metrics nodig heeft. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Volg het eerste-signaalpad voor Node ## Express-service Gebruik het Express-pakket als een Node-service requests afhandelt via Express-middleware. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Project toevoegen openen ## Fastify-service Gebruik het Fastify-pakket als een Node-service routes afhandelt via Fastify-plug-ins. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Project toevoegen openen ## JavaScript-app Gebruik het JavaScript-pakket voor de browser bij frontendpagina’s die productacties, logs en lichte clientsignalen sturen. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Project toevoegen openen ## Next.js-app Gebruik het Next.js-pakket als routes, server rendering en clientacties één installatiepad nodig hebben. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Project toevoegen openen ## React-app Gebruik het React-pakket voor componentgebaseerde webapps die gebruikersacties en UI-status sturen. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Project toevoegen openen ## Angular-app Gebruik het Angular-pakket als routing van het framework en appfouten één installatiepad moeten delen. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Project toevoegen openen ## Vue-app Gebruik het Vue-pakket voor Vue-apps die duidelijke productacties en signalen uit de browser nodig hebben. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Project toevoegen openen ## Svelte-app Gebruik het Svelte-pakket voor Svelte-apps die een directe installatie van de SDK nodig hebben. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Project toevoegen openen ## NestJS-service Gebruik het NestJS-pakket als een Node-service is opgebouwd rond Nest-modules en requestafhandeling. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Project toevoegen openen ## Python-service Begin met het basispakket voor Python-workers en -services. ```bash python3 -m pip install logbrew-sdk ``` Next: Project toevoegen openen ## Django-app Gebruik het Django-pakket voor request- en appsignalen uit een Django-project. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Project toevoegen openen ## FastAPI-service Gebruik het FastAPI-pakket voor Python-API’s met expliciete request-spans en acties. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Project toevoegen openen ## .NET-service Installeer het .NET-pakket als een service zelf signalen aan de serverkant stuurt. ```bash dotnet add package LogBrew ``` Next: Project toevoegen openen ## ASP.NET Core-app Gebruik het ASP.NET Core-pakket als .NET-requestafhandeling en signalen van de webapp één installatiepad nodig hebben. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Project toevoegen openen ## Java-service Gebruik het JVM-pakket voor Java-services die eigen logs, request-spans en productacties van de app nodig hebben. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Project toevoegen openen ## Go-service Voeg het Go-pakket toe als een service zelf expliciete logs, spans, metrics en tracecontext beheert. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Project toevoegen openen ## PHP-app Gebruik Composer voor PHP-services en requestsignalen die de app zelf vastlegt. ```bash composer require logbrew/sdk ``` Next: Project toevoegen openen ## Ruby-service Gebruik de Ruby-gem voor Ruby-services die expliciete app- en requestsignalen nodig hebben. ```bash gem install logbrew-sdk ``` Next: Project toevoegen openen ## Rust-service Voeg de Rust-crate toe voor services die hun eigen logs, spans, acties en metrics opbouwen. ```bash cargo add logbrew ``` Next: Project toevoegen openen ## iOS-app Gebruik het pakket voor Apple-platforms voor iOS-apps die expliciete productsignalen sturen. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Project toevoegen openen ## Android-app Gebruik het Android-pakket voor apps die zelf vastgelegde signalen sturen vanuit de Android-runtime. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Project toevoegen openen ## React Native-app Gebruik het React Native-pakket voor mobiele apps die productacties in JavaScript delen. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Project toevoegen openen ## Unity-app Gebruik het Unity-pakket voor games of simulaties die productacties en runtimesignalen sturen. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Project toevoegen openen ## C-app Gebruik de C-bronbestanden voor native services of embedded apps die directe controle over signalen nodig hebben. ```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: Project toevoegen openen ## C++-app Voer het uitgebrachte CLI-plan uit in een C++17-project met CMake 3.16+. Link LogBrew::LogBrew. Schakel LogBrew::HttpTransport en libcurl alleen in als verzending naar de gehoste dienst nodig is. ```bash logbrew setup --json ``` Next: Project toevoegen openen ## Installatie in één oogopslag Volg deze volgorde om van documentatie naar een gecontroleerde productactie te gaan, zonder de installatie te verlaten. - Installeren. Pakket toevoegen: Begin met het SDK-pakket voor je runtime. - Aanmaken. Project aanmaken: Open Project toevoegen en kopieer de projectsleutel. Die wordt één keer getoond. - Sturen. Eén productactie sturen: Voer één productactie zonder geheimen uit voordat je de app aansluit. - Controleren. Logs controleren: Bevestig het signaal in de logs of met de CLI. # Eerste geslaagde SDK-run Houd de eerste sessie kort: installeer het pakket, maak het project aan, stuur één productactie zonder geheimen en bevestig die in LogBrew. ## Wat je nodig hebt voor het eerste signaal Directe ontvangst via de SDK houdt de installatie kort. - Collector: Geen lokale agent. Installeer het SDK-pakket en stuur rechtstreeks naar de LogBrew API. - Sleutel: Eén projectsleutel. Kopieer deze alleen uit Project toevoegen als je dat project aanmaakt of installeert. - Bewijs: Controleren in logs. Stuur één info-signaal en bevestig het voordat je verder instrumenteert. ## Context voor AI-assistenten Geef een agent de openbare LogBrew-kaart voordat hij je app of installatieopdracht wijzigt. ```bash curl -L https://logbrew.co/llms.txt ``` ### installatieprompt ```bash Lees https://logbrew.co/llms.txt en kies daarna de passende SDK-kaart op https://logbrew.co/en/docs#docs-sdk-choice-title. Gebruik npm install @logbrew/sdk @logbrew/node alleen voor een Node.js-service aan de serverkant; gebruik voor Next.js, React, iOS, Android of React Native de gekozen kaart en de prompt uit Project toevoegen. Vraag de ingelogde gebruiker om Project toevoegen te openen en sleutels alleen in de bijbehorende app-omgeving te zetten. Voor Node.js aan de serverkant is de omgevingsvariabele LOGBREW_SERVER_API_KEY. Voer node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs alleen uit voor Node-services en controleer daarna met logbrew logs info --json. Vraag niet om sleutels in chat of commits. ``` Next: Handleiding voor agents openen ## SDK installeren Gebruik de Node-pakketten voor een backendservice die logs, spans, acties, releases en metrics nodig heeft. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Project aanmaken Open Project toevoegen, kies een platform en kopieer de ingest-sleutel. Het installatiepaneel toont die één keer. Next: Project toevoegen openen ## Eén productactie sturen Voer het meegeleverde voorbeeld uit voordat je productiecode aansluit, zodat de eerste vorm bekend is en geen token bevat. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Controleren in LogBrew Lees het eerste info-signaal in de logs voordat je meer instrumentatie toevoegt. ```bash logbrew logs info --json ``` # Stuur het eerste signaal via de Node SDK naar LogBrew Stel een Node.js-service in en controleer de eerste telemetrie. Project toevoegen maakt het project aan en toont de ingest-sleutel één keer. De stappen hieronder gaan over installeren en controleren. ## Voeg de JavaScript SDK-pakketten toe Begin met de basis-SDK en de Node-helper als een backendservice logs, request-spans, acties, releases en metrics nodig heeft. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Maak het project aan via Project toevoegen Log in, open Project toevoegen, kies een platform en kopieer de ingest-sleutel. Die wordt één keer getoond. De website toont hem niet opnieuw nadat je het installatiepaneel verlaat. ## Voer het voorbeeld voor het eerste SDK-signaal uit Gebruik het voorbeeld uit het geïnstalleerde pakket om de vorm van release, omgeving, request-span, productactie, netwerkmijlpaal en metric te bekijken voordat je je app aansluit. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Lees het eerste signaal in LogBrew Nadat de SDK een info-signaal met de projectsleutel heeft gestuurd, controleer je met de CLI of de logweergave in het dashboard dat het is aangekomen, voordat je meer instrumentatie toevoegt. ```bash logbrew logs info --json ``` # Kies je route ## Controleer of LogBrew klaar is Voer eerst status uit om bereikbaarheid, inlogstatus en de volgende veilige leesactie te controleren. ```bash logbrew status --json ``` ## Begin bij de nieuwste fouten Lees recente foutlogs en ga daarna naar issues of traces als een release of project context nodig heeft. ```bash logbrew logs error --json ``` ## Deel een stabiele weergave van issues Toon open issues als een teamgenoot dezelfde foutgroepen nodig heeft. ```bash logbrew issues open --json ``` # Overzicht van opdrachten ## Status Controleer lokale authenticatie, bereikbaarheid van de API en herstelstappen vóór elke privéleesactie. ```bash logbrew status --json ``` ## Logs Begin met recente fouten als een release, project of trace context nodig heeft. ```bash logbrew logs error --json ``` ## Issues Toon open foutgroepen voordat je beslist of je ze oplost, sluit, negeert of heropent. ```bash logbrew issues open --json ``` ## Tracedetails Lees een bekend trace-ID als logs of issues naar één mislukt request wijzen. ```bash logbrew trace --json ``` ## Acties Filter gebruikersevents op naam als de belangrijke context een productactie is. ```bash logbrew actions --name checkout_failed --json ``` ## Releases Vergelijk de uitrolcontext met aantallen logs, issues, trace-spans en acties. ```bash logbrew releases --json ``` ## Controleer lokale authenticatie en bereikbaarheid van de API De eerste leesactie moet laten zien of de CLI de LogBrew API kan bereiken, zonder tokengegevens te tonen. - Gebruik de JSON-modus als een script of automatisering stabiele velden nodig heeft. - Gebruik leesbare uitvoer als iemand de volgende opdracht nodig heeft. - Laat herstel van authenticatie terugverwijzen naar login en status. ## Lees productiesignalen per onderdeel Begin met het signaal dat je vraag beantwoordt. Open de details voor gerelateerd bewijs. - Logs behouden filters voor ernst, release, omgeving, project, trace en zoekopdracht. - Controleer de status en het laatste voorval van een issue voordat je het onderzoekt. - Traces behouden spannamen, releasecontext, omgevingscontext en projectbereik. ## Stuur nuttige context zonder projectdata te tonen Gebruik openbare documentatie, Markdown en kopieerbare opdrachten als iemand hulp nodig heeft bij de installatie of een veilige overdracht. - Deel een link naar de documentatie als de volgende stap installatie of het vinden van een opdracht is. - Deel Markdown als platte tekst makkelijker is dan een screenshot. - Deel privé projectdata alleen met mensen die toestemming hebben om die te zien. ## Kies het project en het tijdsbereik Gebruik de referentie van de telemetrie-API voor ondersteunde routes, filters en voorbeelden van geslaagde en mislukte verzoeken. - Authenticeer voordat je privé projectdata opvraagt. - Selecteer het project en het tijdsbereik voordat je resultaten vergelijkt. - Volg de teruggestuurde herstelstappen als een verzoek mislukt. - Houd ontbrekend bewijs gescheiden van bewijs dat niet kon worden geladen. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/nl/docs - Docs Markdown: https://logbrew.co/nl/docs.md - Agent guide: https://logbrew.co/nl/agents - Home Markdown: https://logbrew.co/nl/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml