Skonfiguruj telemetrię LogBrew

Wybierz aplikację lub framework, utwórz projekt i sprawdź jeden bezpieczny sygnał.

Wybierz platformęOtwórz „Dodaj projekt”

Wybierz platformę

Wybierz aplikację lub framework, które wysyłają telemetrię. Ten sam wybór zastosuj w oknie „Dodaj projekt”.

Filtruj platformy
Widoczne: 6 z 26

Node.js

Usługa Node.js

Użyj pakietu Node.js, gdy usługa backendowa potrzebuje logów, spanów żądań, akcji, wydań i metryk.

npm install @logbrew/sdk @logbrew/node
Przejdź do pierwszego sygnału w Node

Express

Usługa Express

Użyj pakietu Express, gdy usługa Node obsługuje żądania przez middleware Express.

npm install @logbrew/sdk @logbrew/express express
Otwórz „Dodaj projekt”

Fastify

Usługa Fastify

Użyj pakietu Fastify, gdy usługa Node obsługuje trasy przez pluginy Fastify.

npm install @logbrew/sdk @logbrew/fastify fastify
Otwórz „Dodaj projekt”

NestJS

Usługa NestJS

Użyj pakietu NestJS, gdy usługa Node jest zbudowana wokół modułów Nest i obsługi żądań.

npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs
Otwórz „Dodaj projekt”

Python

Usługa Python

Zacznij od pakietu podstawowego dla workerów i usług w Pythonie.

python3 -m pip install logbrew-sdk
Otwórz „Dodaj projekt”

Django

Aplikacja Django

Użyj pakietu Django dla sygnałów żądań i aplikacji z projektu Django.

python3 -m pip install logbrew-sdk logbrew-django
Otwórz „Dodaj projekt”

Polecenie instalacji

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.

  1. 1Zainstaluj SDKUżyj pakietów Node dla usługi backendowej, która potrzebuje logów, spanów, akcji, wydań i metryk.
    npm install @logbrew/sdk @logbrew/node
  2. 2Utwórz projektOtwórz „Dodaj projekt”, wybierz platformę i skopiuj poświadczenie wysyłania. Panel konfiguracji pokazuje je tylko raz.Otwórz „Dodaj projekt”
  3. 3Wyślij jedną akcję w produkcieUruchom dołączony przykład, zanim podłączysz kod produkcyjny. Dzięki temu znasz kształt pierwszego sygnału i nie używasz tokenu.
    node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs
  4. 4Sprawdź w LogBrewPrzeczytaj pierwszy sygnał info w logach, zanim dodasz więcej instrumentacji.
    logbrew logs info --json

Daj agentowi publiczną mapę LogBrew, zanim zmieni twoją aplikację lub polecenie konfiguracji.

curl -L https://logbrew.co/llms.txt
prompt instalacjiPrzeczytaj 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.
Otwórz przewodnik dla agentów

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ę.

  1. 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.

    npm install @logbrew/sdk @logbrew/node

  2. 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.

    Otwórz „Dodaj projekt”

  3. 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ę.

    node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs

  4. 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.

    logbrew logs info --json

docs.logbrew.co

Pełna dokumentacja

Korzystaj z osobnej strony dokumentacji, gdy potrzebujesz rozbudowanej konfiguracji, szczegółów API i przykładów, które nie powinny zaśmiecać stron produktu.

Otwórz dokumentację

Zwykły tekst

Dokumentacja w Markdown

Korzystaj z przetłumaczonej kopii w Markdown, gdy agent lub praca w terminalu wymaga tej samej dokumentacji bez stanu przeglądarki.

Otwórz Markdown

Zwykły tekst

Kopie dla agentów

Korzystaj z llms.txt, kopii w Markdown, robots i sitemap, gdy agent potrzebuje przewidywalnych publicznych ścieżek odczytu.

Otwórz llms.txt

Konfiguracja

Sprawdź, czy LogBrew jest gotowy

Najpierw uruchom status, aby potwierdzić dostępność, stan logowania i następny bezpieczny odczyt.

logbrew status --json

Ocena

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.

logbrew logs error --json

Przekazanie

Udostępnij stały widok problemów

Wyświetl listę otwartych problemów, gdy współpracownik potrzebuje tych samych grup awarii.

logbrew issues open --json

Mapa poleceń

Status

Sprawdź lokalne uwierzytelnienie, dostępność API i kroki naprawcze przed każdym prywatnym odczytem.

logbrew status --json

Mapa poleceń

Logi

Zacznij od ostatnich błędów, gdy wydanie, projekt lub ślad wymaga kontekstu.

logbrew logs error --json

Mapa poleceń

Problemy

Wyświetl otwarte grupy awarii, zanim zdecydujesz, czy je rozwiązać, zamknąć, zignorować czy otworzyć ponownie.

logbrew issues open --json

Mapa poleceń

Szczegóły śladu

Odczytaj znany ID śladu, gdy logi lub problemy wskazują jedno nieudane żądanie.

logbrew trace <trace_id> --json

Mapa poleceń

Akcje

Filtruj zdarzenia użytkowników według nazwy, gdy ważnym kontekstem jest akcja w produkcie.

logbrew actions --name checkout_failed --json

Mapa poleceń

Wydania

Porównaj kontekst wdrożenia z liczbą logów, problemów, spanów śladów i akcji.

logbrew releases --json

Najpierw CLI

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.

Obserwacja

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.

Udostępnianie

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.

Odczyty przez API

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ć.