# 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 plateforme Choisissez l’application ou le framework qui envoie la télémétrie. Faites le même choix dans Ajouter un projet. ## 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. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Suivre le parcours Node du premier signal ## Service Express Utilisez le paquet Express quand un service Node traite les requêtes avec un middleware Express. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Ouvrir Ajouter un projet ## Service Fastify Utilisez le paquet Fastify quand un service Node gère ses routes avec des plugins Fastify. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Ouvrir Ajouter un projet ## Application JavaScript Utilisez le paquet JavaScript pour navigateur sur les pages frontend qui émettent des actions produit, des logs et des signaux client légers. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Ouvrir Ajouter un projet ## Application Next.js Utilisez le paquet Next.js quand les routes, le rendu serveur et les actions client doivent partager une seule configuration. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Ouvrir Ajouter un projet ## Application React Utilisez le paquet React pour les applications web à composants qui envoient les actions des utilisateurs et l’état de l’interface. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Ouvrir Ajouter un projet ## Application Angular Utilisez le paquet Angular quand le routage du framework et les erreurs de l’application doivent partager une seule configuration. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Ouvrir Ajouter un projet ## Application Vue Utilisez le paquet Vue pour les applications Vue qui ont besoin d’actions produit claires et de signaux côté navigateur. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Ouvrir Ajouter un projet ## Application Svelte Utilisez le paquet Svelte pour les applications Svelte qui ont besoin d’une installation directe du SDK. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Ouvrir Ajouter un projet ## Service NestJS Utilisez le paquet NestJS quand un service Node est organisé autour des modules Nest et du traitement des requêtes. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Ouvrir Ajouter un projet ## Service Python Commencez par le paquet principal pour les workers et services Python. ```bash python3 -m pip install logbrew-sdk ``` Next: Ouvrir Ajouter un projet ## Application Django Utilisez le paquet Django pour les signaux de requêtes et d’application d’un projet Django. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Ouvrir Ajouter un projet ## Service FastAPI Utilisez le paquet FastAPI pour les API Python avec des spans de requêtes et des actions explicites. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Ouvrir Ajouter un projet ## Service .NET Installez le paquet .NET quand un service gère des signaux côté serveur. ```bash dotnet add package LogBrew ``` Next: Ouvrir Ajouter un projet ## Application ASP.NET Core Utilisez le paquet ASP.NET Core quand le traitement des requêtes .NET et les signaux de l’application web doivent partager une seule configuration. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Ouvrir Ajouter un projet ## Service Java Utilisez le paquet JVM pour les services Java qui ont besoin de leurs propres logs, de spans de requêtes et d’actions produit. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Ouvrir Ajouter un projet ## Service Go Ajoutez le paquet Go quand un service gère explicitement ses logs, spans, métriques et contexte de trace. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Ouvrir Ajouter un projet ## Application PHP Utilisez Composer pour les services PHP et les signaux de requêtes propres à l’application. ```bash composer require logbrew/sdk ``` Next: Ouvrir Ajouter un projet ## Service Ruby Utilisez la gem Ruby pour les services Ruby qui ont besoin de signaux explicites d’application et de requêtes. ```bash gem install logbrew-sdk ``` Next: Ouvrir Ajouter un projet ## Service Rust Ajoutez la crate Rust pour les services qui construisent eux-mêmes leurs logs, spans, actions et métriques. ```bash cargo add logbrew ``` Next: Ouvrir Ajouter un projet ## Application iOS Utilisez le paquet pour plateformes Apple pour les applications iOS qui envoient des signaux produit explicites. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Ouvrir Ajouter un projet ## Application Android Utilisez le paquet Android pour les applications qui envoient leurs propres signaux depuis le runtime Android. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Ouvrir Ajouter un projet ## Application React Native Utilisez le paquet React Native pour les applications mobiles qui partagent des actions produit JavaScript. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Ouvrir Ajouter un projet ## Application Unity Utilisez le paquet Unity pour les jeux ou simulations qui envoient des actions produit et des signaux d’exécution. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Ouvrir Ajouter un projet ## Application C Utilisez les sources C pour les services natifs ou les applications embarquées qui ont besoin d’un contrôle direct des signaux. ```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: Ouvrir Ajouter un projet ## Application C++ Exécutez le plan de la CLI publiée dans un projet C++17 avec CMake 3.16 ou plus. Liez LogBrew::LogBrew. Activez LogBrew::HttpTransport et libcurl uniquement si l’envoi vers le service hébergé est nécessaire. ```bash logbrew setup --json ``` Next: Ouvrir Ajouter un projet ## La configuration en un coup d’œil Suivez cet ordre pour passer de la documentation à une action produit vérifiée sans quitter la configuration. - Installer. Ajouter le paquet: Commencez par le paquet SDK de votre runtime. - Créer. Créer le projet: Ouvrez Ajouter un projet et copiez l’identifiant du projet. Il n’est affiché qu’une fois. - Envoyer. Envoyer une action produit: Lancez une action produit sans secret avant de brancher l’application. - Vérifier. Consulter les logs: Confirmez le signal dans les logs ou avec la CLI. # 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. ## Ce qu’il faut pour le premier signal L’ingestion directe par le SDK garde la configuration courte. - Collecteur: Aucun agent local. Installez le paquet SDK et envoyez directement à l’API LogBrew. - Identifiant: Un identifiant par projet. Copiez-le depuis Ajouter un projet, uniquement lors de la création ou de la configuration de ce projet. - Preuve: Vérifier dans les logs. Envoyez un signal info, puis confirmez-le avant d’étendre l’instrumentation. ## Contexte pour l’assistant IA Donnez à l’agent la carte publique de LogBrew avant qu’il modifie votre application ou votre commande de configuration. ```bash curl -L https://logbrew.co/llms.txt ``` ### prompt d’installation ```bash Lisez 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. ``` Next: Ouvrir le guide des agents ## Installer le SDK Utilisez les paquets Node pour un service backend qui a besoin de logs, de spans, d’actions, de versions et de métriques. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Créer le projet Ouvrez Ajouter un projet, choisissez une plateforme et copiez l’identifiant d’ingestion. Le panneau de configuration ne l’affiche qu’une fois. Next: Ouvrir Ajouter un projet ## Envoyer une action produit Lancez l’exemple fourni avant de brancher le code de production : la forme du premier envoi est connue et ne contient aucun jeton. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Vérifier dans LogBrew Lisez le premier signal info dans les logs avant d’ajouter d’autre instrumentation. ```bash logbrew logs info --json ``` # Envoyer le premier signal du SDK Node à LogBrew 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. ## 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. ```bash npm install @logbrew/sdk @logbrew/node ``` ## 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é. ## 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. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## 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. ```bash logbrew logs info --json ``` # Choisir votre parcours ## 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. ```bash logbrew status --json ``` ## 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. ```bash logbrew logs error --json ``` ## Partager une vue stable des problèmes Listez les problèmes ouverts quand un collègue a besoin des mêmes groupes de pannes. ```bash 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. ```bash logbrew status --json ``` ## Logs Partez des erreurs récentes quand une version, un projet ou une trace demande du contexte. ```bash logbrew logs error --json ``` ## 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. ```bash logbrew issues open --json ``` ## 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. ```bash logbrew trace --json ``` ## Actions Filtrez les événements utilisateur par nom quand le contexte important est une action produit. ```bash logbrew actions --name checkout_failed --json ``` ## Versions Comparez le contexte de déploiement avec les nombres de logs, de problèmes, de spans de traces et d’actions. ```bash logbrew releases --json ``` ## 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. ## 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. ## 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. ## 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. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/fr/docs - Docs Markdown: https://logbrew.co/fr/docs.md - Agent guide: https://logbrew.co/fr/agents - Home Markdown: https://logbrew.co/fr/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml