Tarefa AI Docs

Histórico de Execuções

Visualize, analise e monitore todas as execuções das suas tarefas AI com logs detalhados, métricas de performance e análise de custos.

17/01/2025
Nesta Página

Histórico de Execuções

Tenha visibilidade completa de todas as execuções das suas tarefas AI. Monitore performance, analise custos, identifique problemas e otimize seus workflows com nosso sistema avançado de logs e métricas.

Visão Geral

O Histórico de Execuções oferece:

  • 📊 Dashboard Interativo - Visualize métricas em tempo real
  • 🔍 Logs Detalhados - Cada execução com input/output completo
  • 💰 Análise de Custos - Rastreie gastos por tarefa e modelo
  • ⚡ Performance Metrics - Duração, tokens, taxa de sucesso
  • 🔔 Alertas Inteligentes - Notificações sobre anomalias
  • 📈 Tendências - Gráficos de uso ao longo do tempo
  • 🔄 Retry Manual - Re-execute tarefas que falharam

Acessar Histórico de Execuções

Via Dashboard

  1. Menu lateral → Executions
  2. Visualize lista de todas as execuções
  3. Filtros avançados disponíveis

Via API

GET /api/executions
Authorization: Bearer YOUR_API_KEY
 
# Query parameters:
?status=success           # success, failed, running, timeout
?task_id=task_abc123     # Execuções de tarefa específica
?model=claude-3-haiku    # Por modelo
?from=2025-01-01         # Data inicial
?to=2025-01-31           # Data final
?limit=50                # Resultados por página
&page=1

Response:

{
  "executions": [
    {
      "id": "exec_xyz789",
      "task_id": "task_abc123",
      "task_name": "Relatório Diário",
      "status": "success",
      "started_at": "2025-01-17T09:00:00Z",
      "completed_at": "2025-01-17T09:00:03.245Z",
      "duration_ms": 3245,
      "model": "anthropic/claude-3-haiku",
      "tokens": {
        "prompt": 150,
        "completion": 300,
        "total": 450
      },
      "cost_usd": 0.0012,
      "output_preview": "Resumo executivo do dia...",
      "metadata": {
        "trigger": "scheduled",
        "user_id": "user_123"
      }
    }
  ],
  "pagination": {
    "total": 1243,
    "page": 1,
    "per_page": 50,
    "pages": 25
  },
  "summary": {
    "total_executions": 1243,
    "success_rate": 94.2,
    "total_cost_usd": 15.67,
    "avg_duration_ms": 2890
  }
}

Detalhes de uma Execução

Visualização Completa

Clique em qualquer execução para ver detalhes completos:

GET /api/executions/{execution_id}

Response:

{
  "id": "exec_xyz789",
  "task": {
    "id": "task_abc123",
    "name": "Relatório Diário",
    "schedule": "0 9 * * *"
  },
 
  "execution_info": {
    "status": "success",
    "trigger": "scheduled",
    "started_at": "2025-01-17T09:00:00.000Z",
    "completed_at": "2025-01-17T09:00:03.245Z",
    "duration_ms": 3245
  },
 
  "model_info": {
    "model": "anthropic/claude-3-haiku",
    "temperature": 0.7,
    "max_tokens": 4096,
    "actual_tokens": {
      "prompt": 150,
      "completion": 300,
      "total": 450
    }
  },
 
  "prompt": {
    "template": "Crie um resumo executivo do dia com: {{data}}",
    "variables": {
      "data": "Sales: $15,234 | Users: 543 | ..."
    },
    "final_prompt": "Crie um resumo executivo do dia com: Sales: $15,234 | Users: 543 | ..."
  },
 
  "output": {
    "text": "# Resumo Executivo - 17/01/2025\n\n## Destaques do Dia\n- Vendas atingiram $15,234 (↑12% vs ontem)\n- 543 novos usuários registrados\n- Taxa de conversão de 3.2%\n\n## Alertas\n- Pico de tráfego às 14h não converteu adequadamente\n- Estoque do produto X baixo (15 unidades)\n\n## Ações Recomendadas\n1. Investigar drop-off no checkout durante pico\n2. Repor estoque produto X urgente\n3. Aumentar budget de ads em 20% (ROI positivo)",
    "truncated": false,
    "character_count": 412
  },
 
  "cost": {
    "input_tokens_cost": 0.0004,
    "output_tokens_cost": 0.0008,
    "total_usd": 0.0012,
    "billing_tier": "pro"
  },
 
  "performance": {
    "queue_time_ms": 45,
    "api_latency_ms": 3100,
    "processing_time_ms": 100,
    "total_duration_ms": 3245
  },
 
  "metadata": {
    "user_id": "user_123",
    "organization_id": "org_456",
    "ip_address": "203.0.113.42",
    "user_agent": "Claude Scheduler/1.0",
    "retry_count": 0,
    "parent_execution_id": null
  },
 
  "logs": [
    {
      "timestamp": "2025-01-17T09:00:00.000Z",
      "level": "info",
      "message": "Execution started"
    },
    {
      "timestamp": "2025-01-17T09:00:00.045Z",
      "level": "info",
      "message": "Prompt variables resolved"
    },
    {
      "timestamp": "2025-01-17T09:00:00.100Z",
      "level": "info",
      "message": "API request sent to anthropic/claude-3-haiku"
    },
    {
      "timestamp": "2025-01-17T09:00:03.200Z",
      "level": "info",
      "message": "API response received"
    },
    {
      "timestamp": "2025-01-17T09:00:03.245Z",
      "level": "info",
      "message": "Execution completed successfully"
    }
  ],
 
  "notifications_sent": [
    {
      "channel": "email",
      "recipient": "user@empresa.com",
      "status": "delivered",
      "sent_at": "2025-01-17T09:00:04.000Z"
    }
  ]
}

Dashboard de Métricas

Visão Geral (Overview)

Acesse: Dashboard → Executions → Overview

Métricas Principais (Last 30 Days)

┌─────────────────────────────────────────────────────────┐
│  📊 EXECUTIONS OVERVIEW - Last 30 Days                  │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  Total Executions       Success Rate      Avg Duration │
│      1,243                 94.2%            2.89s      │
│  ────────────────────────────────────────────────────  │
│                                                         │
│  Total Cost            Failed              Retries     │
│    $15.67                 72                 18        │
│                                                         │
└─────────────────────────────────────────────────────────┘

Gráfico de Tendências

Execuções por Dia (Last 30 Days)

 60 ┤           ╭─╮
 55 ┤        ╭──╯ ╰╮     ╭╮
 50 ┤     ╭──╯     ╰─╮  ╭╯╰╮
 45 ┤  ╭──╯          ╰──╯  ╰─╮
 40 ┼──╯                     ╰──
    └┬───┬───┬───┬───┬───┬───┬
    1    5   10  15  20  25  30

Por Status

Status Distribution

Success ████████████████████ 94.2% (1,171)
Failed  ██ 5.8% (72)
Timeout ▌ 0.0% (0)

Por Modelo

Usage by Model

Claude 3 Haiku   ██████████████ 45% (559)
Claude 3 Sonnet  ████████ 28% (348)
GPT-4 Turbo      ████ 15% (186)
Gemini Flash     ███ 12% (150)

Por Tarefa (Top 10)

TarefaExecuçõesTaxa SucessoCusto TotalAvg Duration
Relatório Diário30100%$2.453.2s
Monitor Twitter72092.5%$1.891.1s
Análise Competitiva12100%$8.9012.4s
Gerar Posts Blog1593.3%$1.208.7s
Classificar Tickets28894.1%$0.670.8s

Análise de Custos

Por Período

Acesse: Dashboard → Billing → Usage

Cost Breakdown - January 2025

Week 1: $3.45  ████████
Week 2: $4.12  ██████████
Week 3: $5.23  █████████████
Week 4: $2.87  ██████

Total: $15.67

Por Categoria

Cost by Category

Model API Calls    $14.23  ████████████████████ 90.8%
Storage            $0.89   █ 5.7%
Notifications      $0.35   ▌ 2.2%
Other              $0.20   ▌ 1.3%

Maiores Gastos (Top Tasks)

GET /api/analytics/cost-by-task

Response:

{
  "period": "2025-01",
  "tasks": [
    {
      "task_id": "task_123",
      "task_name": "Análise Competitiva",
      "executions": 12,
      "total_cost_usd": 8.90,
      "avg_cost_per_execution": 0.74,
      "model": "openai/gpt-4-turbo",
      "cost_trend": "+15%"
    },
    {
      "task_id": "task_456",
      "task_name": "Relatório Diário",
      "executions": 30,
      "total_cost_usd": 2.45,
      "avg_cost_per_execution": 0.08,
      "model": "anthropic/claude-3-haiku",
      "cost_trend": "-5%"
    }
  ]
}

Projeção de Custos

Cost Projection - February 2025

Based on current usage pattern:

Estimated monthly cost: $18.50 - $22.00

Breakdown:
- Scheduled tasks:      $15.00
- Manual executions:    $3.00
- Retries:              $0.50
- Buffer (10%):         $2.00

┌─────────────────────────────────┐
│ Budget Alert                    │
│ Current: $15.67 / $100.00       │
│ Projected: $20.00 / $100.00     │
│ Status: ✅ Within budget        │
└─────────────────────────────────┘

Filtros Avançados

Interface de Filtros

Dashboard → Executions → Filters

interface ExecutionFilters {
  // Status
  status?: "success" | "failed" | "running" | "timeout" | "cancelled";
 
  // Datas
  date_range?: {
    from: "2025-01-01";
    to: "2025-01-31";
  };
 
  // Tarefas
  task_ids?: ["task_1", "task_2"];
  task_names?: ["Relatório Diário"];
 
  // Modelos
  models?: ["anthropic/claude-3-haiku", "openai/gpt-4-turbo"];
 
  // Performance
  min_duration_ms?: 1000;
  max_duration_ms?: 30000;
 
  // Custo
  min_cost_usd?: 0.01;
  max_cost_usd?: 1.0;
 
  // Tokens
  min_tokens?: 100;
  max_tokens?: 10000;
 
  // Trigger
  trigger?: "scheduled" | "manual" | "api" | "retry";
 
  // Busca de texto
  search?: "palavra-chave no output";
 
  // Ordem
  order_by?: "created_at" | "duration" | "cost" | "tokens";
  order_direction?: "asc" | "desc";
}

Exemplos de Filtros

1. Execuções caras (> $0.50)

{
  "min_cost_usd": 0.50,
  "order_by": "cost",
  "order_direction": "desc"
}

2. Falhas recentes

{
  "status": "failed",
  "date_range": {
    "from": "2025-01-10",
    "to": "2025-01-17"
  },
  "order_by": "created_at",
  "order_direction": "desc"
}

3. Execuções lentas (> 10s)

{
  "min_duration_ms": 10000,
  "status": "success",
  "order_by": "duration",
  "order_direction": "desc"
}

4. Busca no output

{
  "search": "URGENTE",
  "date_range": {
    "from": "2025-01-17"
  }
}

Logs Detalhados

Níveis de Log

NívelDescriçãoExemplo
debugInformações de debug detalhadas"Variable 'user_id' resolved to '123'"
infoEventos normais de operação"Execution started"
warningSituações inesperadas mas não críticas"Retry attempt 1 of 3"
errorErros que impedem conclusão"API timeout after 30s"
criticalFalhas graves do sistema"Database connection lost"

Visualização de Logs

{
  "execution_id": "exec_xyz789",
  "logs": [
    {
      "timestamp": "2025-01-17T09:00:00.000Z",
      "level": "info",
      "message": "Execution started",
      "metadata": {
        "task_id": "task_abc123",
        "trigger": "scheduled"
      }
    },
    {
      "timestamp": "2025-01-17T09:00:00.045Z",
      "level": "debug",
      "message": "Resolving prompt variables",
      "metadata": {
        "variables": ["data", "date"]
      }
    },
    {
      "timestamp": "2025-01-17T09:00:00.100Z",
      "level": "info",
      "message": "API request sent",
      "metadata": {
        "model": "anthropic/claude-3-haiku",
        "endpoint": "https://api.anthropic.com/v1/messages",
        "prompt_tokens": 150
      }
    },
    {
      "timestamp": "2025-01-17T09:00:03.200Z",
      "level": "info",
      "message": "API response received",
      "metadata": {
        "status_code": 200,
        "completion_tokens": 300,
        "latency_ms": 3100
      }
    },
    {
      "timestamp": "2025-01-17T09:00:03.245Z",
      "level": "info",
      "message": "Execution completed successfully",
      "metadata": {
        "total_duration_ms": 3245,
        "cost_usd": 0.0012
      }
    }
  ]
}

Logs de Erro

{
  "timestamp": "2025-01-17T14:35:22.123Z",
  "level": "error",
  "message": "API request failed",
  "error": {
    "type": "APITimeoutError",
    "message": "Request timed out after 30000ms",
    "code": "TIMEOUT",
    "details": {
      "timeout_ms": 30000,
      "url": "https://api.openai.com/v1/chat/completions",
      "retry_available": true
    }
  },
  "stack_trace": "APITimeoutError: Request timed out...\n  at fetch...",
  "context": {
    "attempt": 1,
    "max_retries": 3,
    "next_retry_in_ms": 5000
  }
}

Retry de Execuções

Retry Manual

Dashboard → Executions → [Selecionar execução] → Retry

POST /api/executions/{execution_id}/retry
{
  "override_params": {
    "temperature": 0.5,
    "max_tokens": 8192
  }
}

Retry Automático (Configurado na Tarefa)

{
  "task_name": "Monitor Crítico",
  "retry_policy": {
    "enabled": true,
    "max_retries": 3,
    "retry_delay_ms": 5000,
    "exponential_backoff": true,
    "retry_on": ["timeout", "api_error", "rate_limit"]
  }
}

Histórico de Retries

{
  "execution_id": "exec_original",
  "status": "failed",
  "retry_count": 2,
  "retries": [
    {
      "attempt": 1,
      "execution_id": "exec_retry_1",
      "started_at": "2025-01-17T09:00:30Z",
      "status": "failed",
      "error": "API timeout"
    },
    {
      "attempt": 2,
      "execution_id": "exec_retry_2",
      "started_at": "2025-01-17T09:01:00Z",
      "status": "success",
      "duration_ms": 2145
    }
  ]
}

Exportação de Dados

Formatos Disponíveis

CSV

execution_id,task_name,status,started_at,duration_ms,cost_usd,model
exec_1,Relatório Diário,success,2025-01-17T09:00:00Z,3245,0.0012,claude-3-haiku
exec_2,Monitor Twitter,success,2025-01-17T09:05:00Z,1123,0.0003,claude-3-haiku
...

JSON

{
  "executions": [...],
  "metadata": {
    "exported_at": "2025-01-17T15:00:00Z",
    "period": "2025-01",
    "total_executions": 1243,
    "filters_applied": {...}
  }
}

PDF Report

  • Executive summary
  • Gráficos de tendências
  • Tabelas de custos
  • Top tasks e modelos

Download via API

GET /api/executions/export
?format=csv
&from=2025-01-01
&to=2025-01-31
&status=success

Alertas e Monitoramento

Alertas Configuráveis

{
  "alerts": {
    "high_failure_rate": {
      "enabled": true,
      "threshold": 0.10,  // 10% de falhas
      "window": "1h",
      "action": ["email", "slack"]
    },
    "slow_executions": {
      "enabled": true,
      "threshold_ms": 10000,
      "consecutive_count": 3,
      "action": ["email"]
    },
    "cost_spike": {
      "enabled": true,
      "threshold_increase": 0.50,  // Aumento de 50%
      "comparison_period": "7d",
      "action": ["email", "whatsapp"]
    }
  }
}

Dashboard de Saúde (Health)

System Health - Last 24h

┌────────────────────────────────────┐
│ Overall Status: ✅ Healthy         │
├────────────────────────────────────┤
│                                    │
│ Success Rate:     96.5% ✅         │
│ Avg Duration:     2.8s  ✅         │
│ API Uptime:       99.9% ✅         │
│ Error Rate:       3.5%  ✅         │
│                                    │
└────────────────────────────────────┘

Recent Issues:
- 2 timeouts (15:30 UTC) - Resolved
- 1 rate limit (14:22 UTC) - Resolved

Comparação de Execuções

Compare Side-by-Side

Selecione 2+ execuções → Compare

┌─────────────────────────────────────────────────────┐
│           Execution A    │    Execution B           │
├─────────────────────────────────────────────────────┤
│ Started     09:00:00     │    09:05:00             │
│ Duration    3.2s         │    2.8s ⬇ 12% faster   │
│ Model       Haiku        │    Haiku                │
│ Tokens      450          │    380 ⬇ 15% less      │
│ Cost        $0.0012      │    $0.0010 ⬇ 17% cheaper│
│ Status      ✅ Success   │    ✅ Success           │
│ Output      [View]       │    [View]               │
└─────────────────────────────────────────────────────┘

Melhores Práticas

1. Monitoramento Regular

  • Revise dashboard semanalmente
  • Configure alertas para anomalias
  • Analise tendências de custo mensal

2. Otimização de Performance

// Identifique tarefas lentas
const slowTasks = executions.filter(e => e.duration_ms > 10000);
 
// Considere:
- Modelo mais rápido (Haiku vs Sonnet)
- Reduzir max_tokens
- Otimizar prompt (menos tokens)
- Aumentar timeout se necessário

3. Controle de Custos

// Identifique tarefas caras
const expensiveTasks = executions
  .sort((a, b) => b.cost_usd - a.cost_usd)
  .slice(0, 10);
 
// Otimize:
- Use modelos mais baratos quando possível
- Reduza frequência de execução
- Otimize prompts para usar menos tokens

4. Taxa de Sucesso

// Monitore falhas
const failureRate = executions.filter(e => e.status === 'failed').length / executions.length;
 
if (failureRate > 0.05) {
  // Investigue:
  - Timeouts frequentes? Aumente timeout
  - Erros de API? Verifique integrações
  - Rate limits? Espaçe execuções
}

Recursos Relacionados

Próximo Passo: Explore o dashboard de execuções em Dashboard → Executions!

Editar esta página no GitHub