# Docs de LogBrew Elige la app o el framework, crea un proyecto desde Add Project y verifica la primera señal antes de pasar a las referencias de CLI y dashboard. # Elige plataforma Empieza por la app o framework que coincide con tu proyecto. Usa la misma opción en Add Project. ## Servicio Node.js Usa el paquete de Node.js cuando un servicio backend necesita logs, spans de request, acciones, releases y métricas. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Usar la ruta de primera señal Node ## Servicio Express Usa el paquete de Express cuando un servicio Node maneja requests con middleware de Express. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Abrir Add Project ## Servicio Fastify Usa el paquete de Fastify cuando un servicio Node maneja rutas con plugins de Fastify. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Abrir Add Project ## Aplicación JavaScript Usa el paquete JavaScript para navegador en páginas frontend que emiten acciones de producto, logs y señales ligeras del cliente. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Abrir Add Project ## App Next.js Usa el paquete de Next.js cuando rutas, server rendering y acciones de cliente necesitan una sola ruta de setup. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Abrir Add Project ## App React Usa el paquete de React para apps web por componentes que envían acciones de usuario y estado de UI. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Abrir Add Project ## App Angular Usa el paquete de Angular cuando el routing del framework y los errores de la app deban compartir una ruta de setup. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Abrir Add Project ## App Vue Usa el paquete de Vue para apps Vue que necesitan acciones de producto y señales de navegador claras. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Abrir Add Project ## App Svelte Usa el paquete de Svelte para apps Svelte que necesitan una ruta directa de instalación SDK. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Abrir Add Project ## Servicio NestJS Usa el paquete de NestJS cuando un servicio Node está organizado alrededor de módulos Nest y manejo de requests. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Abrir Add Project ## Servicio Python Empieza con el paquete core para workers y servicios Python. ```bash python3 -m pip install logbrew-sdk ``` Next: Abrir Add Project ## App Django Usa el paquete de Django para señales de request y app desde un proyecto Django. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Abrir Add Project ## Servicio FastAPI Usa el paquete de FastAPI para APIs Python con spans de request y acciones explícitas. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Abrir Add Project ## Servicio .NET Instala el paquete .NET cuando un servicio posee señales server-side. ```bash dotnet add package LogBrew ``` Next: Abrir Add Project ## App ASP.NET Core Usa el paquete de ASP.NET Core cuando el manejo de requests de .NET y las señales de la app web deban compartir una ruta de setup. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Abrir Add Project ## Servicio Java Usa el paquete JVM para servicios Java que necesitan logs, spans de request y acciones de producto propias de la app. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Abrir Add Project ## Servicio Go Añade el paquete de Go cuando un servicio posee logs, spans, métricas y trace context explícitos. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Abrir Add Project ## App PHP Usa Composer para servicios PHP y señales de request propias de la app. ```bash composer require logbrew/sdk ``` Next: Abrir Add Project ## Servicio Ruby Usa la gem de Ruby para servicios Ruby que necesitan señales explícitas de app y request. ```bash gem install logbrew-sdk ``` Next: Abrir Add Project ## Servicio Rust Añade el crate de Rust para servicios que construyen sus propios logs, spans, acciones y métricas. ```bash cargo add logbrew ``` Next: Abrir Add Project ## App iOS Usa el paquete de plataforma Apple para apps iOS que envían señales de producto explícitas. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Abrir Add Project ## App Android Usa el paquete de Android para apps que envían señales propias desde el runtime Android. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Abrir Add Project ## App React Native Usa el paquete de React Native para apps móviles que comparten acciones de producto en JavaScript. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Abrir Add Project ## App Unity Usa el paquete de Unity para juegos o simulaciones que envían acciones de producto y señales runtime. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Abrir Add Project ## App C Usa las fuentes C para servicios nativos o apps embebidas que necesitan control directo de señales. ```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: Abrir Add Project ## App C++ Ejecuta el plan publicado de la CLI en un proyecto con CMake 3.16+ y C++17. Enlaza LogBrew::LogBrew. Activa LogBrew::HttpTransport y libcurl solo para la entrega alojada. ```bash logbrew setup --json ``` Next: Abrir Add Project ## Ruta de setup de un vistazo Usa este orden para pasar de la documentación a una acción de producto verificada sin salir del flujo de setup. - Instalar. Agregar paquete: Empieza con el paquete SDK para tu runtime. - Crear. Crear proyecto: Abre Add Project para la credencial de proyecto de un solo uso. - Enviar. Enviar una acción de producto: Ejecuta una acción de producto sin secretos antes de conectar la app. - Verificar. Revisar logs: Confirma la señal en logs o con la CLI. # Primera ejecución correcta del SDK Mantén la primera sesión enfocada: instala el paquete, crea el proyecto, envía una acción de producto sin secretos y confírmala en LogBrew. ## Lo necesario para la primera señal La ingesta directa del SDK mantiene corto el camino de setup. - Colector: Sin agente local. Instala el paquete del SDK y envía directamente a la API de LogBrew. - Credencial: Una credencial de proyecto. Cópiala desde Add Project solo al crear o configurar ese proyecto. - Prueba: Verificar en logs. Envía una señal info y confírmala antes de instrumentar más. ## Contexto para asistente de IA Da a un agente el mapa público de LogBrew antes de que edite tu app o el comando de configuración. ```bash curl -L https://logbrew.co/llms.txt ``` ### Prompt de configuración IA ```bash Lee https://logbrew.co/llms.txt y luego elige la tarjeta SDK correcta en https://logbrew.co/en/docs#docs-sdk-choice-title. Usa npm install @logbrew/sdk @logbrew/node solo para un servicio server-side Node.js; para Next.js, React, iOS, Android o React Native usa la tarjeta elegida y el prompt de Add Project. Pide al usuario con sesión iniciada que abra Add Project y coloque credenciales solo en el entorno de la app correspondiente. Para server-side Node.js, la variable de entorno es LOGBREW_SERVER_API_KEY. Ejecuta node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs solo para servicios Node y luego verifica con logbrew logs info --json. No pidas credenciales en el chat ni en commits. ``` Next: Abrir guía de agentes ## Instala el SDK Usa los paquetes de Node para un servicio backend que necesita logs, spans, acciones, versiones y métricas. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Crea el proyecto Abre Add Project, elige una plataforma y copia la credencial de ingesta de un solo uso desde el panel de setup. Next: Abrir Add Project ## Envía una acción de producto Ejecuta el ejemplo empaquetado antes de conectar código de producción para conocer la primera forma y mantenerla sin tokens. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Verifica en LogBrew Lee la primera señal info en logs antes de agregar más instrumentación. ```bash logbrew logs info --json ``` # Envía la primera señal del SDK Node a LogBrew Usa esta ruta Node cuando quieras datos reales del proyecto, no otro artículo de configuración. El dashboard crea el proyecto y muestra la credencial de ingesta de un solo uso; la documentación pública mantiene seguros los paquetes y pasos de verificación. ## Añade los paquetes del SDK de JavaScript Empieza con el SDK base y el helper de Node cuando un servicio backend necesite enviar logs, spans de petición, acciones, releases y métricas. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Crea el proyecto desde Add Project Inicia sesión, abre Add Project, elige una plataforma y copia la credencial de ingesta de un solo uso desde ese panel de setup. La website no la vuelve a mostrar al salir. ## Ejecuta el primer ejemplo de señal SDK Usa el ejemplo del paquete instalado para inspeccionar la forma de release, entorno, span de petición, acción de producto, hito de red y métrica antes de conectarlo a tu app. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Lee la primera señal en LogBrew Después de que el SDK envíe una señal info con la credencial del proyecto, confirma que llegó desde la CLI o la vista de logs del dashboard antes de añadir más instrumentación. ```bash logbrew logs info --json ``` # Elige tu ruta ## Comprueba si LogBrew está listo Ejecuta status primero para confirmar alcance, estado de sesión y la siguiente lectura segura. ```bash logbrew status --json ``` ## Empieza por los fallos recientes Lee logs error recientes y luego pasa a incidencias o trazas cuando una versión o proyecto necesite contexto. ```bash logbrew logs error --json ``` ## Comparte una vista estable de incidencias Lista incidencias abiertas cuando una persona del equipo necesite los mismos grupos de fallos. ```bash logbrew issues open --json ``` # Mapa de comandos ## Status Comprueba auth local, alcance de la API y pasos de recuperación antes de cualquier lectura privada. ```bash logbrew status --json ``` ## Logs Empieza por errores recientes cuando una versión, proyecto o traza necesite contexto. ```bash logbrew logs error --json ``` ## Incidencias Lista grupos abiertos antes de decidir si resolver, cerrar, ignorar o reabrir. ```bash logbrew issues open --json ``` ## Detalle de traza Lee una traza conocida cuando logs o incidencias apunten a una petición fallida. ```bash logbrew trace --json ``` ## Acciones Filtra eventos de usuario por nombre cuando el contexto importante sea una acción de producto. ```bash logbrew actions --name checkout_failed --json ``` ## Versiones Compara contexto de despliegue con recuentos de logs, incidencias, spans de traza y acciones. ```bash logbrew releases --json ``` ## Comprueba la autenticación local y el alcance de la API La primera lectura debe indicar si la CLI puede llegar a la API de LogBrew sin exponer material de token. - Usa modo JSON cuando un script o una automatización necesite campos estables. - Usa salida humana cuando una persona necesite el siguiente comando. - Mantén la recuperación de auth apuntando a login y status. ## Lee señales de producción por recurso Logs, incidencias, acciones, trazas, versiones y proyectos deben estar separados para escanear rápido y conectados para recuperar contexto. - Los logs conservan filtros de severidad, versión, entorno, proyecto, traza y búsqueda. - Las incidencias conservan estado, contexto de traza y vocabulario de mutación. - Las trazas conservan nombres de span, contexto de versión, contexto de entorno y alcance de proyecto. ## Envía contexto útil sin exponer datos del proyecto Usa docs públicas, Markdown y comandos copiables cuando alguien necesite ayuda de configuración o una transferencia segura. - Comparte un enlace de docs cuando el siguiente paso sea configurar o descubrir comandos. - Comparte Markdown cuando el texto plano sea mejor que una captura. - Mantén los datos de proyecto del panel detrás de inicio de sesión y auth del backend. ## Alinea el panel con las rutas del backend El espacio web debe seguir contratos documentados de la API de LogBrew, sin inventar almacenamiento exclusivo del panel ni contratos alternativos. - Los logs se leen desde /api/logs con filtros de severidad, versión, entorno, proyecto, traza y búsqueda. - Las incidencias se leen y mutan por /api/telemetry/issues y /api/telemetry/issues/{issue_id}. - Acciones, versiones y detalle de traza se leen por /api/telemetry/actions, /api/telemetry/releases y /api/telemetry/traces/{trace_id}. - Proyectos y estado de auth vienen de /api/projects, /api/auth y comandos CLI de status. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/es/docs - Docs Markdown: https://logbrew.co/es/docs.md - Agent guide: https://logbrew.co/es/agents - Home Markdown: https://logbrew.co/es/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml