Acompanhe quais categorias sua aplicação está enviando diagnósticos:
Verifique qual SDK está integrado na sua aplicação:
🟢 = SDK detectado enviando diagnósticos | 🔴 = SDK não detectado | ⚪ = Sem diagnósticos ainda
Sem SDK? Integre via POST HTTP direto:
POST https://debug-assist.onrender.com/v1/diagnosticos
Authorization: Bearer SUA_API_KEY
Content-Type: application/json
{
"tipo": "backend",
"mensagem": "Erro ao conectar ao banco de dados",
"contexto": {
"rota": "/users",
"metodo": "POST",
"status": 500,
"tempo_ms": 1234
}
}
• frontend — Erros de navegador, hidratação, performance
• sql — Queries lentas, N+1, índices ausentes
curl -X POST https://debug-assist.onrender.com/v1/diagnosticos \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tipo":"backend","mensagem":"Erro","contexto":{"rota":"/api"}}'
ℹ️ Resposta: A API retorna análise com problema, causa, sugestoes e confianca.
Resumo: SDKs fazem tudo automaticamente. API você controla manualmente.
// 1. Instalar
npm install debug-assist-sdk
// 2. Inicializar (2 linhas!)
const DebugAssist = require('debug-assist-sdk');
DebugAssist.init({ apiKey: 'sk_...' });
// 3. PRONTO! Erros capturam automaticamente
throw new Error('Erro'); // ← Automático!
Sem mais código. SDK captura exceções não tratadas.
// Você faz tudo manualmente
try {
throw new Error('Erro');
} catch(e) {
// Você mesmo envia:
await fetch('/v1/diagnosticos', {
headers: { 'Authorization': 'Bearer sk_...' },
body: JSON.stringify({
tipo: 'backend',
mensagem: e.message
})
});
}
Repetitivo. Você escreve try/catch em vários lugares.
- Aplicação em produção
- Quer erros automáticos
- Linguagem tem SDK
- Minimizar código boilerplate
- Script único
- Teste de integração
- Linguagem sem SDK
- Máximo controle
💡 Resumo: SDK = automático + fácil (produção). API = manual + controle (scripts).
Escolha sua linguagem e veja como integrar a Debug Assist na sua aplicação:
npm install debug-assist-sdk
const DebugAssist = require('debug-assist-sdk');
DebugAssist.init({
apiKey: 'SUA_API_KEY',
projectName: 'meu-projeto'
});
pip install debug-assist
import os
os.environ['DEBUG_ASSIST_API_KEY'] = 'SUA_API_KEY'
import debug_assist
<dependency>
<groupId>io.github.debug-assist</groupId>
<artifactId>debug-assist</artifactId>
<version>1.0.0</version>
</dependency>
import io.github.debugassist.DebugAssist;
public class Main {
public static void main(String[] args) {
DebugAssist.init();
// seu código aqui
}
}
dotnet add package DebugAssist
using DebugAssistSDK;
DebugAssist.EnsureInitialized();
// ou
DebugAssist.Init("SUA_API_KEY", "meu-projeto");
go get github.com/mirutee/debug-assist/sdk/go
import debugassist "github.com/mirutee/debug-assist/sdk/go"
func main() {
debugassist.Wrap(run)
}
func run() {
// seu código aqui
}
composer require debug-assist/debug-assist
require_once 'vendor/autoload.php';
// pronto! exceções são capturadas automaticamente
gem install debug-assist
require 'debug_assist'
# pronto! exceções são capturadas automaticamente
<script src="https://debug-assist.onrender.com/sdk/browser.js"
data-api-key="SUA_API_KEY"
data-project="meu-app"></script>
npm install debug-assist-browser
import DebugAssist from 'debug-assist-browser';
DebugAssist.init({
apiKey: 'SUA_API_KEY',
projectName: 'meu-app'
});
💡 Dica: Defina variáveis de ambiente para não expor a API key no código:
export DEBUG_ASSIST_API_KEY='SUA_API_KEY'
Siga este guia para começar a usar a Debug Assist na sua aplicação:
Clique no botão "Copiar" acima para guardar sua API Key. Você precisará dela em breve.
Na aba "Como Integrar" acima, selecione a linguagem do seu projeto (Node.js, Python, Java, etc.)
Copie e execute o comando de instalação da sua linguagem (ex: npm install debug-assist-sdk)
Copie o exemplo de código da aba "Como Integrar" e adicione ao seu projeto. A API Key já virá preenchida!
Rode sua aplicação e force um erro. A Debug Assist vai capturar automaticamente e enviar o diagnóstico.
Abra a aba "Histórico" para ver todos os diagnósticos capturados, com causa raiz e sugestões de correção.
O card "Recursos Integrados" acima mostra em tempo real quais categorias estão enviando diagnósticos (Backend, Frontend, SQL).
Sua aplicação está agora monitorada. Qualquer erro, exceção ou problema será diagnosticado automaticamente.
💡 Dica Extra: Você pode fazer diagnósticos manuais também! Veja a documentação para aprender sobre POST /v1/diagnosticos.