# Skonfiguruj telemetrię LogBrew Wybierz aplikację lub framework, utwórz projekt i sprawdź jeden bezpieczny sygnał. # Wybierz platformę Wybierz aplikację lub framework, które wysyłają telemetrię. Ten sam wybór zastosuj w oknie „Dodaj projekt”. ## Usługa Node.js Użyj pakietu Node.js, gdy usługa backendowa potrzebuje logów, spanów żądań, akcji, wydań i metryk. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Przejdź do pierwszego sygnału w Node ## Usługa Express Użyj pakietu Express, gdy usługa Node obsługuje żądania przez middleware Express. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Otwórz „Dodaj projekt” ## Usługa Fastify Użyj pakietu Fastify, gdy usługa Node obsługuje trasy przez pluginy Fastify. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Otwórz „Dodaj projekt” ## Aplikacja JavaScript Użyj przeglądarkowego pakietu JavaScript dla stron frontendowych, które wysyłają akcje w produkcie, logi i lekkie sygnały z klienta. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Next.js Użyj pakietu Next.js, gdy trasy, renderowanie po stronie serwera i akcje klienta mają mieć jedną ścieżkę konfiguracji. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Otwórz „Dodaj projekt” ## Aplikacja React Użyj pakietu React dla aplikacji webowych opartych na komponentach, które wysyłają akcje użytkowników i stan interfejsu. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Angular Użyj pakietu Angular, gdy routing frameworka i błędy aplikacji mają mieć jedną ścieżkę konfiguracji. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Vue Użyj pakietu Vue dla aplikacji Vue, które potrzebują czytelnych akcji w produkcie i sygnałów z przeglądarki. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Svelte Użyj pakietu Svelte dla aplikacji Svelte, które potrzebują bezpośredniej instalacji SDK. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Otwórz „Dodaj projekt” ## Usługa NestJS Użyj pakietu NestJS, gdy usługa Node jest zbudowana wokół modułów Nest i obsługi żądań. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Otwórz „Dodaj projekt” ## Usługa Python Zacznij od pakietu podstawowego dla workerów i usług w Pythonie. ```bash python3 -m pip install logbrew-sdk ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Django Użyj pakietu Django dla sygnałów żądań i aplikacji z projektu Django. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Otwórz „Dodaj projekt” ## Usługa FastAPI Użyj pakietu FastAPI dla API w Pythonie z jawnymi spanami żądań i akcjami. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Otwórz „Dodaj projekt” ## Usługa .NET Zainstaluj pakiet .NET, gdy usługa wysyła sygnały po stronie serwera. ```bash dotnet add package LogBrew ``` Next: Otwórz „Dodaj projekt” ## Aplikacja ASP.NET Core Użyj pakietu ASP.NET Core, gdy obsługa żądań .NET i sygnały aplikacji webowej mają mieć jedną ścieżkę konfiguracji. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Otwórz „Dodaj projekt” ## Usługa Java Użyj pakietu JVM dla usług w Javie, które potrzebują własnych logów, spanów żądań i akcji w produkcie. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Otwórz „Dodaj projekt” ## Usługa Go Dodaj pakiet Go, gdy usługa sama wysyła jawne logi, spany, metryki i kontekst śladu. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Otwórz „Dodaj projekt” ## Aplikacja PHP Użyj Composera dla usług PHP i sygnałów żądań wysyłanych przez aplikację. ```bash composer require logbrew/sdk ``` Next: Otwórz „Dodaj projekt” ## Usługa Ruby Użyj gema Ruby dla usług w Ruby, które potrzebują jawnych sygnałów aplikacji i żądań. ```bash gem install logbrew-sdk ``` Next: Otwórz „Dodaj projekt” ## Usługa Rust Dodaj crate Rust dla usług, które same budują logi, spany, akcje i metryki. ```bash cargo add logbrew ``` Next: Otwórz „Dodaj projekt” ## Aplikacja iOS Użyj pakietu dla platform Apple w aplikacjach iOS, które wysyłają jawne sygnały produktu. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Android Użyj pakietu Android dla aplikacji, które wysyłają własne sygnały ze środowiska Android. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Otwórz „Dodaj projekt” ## Aplikacja React Native Użyj pakietu React Native dla aplikacji mobilnych, które współdzielą akcje w produkcie z kodem JavaScript. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Otwórz „Dodaj projekt” ## Aplikacja Unity Użyj pakietu Unity dla gier lub symulacji, które wysyłają akcje w produkcie i sygnały środowiska uruchomieniowego. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Otwórz „Dodaj projekt” ## Aplikacja C Użyj źródeł C dla natywnych usług lub aplikacji wbudowanych, które potrzebują bezpośredniej kontroli nad sygnałami. ```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: Otwórz „Dodaj projekt” ## Aplikacja C++ Uruchom wydany plan CLI w projekcie CMake 3.16+ z C++17. Podlinkuj LogBrew::LogBrew. Włącz LogBrew::HttpTransport i libcurl tylko wtedy, gdy potrzebne jest wysyłanie do usługi hostowanej. ```bash logbrew setup --json ``` Next: Otwórz „Dodaj projekt” ## Konfiguracja w skrócie Trzymaj się tej kolejności, aby przejść od dokumentacji do sprawdzonej akcji w produkcie bez wychodzenia z konfiguracji. - Instalacja. Dodaj pakiet: Zacznij od pakietu SDK dla swojego środowiska uruchomieniowego. - Tworzenie. Utwórz projekt: Otwórz „Dodaj projekt” i skopiuj poświadczenie projektu. Jest pokazywane tylko raz. - Wysyłanie. Wyślij jedną akcję w produkcie: Uruchom jedną akcję w produkcie bez sekretów, zanim podłączysz aplikację. - Weryfikacja. Sprawdź logi: Potwierdź sygnał w logach lub w CLI. # Pierwsze udane uruchomienie SDK Pierwsza sesja niech będzie krótka: zainstaluj pakiet, utwórz projekt, wyślij jedną akcję w produkcie bez sekretów i potwierdź ją w LogBrew. ## Czego potrzeba do pierwszego sygnału Bezpośrednie wysyłanie z SDK skraca konfigurację. - Kolektor: Bez lokalnego agenta. Zainstaluj pakiet SDK i wysyłaj dane bezpośrednio do API LogBrew. - Poświadczenie: Jedno poświadczenie projektu. Skopiuj je z okna „Dodaj projekt” tylko podczas tworzenia lub konfiguracji tego projektu. - Dowód: Sprawdź w logach. Wyślij jeden sygnał info i potwierdź go, zanim rozszerzysz instrumentację. ## Kontekst dla asystenta AI Daj agentowi publiczną mapę LogBrew, zanim zmieni twoją aplikację lub polecenie konfiguracji. ```bash curl -L https://logbrew.co/llms.txt ``` ### prompt instalacji ```bash Przeczytaj https://logbrew.co/llms.txt, a potem wybierz pasującą kartę SDK na https://logbrew.co/en/docs#docs-sdk-choice-title. Użyj npm install @logbrew/sdk @logbrew/node tylko dla usługi Node.js działającej po stronie serwera. Dla Next.js, React, iOS, Android lub React Native użyj wybranej karty i promptu z okna „Dodaj projekt”. Poproś zalogowanego użytkownika, aby otworzył „Dodaj projekt” i umieścił poświadczenia tylko w środowisku pasującej aplikacji. Dla Node.js po stronie serwera zmienna środowiskowa to LOGBREW_SERVER_API_KEY. Uruchom node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs tylko dla usług Node, a potem sprawdź wynik poleceniem logbrew logs info --json. Nie proś o poświadczenia na czacie ani w commitach. ``` Next: Otwórz przewodnik dla agentów ## Zainstaluj SDK Użyj pakietów Node dla usługi backendowej, która potrzebuje logów, spanów, akcji, wydań i metryk. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Utwórz projekt Otwórz „Dodaj projekt”, wybierz platformę i skopiuj poświadczenie wysyłania. Panel konfiguracji pokazuje je tylko raz. Next: Otwórz „Dodaj projekt” ## Wyślij jedną akcję w produkcie Uruchom dołączony przykład, zanim podłączysz kod produkcyjny. Dzięki temu znasz kształt pierwszego sygnału i nie używasz tokenu. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Sprawdź w LogBrew Przeczytaj pierwszy sygnał info w logach, zanim dodasz więcej instrumentacji. ```bash logbrew logs info --json ``` # Wyślij pierwszy sygnał z SDK dla Node do LogBrew Skonfiguruj usługę Node.js i sprawdź jej pierwszą telemetrię. Okno „Dodaj projekt” tworzy projekt i raz pokazuje jego poświadczenie wysyłania. Kroki poniżej opisują instalację i weryfikację. ## Dodaj pakiety SDK dla JavaScriptu Zacznij od podstawowego SDK i pomocnika Node, gdy usługa backendowa potrzebuje logów, spanów żądań, akcji, wydań i metryk. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Utwórz projekt w oknie „Dodaj projekt” Zaloguj się, otwórz „Dodaj projekt”, wybierz platformę i skopiuj poświadczenie wysyłania. Jest pokazywane tylko raz. Po zamknięciu panelu konfiguracji strona nie pokaże go ponownie. ## Uruchom przykład pierwszego sygnału SDK Użyj przykładu z zainstalowanego pakietu, aby zobaczyć wydanie, środowisko, span żądania, akcję w produkcie, etap sieciowy i kształt metryki, zanim podłączysz aplikację. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Przeczytaj pierwszy sygnał w LogBrew Gdy SDK wyśle sygnał info z poświadczeniem projektu, potwierdź w CLI lub w widoku logów na pulpicie, że dotarł, zanim dodasz więcej instrumentacji. ```bash logbrew logs info --json ``` # Wybierz ścieżkę ## Sprawdź, czy LogBrew jest gotowy Najpierw uruchom status, aby potwierdzić dostępność, stan logowania i następny bezpieczny odczyt. ```bash logbrew status --json ``` ## Zacznij od najnowszych awarii Przeczytaj ostatnie logi błędów, a potem przejdź do problemów lub śladów, gdy wydanie lub projekt wymaga kontekstu. ```bash logbrew logs error --json ``` ## Udostępnij stały widok problemów Wyświetl listę otwartych problemów, gdy współpracownik potrzebuje tych samych grup awarii. ```bash logbrew issues open --json ``` # Mapa poleceń ## Status Sprawdź lokalne uwierzytelnienie, dostępność API i kroki naprawcze przed każdym prywatnym odczytem. ```bash logbrew status --json ``` ## Logi Zacznij od ostatnich błędów, gdy wydanie, projekt lub ślad wymaga kontekstu. ```bash logbrew logs error --json ``` ## Problemy Wyświetl otwarte grupy awarii, zanim zdecydujesz, czy je rozwiązać, zamknąć, zignorować czy otworzyć ponownie. ```bash logbrew issues open --json ``` ## Szczegóły śladu Odczytaj znany ID śladu, gdy logi lub problemy wskazują jedno nieudane żądanie. ```bash logbrew trace --json ``` ## Akcje Filtruj zdarzenia użytkowników według nazwy, gdy ważnym kontekstem jest akcja w produkcie. ```bash logbrew actions --name checkout_failed --json ``` ## Wydania Porównaj kontekst wdrożenia z liczbą logów, problemów, spanów śladów i akcji. ```bash logbrew releases --json ``` ## Sprawdź lokalne uwierzytelnienie i dostępność API Pierwszy odczyt powinien pokazać, czy CLI łączy się z API LogBrew, bez ujawniania tokenu. - Używaj trybu JSON, gdy skrypt lub automatyzacja potrzebuje stałych pól. - Używaj wyjścia czytelnego dla ludzi, gdy trzeba poznać następne polecenie. - Przy problemach z uwierzytelnieniem wracaj do logowania i statusu. ## Czytaj sygnały z produkcji według zasobu Zacznij od sygnału, który odpowiada na twoje pytanie. Otwórz jego szczegóły, aby zobaczyć powiązane dowody. - Logi zachowują filtry ważności, wydania, środowiska, projektu, śladu i wyszukiwania. - Sprawdź status problemu i jego ostatnie wystąpienie, zanim go zbadasz. - Ślady zachowują nazwy spanów, kontekst wydania, kontekst środowiska i zakres projektu. ## Przekazuj przydatny kontekst bez ujawniania danych projektu Korzystaj z publicznej dokumentacji, Markdown i poleceń do skopiowania, gdy ktoś potrzebuje pomocy z konfiguracją lub bezpiecznego przekazania. - Udostępnij link do dokumentacji, gdy następnym krokiem jest konfiguracja lub znalezienie polecenia. - Udostępnij Markdown, gdy zwykły tekst jest wygodniejszy niż zrzut ekranu. - Udostępniaj prywatne dane projektu tylko osobom, które mają uprawnienia do ich oglądania. ## Wybierz projekt i zakres czasu Korzystaj z dokumentacji API telemetrii, aby poznać obsługiwane trasy, filtry oraz przykłady sukcesu i błędów. - Uwierzytelnij się, zanim zażądasz prywatnych danych projektu. - Wybierz projekt i zakres czasu, zanim porównasz wyniki. - Gdy żądanie się nie powiedzie, wykonaj zwrócone kroki naprawcze. - Odróżniaj brakujące dowody od dowodów, których nie udało się wczytać. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/pl/docs - Docs Markdown: https://logbrew.co/pl/docs.md - Agent guide: https://logbrew.co/pl/agents - Home Markdown: https://logbrew.co/pl/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml