Fluxos

Instrumentar Python em Producao

Fluxo opinativo para publicar Obtrace em FastAPI, Django e serviços com workers.

Instrumentar Python em Producao

Use este fluxo quando o primeiro alvo sério de rollout for um serviço Python.

Sequencia

  1. Instale o SDK Python
  2. Configure Autenticação
  3. Adicione service, env e version
  4. Valide um caminho real de request
  5. Conecte metadata de release

Exemplo de bootstrap

import os
 
from fastapi import FastAPI
from obtrace_sdk import ObtraceClient, ObtraceConfig, SemanticMetrics
from obtrace_sdk.http import fastapi_middleware
 
client = ObtraceClient(
    ObtraceConfig(
        api_key=os.getenv("OBTRACE_API_KEY"),
        tenant_id=os.getenv("OBTRACE_TENANT_ID"),
        project_id=os.getenv("OBTRACE_PROJECT_ID"),
        app_id="checkout-api",
        service_name="checkout-api",
        service_version=os.getenv("OBTRACE_SERVICE_VERSION", "2026.03.10"),
        env=os.getenv("OBTRACE_ENV", "prod"),
    )
)
 
app = FastAPI()
app.middleware("http")(fastapi_middleware(client))
 
@app.get("/healthz")
async def healthz():
    client.log("info", "healthz.request")
    client.metric(SemanticMetrics.RUNTIME_CPU_UTILIZATION, 0.41)
    client.span("http.server GET /healthz", attrs={
        "http.method": "GET",
        "http.route": "/healthz",
        "cloud.region": os.getenv("AWS_REGION", "us-east-1"),
    })
    return {"ok": True}

Nesta página