Início Rápido

O Obtrace entrega mais valor quando telemetria, metadata de release e contexto de repositório estão conectados cedo. Este quickstart prioriza o menor caminho até uma base confiável de sinais em produção.

Resultado esperado

Ao final, você deve ter:

• Um serviço backend instrumentado.
• Tags estáveis de service, env e version.
• Um ambiente de runtime conectado.
• Contexto suficiente para análise de causa raiz e decisão de remediação.

Passo 1: Instrumente seu serviço

Opção A: Obtrace Zero (sem código)

O caminho mais rápido. O Obtrace Zero instrumenta seus serviços automaticamente sem alteração de código — usando eBPF, agentes por linguagem ou injeção de sidecar dependendo do seu runtime.

• Início Rápido do Obtrace Zero
• Como funciona
• Agentes por Linguagem — detalhamento por linguagem do que é capturado automaticamente
• Estratégias de Instrumentação

Suporta Node.js, Python, Java, .NET, PHP, Ruby e Go nativamente.

Opção B: SDK (instrumentação manual)

Para controle total sobre o que é capturado, use um SDK diretamente:

• Python
• Go
• Java
• Node/Bun
• .NET
• PHP
• Ruby
• Kotlin
• Rust
• Swift
• Browser

Agentes

• Database Agent — coleta métricas de banco de dados de PostgreSQL, MySQL, MongoDB, Redis e mais sem alteração de código

Passo 2: Defina atributos canônicos

Todo evento, span e erro deve incluir:

• service
• env
• version
• region quando aplicavel

Exemplo:

const sdk = initNodeSDK({
  apiKey: process.env.OBTRACE_API_KEY!,
  tenantId: process.env.OBTRACE_TENANT_ID,
  projectId: process.env.OBTRACE_PROJECT_ID,
  appId: "checkout-api",
  env: process.env.OBTRACE_ENV,
  serviceName: "checkout-api",
  serviceVersion: process.env.OBTRACE_SERVICE_VERSION,
});
 
sdk.span({
  name: "checkout.authorize",
  attrs: {
    "cloud.region": process.env.AWS_REGION ?? "us-east-1",
  },
});

Passo 3: Conecte o ambiente

• Kubernetes
• Serverless
• Visão geral de ambientes

Passo 4: Valide a ingestão

Resultado esperado:

• A telemetria flui continuamente.
• As tags permanecem estáveis entre deploys.
• Os erros tem contexto suficiente para diagnóstico.

Passo 5: Entenda a remediação

• Como o Obtrace detecta incidentes
• Como a análise de causa raiz funciona
• Como a IA decide abrir um PR
• Permissões do GitHub App