azify-logger 1.0.29 → 1.0.30

package/README.md

@@ -10,15 +10,15 @@ Sistema de logging centralizado com OpenTelemetry e OpenSearch para múltiplas a
 |----------|-----|
 | **Development** | `http://localhost:3001/log` |
 | **Staging** | `https://logsdashboard.azify.dev/send` |
-| **Production** | `https://logsdashboard.azify.prd/send` | (a configurar)
+| **Production** | `https://cadence.aztech.host/send` | 
 
 ### URLs para acessar os logs:
 
-| Ambiente | URL |
-|----------|-----|
-| **Development** | Grafana: `http://localhost:3002` |
+| Ambiente | URL                               |
+|----------|-----------------------------------|
+| **Development** | `http://localhost:3002`  |
 | **Staging** | `https://logsdashboard.azify.dev` |
-| **Production** | `https://logsdashboard.azify.com` |
+| **Production** | `https://cadence.aztech.host`     |
 
 ## 📦 Instalação
 
@@ -68,11 +68,12 @@ await fastify.listen({ port: 3000 })
 
 ## ⚙️ Variáveis de Ambiente
 
-| Variável | Padrão | Descrição |
-|----------|-------|-----------|
-| `APP_NAME` | - | Nome da aplicação |
-| `AZIFY_LOGGER_URL` | `http://localhost:3001/log` | URL do logger |
-| `NODE_ENV` | `development` | Ambiente |
+| Variável | Padrão                             | Descrição |
+|----------|------------------------------------|-----------|
+| `APP_NAME` | -                                  | Nome da aplicação |
+| `AZIFY_LOGGER_URL` | `http://localhost:3001/log`        | URL do logger |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | `http://localhost:4318/v1/traces`  | Endpoint OTLP para traces (opcional) |
+| `NODE_ENV` | `development`                      | Ambiente |
 
 ## 🎯 O Que Você Ganha
 
@@ -81,6 +82,27 @@ await fastify.listen({ port: 3000 })
 - ✅ **Trace Consistente**: REQUEST e RESPONSE com mesmo traceId/spanId
 - ✅ **Genérico**: Funciona com Bunyan, Pino, console.log ou qualquer logger
 - ✅ **Centralizado**: Todos os logs no OpenSearch
+- ✅ **Tracing Completo**: Traces exportados via OTLP para Grafana Tempo (opcional)
+
+## 📡 OpenTelemetry Collector
+
+O `azify-logger` inclui um OpenTelemetry Collector configurado para receber traces via OTLP e exportá-los para Grafana Tempo.
+
+### Configuração
+
+Para habilitar o envio de traces, configure a variável de ambiente na sua aplicação:
+
+```bash
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318/v1/traces
+```
+
+### URLs
+
+| Ambiente | URL |
+|----------|-----|
+| **Development** | `http://localhost:4318/v1/traces` |
+| **Staging** | `https://logsdashboard.azify.dev/v1/traces` |
+| **Production** | `https://cadence.aztech.host/v1/traces` | 
 
 ## 🔍 Como Funciona
 

package/middleware-express.js

@@ -1,9 +1,20 @@
-const { startRequestContext } = require('./store')
+const { startRequestContext, runWithRequestContext, getRequestContext } = require('./store')
 const { createHttpLoggerTransport } = require('./streams/httpQueue')
 const { Worker } = require('worker_threads')
 const path = require('path')
 const os = require('os')
 
+// Importar OpenTelemetry para sincronizar contexto
+let trace, otelContext
+try {
+  const otelApi = require('@opentelemetry/api')
+  trace = otelApi.trace
+  otelContext = otelApi.context
+} catch (_) {
+  trace = { getSpan: () => null }
+  otelContext = { active: () => ({}) }
+}
+
 function fastUUID() {
   const timestamp = Date.now().toString(36)
   const randomPart = Math.random().toString(36).substring(2, 15)
@@ -159,20 +170,67 @@ function createExpressLoggingMiddleware(options = {}) {
     let headersCached = false
     let reqCtx = null
     
-    next()
+    // Função para extrair traceId/spanId do contexto OTEL ativo
+    function getOtelTraceContext() {
+      try {
+        const activeContext = otelContext.active()
+        const span = trace.getSpan(activeContext)
+        if (span) {
+          const spanContext = span.spanContext()
+          if (spanContext && spanContext.traceId && spanContext.spanId) {
+            // Converter traceId de hex para formato UUID
+            const traceHex = spanContext.traceId.replace(/-/g, '')
+            return {
+              traceId: traceHex.length === 32 ? `${traceHex.substring(0, 8)}-${traceHex.substring(8, 12)}-${traceHex.substring(12, 16)}-${traceHex.substring(16, 20)}-${traceHex.substring(20, 32)}` : spanContext.traceId,
+              spanId: spanContext.spanId,
+              parentSpanId: null // OTEL gerencia isso internamente
+            }
+          }
+        }
+      } catch (_) {}
+      return null
+    }
     
-    const logWithContext = (level, message, meta) => {
-      if (!reqCtx) {
-        const traceHex = sanitizeTraceHex(req.headers['x-trace-id'])
-        reqCtx = startRequestContext({
-          requestId: requestId || req.requestId || fastUUID(),
-          traceHex,
-          parentSpanId: req.headers['x-parent-span-id'] || null
-        })
+    // Criar contexto inicial sincronizado com OTEL
+    function ensureRequestContext() {
+      if (reqCtx) return reqCtx
+      
+      // Tentar pegar do OTEL primeiro
+      const otelCtx = getOtelTraceContext()
+      const traceHex = otelCtx ? otelCtx.traceId.replace(/-/g, '').substring(0, 32) : sanitizeTraceHex(req.headers['x-trace-id'])
+      
+      reqCtx = startRequestContext({
+        requestId: req.requestId || fastUUID(),
+        traceHex: traceHex || undefined,
+        parentSpanId: otelCtx?.parentSpanId || req.headers['x-parent-span-id'] || null
+      })
+      
+      // Se OTEL tem contexto, usar os IDs do OTEL
+      if (otelCtx) {
+        reqCtx.traceId = otelCtx.traceId
+        reqCtx.spanId = otelCtx.spanId
       }
-      meta.traceId = meta.traceId || reqCtx.traceId
-      meta.spanId = meta.spanId || reqCtx.spanId
-      meta.parentSpanId = meta.parentSpanId || reqCtx.parentSpanId
+      
+      return reqCtx
+    }
+    
+    // Garantir que o contexto está disponível e sincronizado com OTEL ANTES de processar
+    const ctx = ensureRequestContext()
+    
+    // Executar a requisição dentro do contexto AsyncLocalStorage
+    // Isso garante que todos os logs intermediários peguem o mesmo traceId
+    runWithRequestContext(ctx, () => {
+      next()
+    })
+    
+    const logWithContext = (level, message, meta) => {
+      // Sempre tentar pegar do OTEL primeiro (mais confiável)
+      const otelCtx = getOtelTraceContext()
+      const ctx = getRequestContext() || ensureRequestContext()
+      
+      meta.traceId = otelCtx?.traceId || meta.traceId || ctx.traceId
+      meta.spanId = otelCtx?.spanId || meta.spanId || ctx.spanId
+      meta.parentSpanId = otelCtx?.parentSpanId || meta.parentSpanId || ctx.parentSpanId
       sendLog(level, message, meta)
     }
     
@@ -182,19 +240,21 @@ function createExpressLoggingMiddleware(options = {}) {
       
       query = req.query || null
       
-      if (!reqCtx) {
-        const traceHex = sanitizeTraceHex(req.headers['x-trace-id'])
-        reqCtx = startRequestContext({
-          requestId: req.requestId || fastUUID(),
-          traceHex,
-          parentSpanId: req.headers['x-parent-span-id'] || null
-        })
+      const ctx = ensureRequestContext()
+      
+      // Priorizar OTEL se disponível
+      const otelCtx = getOtelTraceContext()
+      if (otelCtx) {
+        traceId = otelCtx.traceId
+        spanId = otelCtx.spanId
+        parentSpanId = otelCtx.parentSpanId
+      } else {
+        traceId = ctx.traceId
+        spanId = ctx.spanId
+        parentSpanId = ctx.parentSpanId || req.headers['x-parent-span-id'] || null
       }
       
-      requestId = reqCtx.requestId || req.requestId || fastUUID()
-      traceId = reqCtx.traceId
-      spanId = reqCtx.spanId
-      parentSpanId = reqCtx.parentSpanId || req.headers['x-parent-span-id'] || null
+      requestId = ctx.requestId || req.requestId || fastUUID()
       
       clientIp = req.ip || req.connection?.remoteAddress || req.socket?.remoteAddress || 'unknown'
       req.requestId = requestId

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azify-logger",
-  "version": "1.0.29",
+  "version": "1.0.30",
   "description": "Azify Logger Client - Centralized logging for OpenSearch",
   "main": "index.js",
   "types": "index.d.ts",
@@ -31,7 +31,7 @@
     "@opentelemetry/api": "1.0.4",
     "@opentelemetry/auto-instrumentations-node": "0.27.0",
     "@opentelemetry/core": "1.0.1",
-    "@opentelemetry/exporter-trace-otlp-http": "0.27.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.27.0",
     "@opentelemetry/instrumentation-express": "0.27.0",
     "@opentelemetry/instrumentation-http": "0.27.0",
     "@opentelemetry/instrumentation-restify": "0.27.0",
@@ -55,7 +55,6 @@
     "@opentelemetry/resources": "1.0.1",
     "@opentelemetry/semantic-conventions": "1.0.1",
     "@opentelemetry/sdk-node": "0.27.0",
-    "@opentelemetry/exporter-trace-otlp-http": "0.27.0",
     "@opentelemetry/auto-instrumentations-node": "0.27.0"
   },
   "engines": {

package/register-otel.js

@@ -3,6 +3,8 @@ try {
   const { HttpInstrumentation } = require('@opentelemetry/instrumentation-http')
   const { ExpressInstrumentation } = require('@opentelemetry/instrumentation-express')
   const { RestifyInstrumentation } = require('@opentelemetry/instrumentation-restify')
+  const { Resource } = require('@opentelemetry/resources')
+  const { SEMRESATTRS_SERVICE_NAME, SEMRESATTRS_SERVICE_VERSION } = require('@opentelemetry/semantic-conventions')
 
   const serviceName = process.env.OTEL_SERVICE_NAME || process.env.APP_NAME || 'app'
   const serviceVersion = process.env.OTEL_SERVICE_VERSION || '1.0.0'
@@ -10,6 +12,12 @@ try {
   process.env.OTEL_SERVICE_NAME = serviceName
   process.env.OTEL_SERVICE_VERSION = serviceVersion
 
+  const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT || process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
+  if (otlpEndpoint) {
+    process.env.OTEL_EXPORTER_OTLP_ENDPOINT = otlpEndpoint
+    process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = otlpEndpoint
+  }
+
   let collectorHost = null
   let collectorPath = null
   try {
@@ -62,9 +70,109 @@ try {
     enabled: true
   })
 
+  let traceExporter = null
+  if (otlpEndpoint) {
+    try {
+      let endpointUrl
+      try {
+        endpointUrl = new URL(otlpEndpoint)
+      } catch (urlErr) {
+        throw new Error(`URL inválida: ${otlpEndpoint}`)
+      }
+      
+      const http = require('http')
+      const url = new URL(otlpEndpoint)
+      
+      traceExporter = {
+        export: function(spans, resultCallback) {
+          if (!spans || spans.length === 0) {
+            if (resultCallback) resultCallback({ code: 0 })
+            return
+          }
+          
+          try {
+            const resourceSpans = [{
+              resource: {
+                attributes: [
+                  { key: 'service.name', value: { stringValue: serviceName } },
+                  { key: 'service.version', value: { stringValue: serviceVersion } }
+                ]
+              },
+              scopeSpans: [{
+                spans: spans.map(span => {
+                  const ctx = span.spanContext()
+                  return {
+                    traceId: ctx.traceId.replace(/-/g, '').padStart(32, '0').substring(0, 32),
+                    spanId: ctx.spanId.replace(/-/g, '').padStart(16, '0').substring(0, 16),
+                    name: span.name || 'span',
+                    kind: span.kind || 1,
+                    startTimeUnixNano: String(span.startTime?.[0] * 1e9 + (span.startTime?.[1] || 0) || Date.now() * 1e6),
+                    endTimeUnixNano: String(span.endTime?.[0] * 1e9 + (span.endTime?.[1] || 0) || Date.now() * 1e6),
+                    attributes: Object.entries(span.attributes || {}).map(([k, v]) => ({
+                      key: k,
+                      value: { stringValue: String(v) }
+                    }))
+                  }
+                })
+              }]
+            }]
+            
+            const payload = JSON.stringify({ resourceSpans })
+            
+            const options = {
+              hostname: url.hostname,
+              port: url.port || (url.protocol === 'https:' ? 443 : 80),
+              path: url.pathname,
+              method: 'POST',
+              headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(payload)
+              }
+            }
+            
+            const req = http.request(options, (res) => {
+              let data = ''
+              res.on('data', (chunk) => { data += chunk })
+              res.on('end', () => {
+                if (res.statusCode >= 200 && res.statusCode < 300) {
+                  if (resultCallback) resultCallback({ code: 0 })
+                } else {
+                  if (resultCallback) resultCallback({ code: 1, error: new Error(`HTTP ${res.statusCode}`) })
+                }
+              })
+            })
+            
+            req.on('error', (err) => {
+              if (resultCallback) resultCallback({ code: 1, error: err })
+            })
+            
+            req.write(payload)
+            req.end()
+          } catch (err) {
+            if (resultCallback) resultCallback({ code: 1, error: err })
+          }
+        },
+        shutdown: function() {
+          return Promise.resolve()
+        }
+      }
+      
+    } catch (err) {
+    }
+  }
+
+  let spanProcessor = null
+  if (traceExporter) {
+    const { SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-base')
+    spanProcessor = new SimpleSpanProcessor(traceExporter)
+  }
+  
   const sdk = new NodeSDK({
-    serviceName,
-    serviceVersion,
+    resource: new Resource({
+      [SEMRESATTRS_SERVICE_NAME]: serviceName,
+      [SEMRESATTRS_SERVICE_VERSION]: serviceVersion
+    }),
+    spanProcessor,
     instrumentations: [
       httpInstrumentation,
       expressInstrumentation,

package/register.js

@@ -175,14 +175,17 @@ try {
             
             logger.info = function(obj, msg, ...args) {
               const ctx = getRequestContext()
-              if (ctx && ctx.traceId) {
+              const otelCtx = !ctx || !ctx.traceId ? getOtelTraceContext() : null
+              const traceCtx = ctx || otelCtx
+              
+              if (traceCtx && traceCtx.traceId) {
                 if (typeof obj === 'object' && obj !== null) {
-                  obj.traceId = ctx.traceId
-                  obj.spanId = ctx.spanId
-                  obj.parentSpanId = ctx.parentSpanId
-                  obj.requestId = ctx.requestId
+                  obj.traceId = traceCtx.traceId
+                  obj.spanId = traceCtx.spanId
+                  obj.parentSpanId = traceCtx.parentSpanId
+                  obj.requestId = traceCtx.requestId || ctx?.requestId
                 } else {
-                  obj = { traceId: ctx.traceId, spanId: ctx.spanId, parentSpanId: ctx.parentSpanId, requestId: ctx.requestId, msg: obj }
+                  obj = { traceId: traceCtx.traceId, spanId: traceCtx.spanId, parentSpanId: traceCtx.parentSpanId, requestId: traceCtx.requestId || ctx?.requestId, msg: obj }
                 }
               }
               return originalInfo.call(this, obj, msg, ...args)
@@ -190,14 +193,17 @@ try {
             
             logger.error = function(obj, msg, ...args) {
               const ctx = getRequestContext()
-              if (ctx && ctx.traceId) {
+              const otelCtx = !ctx || !ctx.traceId ? getOtelTraceContext() : null
+              const traceCtx = ctx || otelCtx
+              
+              if (traceCtx && traceCtx.traceId) {
                 if (typeof obj === 'object' && obj !== null) {
-                  obj.traceId = ctx.traceId
-                  obj.spanId = ctx.spanId
-                  obj.parentSpanId = ctx.parentSpanId
-                  obj.requestId = ctx.requestId
+                  obj.traceId = traceCtx.traceId
+                  obj.spanId = traceCtx.spanId
+                  obj.parentSpanId = traceCtx.parentSpanId
+                  obj.requestId = traceCtx.requestId || ctx?.requestId
                 } else {
-                  obj = { traceId: ctx.traceId, spanId: ctx.spanId, parentSpanId: ctx.parentSpanId, requestId: ctx.requestId, msg: obj }
+                  obj = { traceId: traceCtx.traceId, spanId: traceCtx.spanId, parentSpanId: traceCtx.parentSpanId, requestId: traceCtx.requestId || ctx?.requestId, msg: obj }
                 }
               }
               return originalError.call(this, obj, msg, ...args)
@@ -205,14 +211,17 @@ try {
             
             logger.warn = function(obj, msg, ...args) {
               const ctx = getRequestContext()
-              if (ctx && ctx.traceId) {
+              const otelCtx = !ctx || !ctx.traceId ? getOtelTraceContext() : null
+              const traceCtx = ctx || otelCtx
+              
+              if (traceCtx && traceCtx.traceId) {
                 if (typeof obj === 'object' && obj !== null) {
-                  obj.traceId = ctx.traceId
-                  obj.spanId = ctx.spanId
-                  obj.parentSpanId = ctx.parentSpanId
-                  obj.requestId = ctx.requestId
+                  obj.traceId = traceCtx.traceId
+                  obj.spanId = traceCtx.spanId
+                  obj.parentSpanId = traceCtx.parentSpanId
+                  obj.requestId = traceCtx.requestId || ctx?.requestId
                 } else {
-                  obj = { traceId: ctx.traceId, spanId: ctx.spanId, parentSpanId: ctx.parentSpanId, requestId: ctx.requestId, msg: obj }
+                  obj = { traceId: traceCtx.traceId, spanId: traceCtx.spanId, parentSpanId: traceCtx.parentSpanId, requestId: traceCtx.requestId || ctx?.requestId, msg: obj }
                 }
               }
               return originalWarn.call(this, obj, msg, ...args)
@@ -220,14 +229,17 @@ try {
             
             logger.debug = function(obj, msg, ...args) {
               const ctx = getRequestContext()
-              if (ctx && ctx.traceId) {
+              const otelCtx = !ctx || !ctx.traceId ? getOtelTraceContext() : null
+              const traceCtx = ctx || otelCtx
+              
+              if (traceCtx && traceCtx.traceId) {
                 if (typeof obj === 'object' && obj !== null) {
-                  obj.traceId = ctx.traceId
-                  obj.spanId = ctx.spanId
-                  obj.parentSpanId = ctx.parentSpanId
-                  obj.requestId = ctx.requestId
+                  obj.traceId = traceCtx.traceId
+                  obj.spanId = traceCtx.spanId
+                  obj.parentSpanId = traceCtx.parentSpanId
+                  obj.requestId = traceCtx.requestId || ctx?.requestId
                 } else {
-                  obj = { traceId: ctx.traceId, spanId: ctx.spanId, parentSpanId: ctx.parentSpanId, requestId: ctx.requestId, msg: obj }
+                  obj = { traceId: traceCtx.traceId, spanId: traceCtx.spanId, parentSpanId: traceCtx.parentSpanId, requestId: traceCtx.requestId || ctx?.requestId, msg: obj }
                 }
               }
               return originalDebug.call(this, obj, msg, ...args)
@@ -235,14 +247,17 @@ try {
             
             logger.fatal = function(obj, msg, ...args) {
               const ctx = getRequestContext()
-              if (ctx && ctx.traceId) {
+              const otelCtx = !ctx || !ctx.traceId ? getOtelTraceContext() : null
+              const traceCtx = ctx || otelCtx
+              
+              if (traceCtx && traceCtx.traceId) {
                 if (typeof obj === 'object' && obj !== null) {
-                  obj.traceId = ctx.traceId
-                  obj.spanId = ctx.spanId
-                  obj.parentSpanId = ctx.parentSpanId
-                  obj.requestId = ctx.requestId
+                  obj.traceId = traceCtx.traceId
+                  obj.spanId = traceCtx.spanId
+                  obj.parentSpanId = traceCtx.parentSpanId
+                  obj.requestId = traceCtx.requestId || ctx?.requestId
                 } else {
-                  obj = { traceId: ctx.traceId, spanId: ctx.spanId, parentSpanId: ctx.parentSpanId, requestId: ctx.requestId, msg: obj }
+                  obj = { traceId: traceCtx.traceId, spanId: traceCtx.spanId, parentSpanId: traceCtx.parentSpanId, requestId: traceCtx.requestId || ctx?.requestId, msg: obj }
                 }
               }
               return originalFatal.call(this, obj, msg, ...args)
@@ -250,14 +265,17 @@ try {
             
             logger.trace = function(obj, msg, ...args) {
               const ctx = getRequestContext()
-              if (ctx && ctx.traceId) {
+              const otelCtx = !ctx || !ctx.traceId ? getOtelTraceContext() : null
+              const traceCtx = ctx || otelCtx
+              
+              if (traceCtx && traceCtx.traceId) {
                 if (typeof obj === 'object' && obj !== null) {
-                  obj.traceId = ctx.traceId
-                  obj.spanId = ctx.spanId
-                  obj.parentSpanId = ctx.parentSpanId
-                  obj.requestId = ctx.requestId
+                  obj.traceId = traceCtx.traceId
+                  obj.spanId = traceCtx.spanId
+                  obj.parentSpanId = traceCtx.parentSpanId
+                  obj.requestId = traceCtx.requestId || ctx?.requestId
                 } else {
-                  obj = { traceId: ctx.traceId, spanId: ctx.spanId, parentSpanId: ctx.parentSpanId, requestId: ctx.requestId, msg: obj }
+                  obj = { traceId: traceCtx.traceId, spanId: traceCtx.spanId, parentSpanId: traceCtx.parentSpanId, requestId: traceCtx.requestId || ctx?.requestId, msg: obj }
                 }
               }
               return originalTrace.call(this, obj, msg, ...args)

package/server.js

@@ -481,6 +481,90 @@ async function setupGrafanaForApp(appName) {
       }
     }
 
+    // Datasource Grafana Tempo para tracing completo (opcional - não bloqueia criação da org)
+    try {
+      const tempoDatasourceUid = `tempo-${appName.toLowerCase()}`
+      const tempoUrl = runningInDocker ? 'http://azify-tempo:3200' : 'http://localhost:3200'
+      const tempoDatasourceConfig = {
+        name: `Tempo-${appName}`,
+        type: 'tempo',
+        access: 'proxy',
+        url: tempoUrl,
+        uid: tempoDatasourceUid,
+        isDefault: false,
+        jsonData: {
+          httpMethod: 'GET',
+          tracesToLogs: {
+            datasourceUid: datasourceUid,
+            tags: ['job', 'service', 'pod'],
+            mappedTags: [{ key: 'service.name', value: 'service' }],
+            mapTagNamesEnabled: false,
+            spanStartTimeShift: '1h',
+            spanEndTimeShift: '1h',
+            filterByTraceID: false,
+            filterBySpanID: false
+          },
+          serviceMap: {
+            datasourceUid: datasourceUid
+          },
+          nodeGraph: {
+            enabled: true
+          },
+          search: {
+            hide: false
+          }
+        },
+        editable: true,
+        version: 1
+      }
+
+      try {
+        console.log(`[setupGrafana] Verificando datasource Tempo existente: ${tempoDatasourceUid} na org ${org.id}`)
+        const existingTempo = await axios.get(`${grafanaUrl}/api/datasources/uid/${tempoDatasourceUid}`, {
+          auth,
+          headers: { 'X-Grafana-Org-Id': org.id },
+          timeout: 3000
+        })
+        console.log(`[setupGrafana] Datasource Tempo existente encontrado: ${existingTempo.data?.id || 'N/A'}`)
+        try {
+          await axios.put(
+            `${grafanaUrl}/api/datasources/${existingTempo.data.id}`,
+            tempoDatasourceConfig,
+            {
+              auth,
+              headers: { 'X-Grafana-Org-Id': org.id },
+              timeout: 3000
+            }
+          )
+          console.log(`[setupGrafana] ✅ Datasource Tempo atualizado: ${tempoDatasourceUid}`)
+        } catch (updateTempoErr) {
+          console.error(`[setupGrafana] ⚠️  Erro ao atualizar datasource Tempo: ${updateTempoErr.response?.data?.message || updateTempoErr.message}`)
+        }
+      } catch (tempoError) {
+        console.log(`[setupGrafana] Erro ao verificar datasource Tempo: status=${tempoError.response?.status || 'N/A'}, message=${tempoError.response?.data?.message || tempoError.message}`)
+        if (tempoError.response?.status === 404) {
+          try {
+            const tempoCreate = await axios.post(
+              `${grafanaUrl}/api/datasources`,
+              tempoDatasourceConfig,
+              {
+                auth,
+                headers: { 'X-Grafana-Org-Id': org.id },
+                timeout: 3000
+              }
+            )
+            console.log(`[setupGrafana] ✅ Datasource Tempo criado: ${tempoDatasourceUid} (ID: ${tempoCreate.data?.datasource?.id || 'N/A'})`)
+          } catch (createTempoError) {
+            console.error(`[setupGrafana] ⚠️  Erro ao criar datasource Tempo via API: ${createTempoError.response?.data?.message || createTempoError.message}`)
+            console.log(`[setupGrafana] 💡 Datasource Tempo será criado manualmente ou na próxima tentativa`)
+          }
+        }
+      }
+    } catch (tempoGeneralError) {
+      console.error(`[setupGrafana] ⚠️  Erro geral ao configurar datasource Tempo: ${tempoGeneralError.message}`)
+      console.log(`[setupGrafana] 💡 Continuando sem datasource Tempo - não é crítico para funcionamento básico`)
+    }
+
     console.log(`[setupGrafana] 📈 Criando dashboard para ${appName}...`)
     
     const appNameLower = appName.toLowerCase()