# Configure a telemetria do LogBrew Escolha um app ou framework, crie um projeto e verifique um sinal seguro. # Escolher plataforma Escolha o app ou framework que envia a telemetria. Use a mesma opção em Adicionar projeto. ## Serviço Node.js Use o pacote Node.js quando um serviço de backend precisar de logs, spans de requisição, ações, versões e métricas. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Seguir o caminho do primeiro sinal no Node ## Serviço Express Use o pacote Express quando um serviço Node tratar requisições com middleware do Express. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Abrir Adicionar projeto ## Serviço Fastify Use o pacote Fastify quando um serviço Node tratar rotas com plugins do Fastify. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Abrir Adicionar projeto ## App JavaScript Use o pacote JavaScript para navegador em páginas de frontend que emitem ações de produto, logs e sinais leves do cliente. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Abrir Adicionar projeto ## App Next.js Use o pacote Next.js quando rotas, renderização no servidor e ações no cliente precisarem de um único caminho de configuração. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Abrir Adicionar projeto ## App React Use o pacote React em apps web baseados em componentes que enviam ações do usuário e o estado da interface. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Abrir Adicionar projeto ## App Angular Use o pacote Angular quando o roteamento do framework e os erros do app precisarem compartilhar um único caminho de configuração. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Abrir Adicionar projeto ## App Vue Use o pacote Vue em apps Vue que precisam de ações de produto claras e sinais do navegador. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Abrir Adicionar projeto ## App Svelte Use o pacote Svelte em apps Svelte que precisam de um caminho direto de instalação do SDK. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Abrir Adicionar projeto ## Serviço NestJS Use o pacote NestJS quando um serviço Node for organizado em módulos Nest e no tratamento de requisições. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Abrir Adicionar projeto ## Serviço Python Comece pelo pacote principal para workers e serviços Python. ```bash python3 -m pip install logbrew-sdk ``` Next: Abrir Adicionar projeto ## App Django Use o pacote Django para sinais de requisição e do app em um projeto Django. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Abrir Adicionar projeto ## Serviço FastAPI Use o pacote FastAPI para APIs Python com spans de requisição e ações explícitos. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Abrir Adicionar projeto ## Serviço .NET Instale o pacote .NET quando um serviço gerar os próprios sinais no servidor. ```bash dotnet add package LogBrew ``` Next: Abrir Adicionar projeto ## App ASP.NET Core Use o pacote ASP.NET Core quando o tratamento de requisições do .NET e os sinais do app web precisarem de um único caminho de configuração. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Abrir Adicionar projeto ## Serviço Java Use o pacote JVM em serviços Java que precisam de logs do próprio app, spans de requisição e ações de produto. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Abrir Adicionar projeto ## Serviço Go Adicione o pacote Go quando um serviço gerar explicitamente logs, spans, métricas e contexto de trace. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Abrir Adicionar projeto ## App PHP Use o Composer em serviços PHP e para sinais de requisição do próprio app. ```bash composer require logbrew/sdk ``` Next: Abrir Adicionar projeto ## Serviço Ruby Use a gem Ruby em serviços Ruby que precisam de sinais explícitos do app e das requisições. ```bash gem install logbrew-sdk ``` Next: Abrir Adicionar projeto ## Serviço Rust Adicione a crate Rust em serviços que montam os próprios logs, spans, ações e métricas. ```bash cargo add logbrew ``` Next: Abrir Adicionar projeto ## App iOS Use o pacote para plataformas Apple em apps iOS que enviam sinais de produto explícitos. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Abrir Adicionar projeto ## App Android Use o pacote Android em apps que enviam sinais próprios a partir do runtime Android. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Abrir Adicionar projeto ## App React Native Use o pacote React Native em apps móveis que compartilham ações de produto em JavaScript. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Abrir Adicionar projeto ## App Unity Use o pacote Unity em jogos ou simulações que enviam ações de produto e sinais de runtime. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Abrir Adicionar projeto ## App C Use os arquivos-fonte em C em serviços nativos ou apps embarcados que precisam de controle direto dos sinais. ```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 Adicionar projeto ## App C++ Execute o plano publicado da CLI em um projeto C++17 com CMake 3.16+. Faça o link com LogBrew::LogBrew. Ative LogBrew::HttpTransport e libcurl só quando o envio hospedado for necessário. ```bash logbrew setup --json ``` Next: Abrir Adicionar projeto ## Caminho de configuração em resumo Siga esta ordem para ir da documentação a uma ação de produto verificada sem sair do fluxo de configuração. - Instalar. Adicionar pacote: Comece pelo pacote do SDK do seu runtime. - Criar. Criar projeto: Abra Adicionar projeto e copie a credencial do projeto. Ela aparece uma única vez. - Enviar. Enviar uma ação de produto: Execute uma ação de produto sem segredos antes de integrar o app. - Verificar. Conferir logs: Confirme o sinal nos logs ou com a CLI. # Primeira execução do SDK com sucesso Mantenha a primeira sessão curta: instale o pacote, crie o projeto, envie uma ação de produto sem segredos e confirme no LogBrew. ## O que o primeiro sinal exige A ingestão direta pelo SDK mantém o caminho de configuração curto. - Coletor: Sem agente local. Instale o pacote do SDK e envie direto para a API do LogBrew. - Credencial: Uma credencial por projeto. Copie a credencial em Adicionar projeto só ao criar ou configurar esse projeto. - Confirmação: Verificar nos logs. Envie um sinal info e confirme que ele chegou antes de ampliar a instrumentação. ## Contexto para o assistente de IA Dê a um agente o mapa público do LogBrew antes que ele edite seu app ou o comando de configuração. ```bash curl -L https://logbrew.co/llms.txt ``` ### prompt de instalação ```bash Leia https://logbrew.co/llms.txt e escolha o card de SDK correspondente em https://logbrew.co/en/docs#docs-sdk-choice-title. Use npm install @logbrew/sdk @logbrew/node apenas para um serviço Node.js no servidor; para Next.js, React, iOS, Android ou React Native, use o card escolhido e o prompt de Adicionar projeto. Peça ao usuário conectado para abrir Adicionar projeto e colocar as credenciais apenas no ambiente do app correspondente. Para Node.js no servidor, a variável de ambiente é LOGBREW_SERVER_API_KEY. Execute node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs apenas para serviços Node e depois verifique com logbrew logs info --json. Não peça credenciais no chat nem em commits. ``` Next: Abrir guia para agentes ## Instalar SDK Use os pacotes Node em um serviço de backend que precisa de logs, spans, ações, versões e métricas. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Criar projeto Abra Adicionar projeto, escolha uma plataforma e copie a credencial de ingestão. A tela de configuração mostra a credencial uma única vez. Next: Abrir Adicionar projeto ## Enviar uma ação de produto Execute o exemplo incluído no pacote antes de integrar o código de produção. Assim, o formato do primeiro sinal fica conhecido e sem tokens. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Verificar no LogBrew Leia o primeiro sinal info nos logs antes de adicionar mais instrumentação. ```bash logbrew logs info --json ``` # Envie o primeiro sinal do SDK Node para o LogBrew Configure um serviço Node.js e verifique a primeira telemetria. Adicionar projeto cria o projeto e mostra a credencial de ingestão uma única vez. Os passos abaixo cobrem a instalação e a verificação. ## Adicione os pacotes do SDK JavaScript Comece pelo SDK principal e pelo helper para Node quando um serviço de backend precisar de logs, spans de requisição, ações, versões e métricas. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Crie o projeto em Adicionar projeto Entre, abra Adicionar projeto, escolha uma plataforma e copie a credencial de ingestão. Ela aparece uma única vez. O site não mostra a credencial de novo depois que você sai da tela de configuração. ## Execute o exemplo do primeiro sinal do SDK Use o exemplo do pacote instalado para conferir o formato da versão, do ambiente, do span de requisição, da ação de produto, do marco de rede e da métrica antes de integrar seu app. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## Leia o primeiro sinal no LogBrew Depois que o SDK enviar um sinal info com a credencial do projeto, use a CLI ou a tela de logs do painel para confirmar que ele chegou. Só então adicione mais instrumentação. ```bash logbrew logs info --json ``` # Escolha seu caminho ## Confira se o LogBrew está pronto Execute o status primeiro para confirmar o acesso à API, o estado do login e a próxima leitura segura. ```bash logbrew status --json ``` ## Comece pelas falhas mais recentes Leia os logs de erro recentes e passe para problemas ou traces quando uma versão ou um projeto precisar de contexto. ```bash logbrew logs error --json ``` ## Compartilhe uma visão estável dos problemas Liste os problemas abertos quando um colega precisar ver os mesmos grupos de falhas. ```bash logbrew issues open --json ``` # Mapa de comandos ## Status Confira a autenticação local, o acesso à API e as etapas de recuperação antes de qualquer leitura privada. ```bash logbrew status --json ``` ## Logs Comece pelos erros recentes quando uma versão, um projeto ou um trace precisar de contexto. ```bash logbrew logs error --json ``` ## Problemas Liste os grupos de falhas abertos antes de decidir se vai resolver, fechar, ignorar ou reabrir. ```bash logbrew issues open --json ``` ## Detalhes do trace Leia um trace pelo ID quando logs ou problemas apontarem para uma requisição com falha. ```bash logbrew trace --json ``` ## Ações Filtre eventos de usuário pelo nome quando o contexto importante for uma ação de produto. ```bash logbrew actions --name checkout_failed --json ``` ## Versões Compare o contexto da implantação com as contagens de logs, problemas, spans de trace e ações. ```bash logbrew releases --json ``` ## Confira a autenticação local e o acesso à API A primeira leitura deve dizer se a CLI consegue acessar a API do LogBrew sem expor tokens. - Use o modo JSON quando um script ou uma automação precisar de campos estáveis. - Use a saída legível quando um desenvolvedor precisar do próximo comando. - Mantenha a recuperação da autenticação apontando para login e status. ## Leia os sinais de produção por recurso Comece pelo sinal que responde à sua pergunta. Abra os detalhes para ver as evidências relacionadas. - Os logs mantêm filtros de gravidade, versão, ambiente, projeto, trace e busca. - Confira o status e a última ocorrência de um problema antes de investigá-lo. - Os traces mantêm nomes de spans, contexto de versão, contexto de ambiente e escopo do projeto. ## Envie contexto útil sem expor dados do projeto Use a documentação pública, o Markdown e comandos copiáveis quando alguém precisar de ajuda com a configuração ou de uma passagem segura. - Compartilhe um link da documentação quando o próximo passo for configurar ou descobrir comandos. - Compartilhe Markdown quando texto simples for mais fácil que uma captura de tela. - Compartilhe dados privados do projeto só com pessoas que têm permissão para vê-los. ## Escolha o projeto e o período Use a referência da API de telemetria para ver as rotas, os filtros e os exemplos de sucesso e de erro disponíveis. - Autentique-se antes de solicitar dados privados do projeto. - Selecione o projeto e o período antes de comparar resultados. - Siga as etapas de recuperação retornadas quando uma solicitação falhar. - Separe evidências ausentes de evidências que não puderam ser carregadas. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/pt-BR/docs - Docs Markdown: https://logbrew.co/pt-BR/docs.md - Agent guide: https://logbrew.co/pt-BR/agents - Home Markdown: https://logbrew.co/pt-BR/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml