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.

Elegir plataformaAbrir Add Project

Elige plataforma

Empieza por la app o framework que coincide con tu proyecto. Usa la misma opción en Add Project.

Filtrar plataformas
6 de 26 visibles

Node.js

Servicio Node.js

Usa el paquete de Node.js cuando un servicio backend necesita logs, spans de request, acciones, releases y métricas.

npm install @logbrew/sdk @logbrew/node
Usar la ruta de primera señal Node

Express

Servicio Express

Usa el paquete de Express cuando un servicio Node maneja requests con middleware de Express.

npm install @logbrew/sdk @logbrew/express express
Abrir Add Project

Fastify

Servicio Fastify

Usa el paquete de Fastify cuando un servicio Node maneja rutas con plugins de Fastify.

npm install @logbrew/sdk @logbrew/fastify fastify
Abrir Add Project

NestJS

Servicio NestJS

Usa el paquete de NestJS cuando un servicio Node está organizado alrededor de módulos Nest y manejo de requests.

npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs
Abrir Add Project

Python

Servicio Python

Empieza con el paquete core para workers y servicios Python.

python3 -m pip install logbrew-sdk
Abrir Add Project

Django

App Django

Usa el paquete de Django para señales de request y app desde un proyecto Django.

python3 -m pip install logbrew-sdk logbrew-django
Abrir Add Project

Comando de instalación

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.

  1. 1Instala el SDKUsa los paquetes de Node para un servicio backend que necesita logs, spans, acciones, versiones y métricas.
    npm install @logbrew/sdk @logbrew/node
  2. 2Crea el proyectoAbre Add Project, elige una plataforma y copia la credencial de ingesta de un solo uso desde el panel de setup.Abrir Add Project
  3. 3Envía una acción de productoEjecuta el ejemplo empaquetado antes de conectar código de producción para conocer la primera forma y mantenerla sin tokens.
    node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs
  4. 4Verifica en LogBrewLee la primera señal info en logs antes de agregar más instrumentación.
    logbrew logs info --json
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.

curl -L https://logbrew.co/llms.txt
Prompt de configuración IALee 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.
Abrir guía de agentes
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.

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

    npm install @logbrew/sdk @logbrew/node

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

    Abrir Add Project

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

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

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

    logbrew logs info --json
Superficies de docs3

docs.logbrew.co

Sitio completo de docs

Usa el sitio dedicado de docs para la configuración larga, detalles de API y ejemplos que no deben saturar las páginas de producto.

Abrir sitio de docs

Texto plano

Espejo Markdown de docs

Usa el espejo Markdown localizado cuando un agente o flujo de terminal necesite las mismas docs sin estado exclusivo del navegador.

Abrir Markdown

Texto plano

Espejos para agentes

Usa llms.txt, espejos Markdown, robots y sitemap cuando un agente necesite rutas públicas de lectura predecibles.

Abrir llms.txt
Elige tu ruta3

Configurar

Comprueba si LogBrew está listo

Ejecuta status primero para confirmar alcance, estado de sesión y la siguiente lectura segura.

logbrew status --json

Triaje

Empieza por los fallos recientes

Lee logs error recientes y luego pasa a incidencias o trazas cuando una versión o proyecto necesite contexto.

logbrew logs error --json

Transferir

Comparte una vista estable de incidencias

Lista incidencias abiertas cuando una persona del equipo necesite los mismos grupos de fallos.

logbrew issues open --json
Mapa de comandos6

Mapa de comandos

Status

Comprueba auth local, alcance de la API y pasos de recuperación antes de cualquier lectura privada.

logbrew status --json

Mapa de comandos

Logs

Empieza por errores recientes cuando una versión, proyecto o traza necesite contexto.

logbrew logs error --json

Mapa de comandos

Incidencias

Lista grupos abiertos antes de decidir si resolver, cerrar, ignorar o reabrir.

logbrew issues open --json

Mapa de comandos

Detalle de traza

Lee una traza conocida cuando logs o incidencias apunten a una petición fallida.

logbrew trace <trace_id> --json

Mapa de comandos

Acciones

Filtra eventos de usuario por nombre cuando el contexto importante sea una acción de producto.

logbrew actions --name checkout_failed --json

Mapa de comandos

Versiones

Compara contexto de despliegue con recuentos de logs, incidencias, spans de traza y acciones.

logbrew releases --json
Docs de LogBrew4

CLI primero

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.

Observar

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.

Compartir

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.

Mapa de API

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.