Configurer la télémétrie LogBrew

Choisissez une application ou un framework, créez un projet et vérifiez un premier signal sûr.

Choisir la plateformeOuvrir Ajouter un projet

Choisir la plateforme

Choisissez l’application ou le framework qui envoie la télémétrie. Faites le même choix dans Ajouter un projet.

Filtrer les plateformes
6 sur 26 affichés

Node.js

Service Node.js

Utilisez le paquet Node.js quand un service backend a besoin de logs, de spans de requêtes, d’actions, de versions et de métriques.

npm install @logbrew/sdk @logbrew/node
Suivre le parcours Node du premier signal

Express

Service Express

Utilisez le paquet Express quand un service Node traite les requêtes avec un middleware Express.

npm install @logbrew/sdk @logbrew/express express
Ouvrir Ajouter un projet

Fastify

Service Fastify

Utilisez le paquet Fastify quand un service Node gère ses routes avec des plugins Fastify.

npm install @logbrew/sdk @logbrew/fastify fastify
Ouvrir Ajouter un projet

NestJS

Service NestJS

Utilisez le paquet NestJS quand un service Node est organisé autour des modules Nest et du traitement des requêtes.

npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs
Ouvrir Ajouter un projet

Python

Service Python

Commencez par le paquet principal pour les workers et services Python.

python3 -m pip install logbrew-sdk
Ouvrir Ajouter un projet

Django

Application Django

Utilisez le paquet Django pour les signaux de requêtes et d’application d’un projet Django.

python3 -m pip install logbrew-sdk logbrew-django
Ouvrir Ajouter un projet

Commande d’installation

Première exécution réussie du SDK

Gardez la première session courte : installez le paquet, créez le projet, envoyez une action produit sans secret, puis confirmez-la dans LogBrew.

  1. 1Installer le SDKUtilisez les paquets Node pour un service backend qui a besoin de logs, de spans, d’actions, de versions et de métriques.
    npm install @logbrew/sdk @logbrew/node
  2. 2Créer le projetOuvrez Ajouter un projet, choisissez une plateforme et copiez l’identifiant d’ingestion. Le panneau de configuration ne l’affiche qu’une fois.Ouvrir Ajouter un projet
  3. 3Envoyer une action produitLancez l’exemple fourni avant de brancher le code de production : la forme du premier envoi est connue et ne contient aucun jeton.
    node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs
  4. 4Vérifier dans LogBrewLisez le premier signal info dans les logs avant d’ajouter d’autre instrumentation.
    logbrew logs info --json

Donnez à l’agent la carte publique de LogBrew avant qu’il modifie votre application ou votre commande de configuration.

curl -L https://logbrew.co/llms.txt
prompt d’installationLisez https://logbrew.co/llms.txt, puis choisissez la fiche SDK correspondante sur https://logbrew.co/en/docs#docs-sdk-choice-title. Utilisez npm install @logbrew/sdk @logbrew/node uniquement pour un service Node.js côté serveur ; pour Next.js, React, iOS, Android ou React Native, utilisez la fiche choisie et le prompt d’Ajouter un projet. Demandez à l’utilisateur connecté d’ouvrir Ajouter un projet et de placer les identifiants uniquement dans l’environnement de l’application concernée. Pour Node.js côté serveur, la variable d’environnement est LOGBREW_SERVER_API_KEY. Lancez node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs uniquement pour les services Node, puis vérifiez avec logbrew logs info --json. Ne demandez jamais d’identifiants dans la conversation ni dans les commits.
Ouvrir le guide des agents

Configurez un service Node.js et vérifiez sa première télémétrie. Ajouter un projet crée le projet et affiche une seule fois son identifiant d’ingestion. Les étapes ci-dessous couvrent l’installation et la vérification.

  1. Ajouter les paquets du SDK JavaScript

    Commencez par le SDK principal et le helper Node quand un service backend a besoin de logs, de spans de requêtes, d’actions, de versions et de métriques.

    npm install @logbrew/sdk @logbrew/node

  2. Créer le projet depuis Ajouter un projet

    Connectez-vous, ouvrez Ajouter un projet, choisissez une plateforme et copiez l’identifiant d’ingestion. Il n’est affiché qu’une fois. Le site ne l’affiche plus une fois le panneau de configuration fermé.

    Ouvrir Ajouter un projet

  3. Lancer l’exemple du premier signal SDK

    Utilisez l’exemple du paquet installé pour examiner la forme de la version, de l’environnement, du span de requête, de l’action produit, de l’étape réseau et de la métrique avant de brancher votre application.

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

  4. Lire le premier signal dans LogBrew

    Une fois que le SDK a envoyé un signal info avec l’identifiant du projet, utilisez la CLI ou la vue Logs du tableau de bord pour confirmer son arrivée avant d’ajouter d’autre instrumentation.

    logbrew logs info --json

docs.logbrew.co

Site de documentation complet

Utilisez le site de documentation dédié pour la configuration détaillée, les détails de l’API et les exemples qui n’ont pas leur place sur les pages produit.

Ouvrir le site de documentation

Texte brut

Miroir Markdown de la documentation

Utilisez le miroir Markdown localisé quand un agent ou un terminal a besoin de la même documentation, sans état propre au navigateur.

Ouvrir le Markdown

Texte brut

Miroirs pour les agents

Utilisez llms.txt, les miroirs Markdown, robots et le sitemap quand un agent a besoin de chemins de lecture publics prévisibles.

Ouvrir llms.txt

Configurer

Vérifier que LogBrew est prêt

Lancez d’abord status pour confirmer l’accessibilité, l’état de connexion et la prochaine lecture sûre.

logbrew status --json

Trier

Partir des dernières pannes

Lisez les logs d’erreur récents, puis passez aux problèmes ou aux traces quand une version ou un projet demande du contexte.

logbrew logs error --json

Transmettre

Partager une vue stable des problèmes

Listez les problèmes ouverts quand un collègue a besoin des mêmes groupes de pannes.

logbrew issues open --json

Carte des commandes

État

Vérifiez l’authentification locale, l’accessibilité de l’API et les étapes de reprise avant toute lecture privée.

logbrew status --json

Carte des commandes

Logs

Partez des erreurs récentes quand une version, un projet ou une trace demande du contexte.

logbrew logs error --json

Carte des commandes

Problèmes

Listez les groupes de pannes ouverts avant de décider de les résoudre, de les fermer, de les ignorer ou de les rouvrir.

logbrew issues open --json

Carte des commandes

Détail d’une trace

Lisez une trace dont vous connaissez l’ID quand les logs ou les problèmes pointent vers une requête en échec.

logbrew trace <trace_id> --json

Carte des commandes

Actions

Filtrez les événements utilisateur par nom quand le contexte important est une action produit.

logbrew actions --name checkout_failed --json

Carte des commandes

Versions

Comparez le contexte de déploiement avec les nombres de logs, de problèmes, de spans de traces et d’actions.

logbrew releases --json

La CLI d’abord

Vérifier l’authentification locale et l’accès à l’API

La première lecture doit vous dire si la CLI peut joindre l’API LogBrew, sans exposer le jeton.

  • Utilisez le mode JSON quand un script ou une automatisation a besoin de champs stables.
  • Utilisez la sortie lisible quand un développeur a besoin de la prochaine commande.
  • Faites toujours pointer la reprise d’authentification vers la connexion et l’état.

Observer

Lire les signaux de production par ressource

Partez du signal qui répond à votre question. Ouvrez ses détails pour voir les preuves associées.

  • Les logs conservent les filtres de gravité, de version, d’environnement, de projet, de trace et de recherche.
  • Vérifiez le statut et la dernière occurrence d’un problème avant de l’investiguer.
  • Les traces conservent les noms de spans, le contexte de version, le contexte d’environnement et le périmètre du projet.

Partager

Transmettre un contexte utile sans exposer les données du projet

Utilisez la documentation publique, le Markdown et les commandes à copier quand quelqu’un a besoin d’aide pour la configuration ou d’une passation sûre.

  • Partagez un lien vers la documentation quand l’étape suivante est la configuration ou la découverte d’une commande.
  • Partagez du Markdown quand du texte brut est plus pratique qu’une capture d’écran.
  • Ne partagez les données privées d’un projet qu’avec les personnes autorisées à les voir.

Lectures via l’API

Choisir le projet et la période

Consultez la référence de l’API de télémétrie pour les routes et filtres pris en charge, ainsi que des exemples de succès et d’erreur.

  • Authentifiez-vous avant de demander les données privées d’un projet.
  • Sélectionnez le projet et la période avant de comparer les résultats.
  • Suivez les étapes de reprise renvoyées quand une requête échoue.
  • Distinguez les preuves manquantes de celles qui n’ont pas pu être chargées.