Files
2026-02-09 17:14:40 -03:00

5.3 KiB

🔍 Exemplos de Uso

API REST da Aplicação

1. Verificar Status

curl -X GET http://localhost:5000/

Resposta:

{
  "status": "running",
  "version": "1.0.0",
  "timestamp": "2026-02-09T12:30:00.000000",
  "endpoints": {
    "health": "/health",
    "json": "/api/tickets",
    "prometheus": "/metrics",
    "timeseries": "/api/timeseries"
  }
}

2. Health Check

curl -X GET http://localhost:5000/health

Resposta:

{
  "status": "healthy",
  "cached_tickets": 10,
  "last_update": "2026-02-09T12:30:00.000000"
}

3. Buscar Tickets (JSON)

curl -X GET http://localhost:5000/api/tickets | jq '.'

Resposta (reformatada):

{
  "timestamp": "2026-02-09T12:30:00.000000",
  "total_tickets": 10,
  "tickets": [
    {
      "id": 26459,
      "contact_name": "Júlia Donelli",
      "duration_seconds": 56,
      "duration_formatted": "00:00:56",
      "status": "pending",
      "queue": "EQUIPAMENTO EM MANUTENÇÃO",
      "contact_number": "555199448030",
      "created_at": "2026-02-09T12:13:11.000Z",
      "updated_at": "2026-02-09T12:14:07.000Z",
      "whatsapp_name": "PersonalizeIT"
    }
  ]
}

4. Resumo Estatístico

curl -X GET http://localhost:5000/api/summary | jq '.'

Resposta:

{
  "total_tickets": 10,
  "average_duration_seconds": 1234.5,
  "max_duration_seconds": 1651623,
  "min_duration_seconds": 56,
  "total_duration_seconds": 12345,
  "timestamp": "2026-02-09T12:30:00.000000",
  "contacts": [
    "Júlia Donelli",
    "Atendimento Grafica Almeida",
    "ADICOM POLYTEK"
  ]
}

5. Métricas Prometheus

curl -X GET http://localhost:5000/metrics

Resposta:

# HELP ticket_duration_seconds Duration of ticket in seconds
# TYPE ticket_duration_seconds gauge
ticket_duration_seconds{ticket_id="26459",contact_name="Júlia Donelli",status="pending",queue="EQUIPAMENTO EM MANUTENÇÃO"} 56
ticket_duration_seconds{ticket_id="26363",contact_name="Atendimento Grafica Almeida",status="pending",queue="EQUIPAMENTO EM MANUTENÇÃO"} 15003

# HELP tickets_total Total number of pending tickets
# TYPE tickets_total gauge
tickets_total 10

# HELP ticket_duration_seconds_avg Average ticket duration in seconds
# TYPE ticket_duration_seconds_avg gauge
ticket_duration_seconds_avg 1234.50

6. Série Temporal

curl -X GET http://localhost:5000/api/timeseries | jq '.'

Queries do Grafana

Com Prometheus Datasource

Todos os tickets por contato:

ticket_duration_seconds

Média de duração:

avg(ticket_duration_seconds)

Máximo por contato (últimas 5 min):

max_over_time(ticket_duration_seconds[5m])

Total de tickets:

tickets_total

Tickets demorados (mais de 1 hora = 3600 segundos):

ticket_duration_seconds > 3600

Com JSON API Datasource

Todos os tickets:

{
  "data": "tickets"
}

Apenas resumo:

{
  "data": "total_tickets"
}

Python requests

import requests

# URL base
BASE_URL = "http://localhost:5000"

# 1. Health check
response = requests.get(f"{BASE_URL}/health")
print(response.json())

# 2. Buscar tickets
response = requests.get(f"{BASE_URL}/api/tickets")
tickets = response.json()["tickets"]
for ticket in tickets:
    print(f"{ticket['contact_name']}: {ticket['duration_formatted']}")

# 3. Resumo
response = requests.get(f"{BASE_URL}/api/summary")
summary = response.json()
print(f"Total: {summary['total_tickets']}")
print(f"Média: {summary['average_duration_seconds']:.2f}s")
print(f"Máximo: {summary['max_duration_seconds']}s")

# 4. Processar métricas Prometheus
response = requests.get(f"{BASE_URL}/metrics")
print(response.text)

Bash scripts

Monitorar atendimentos

#!/bin/bash

while true; do
    clear
    echo "=== Monitoramento de Atendimento ==="
    echo ""
    curl -s http://localhost:5000/api/summary | jq '.tickets[] | "\(.contact_name): \(.duration_formatted)"'
    echo ""
    sleep 30
done

Enviar para webhook

#!/bin/bash

# Buscar dados
DATA=$(curl -s http://localhost:5000/api/summary)

# Enviar para webhook
curl -X POST \
  -H 'Content-Type: application/json' \
  -d "$DATA" \
  https://seu-webhook.com/monitoramento

Integração com Ferramentas Externas

Slack Alertas

# Via Grafana Notification Channel
# Grafana → Alerts → Notification channels → Slack
# Mensagem quando tempo > 1 hora

PagerDuty

# Via Prometheus alertas
# Crie arquivo alerts.yml:
groups:
  - name: tickets
    rules:
      - alert: AtendimentoDemorado
        expr: ticket_duration_seconds > 3600
        for: 5m

Email

# Configure notificações no Grafana
# Grafana → Alerts → Notification channels → Email

Debug

Ver logs em tempo real

docker-compose logs -f monitoring-api

Testar conectividade com API PersonalizeIT

curl -X POST \
  -H 'Content-Type: application/json' \
  -d '{"email":"seu@email.com","password":"sua_senha"}' \
  https://api-personalizeit.zapplataforma.chat/auth/login

Verificar variáveis de ambiente

docker-compose exec monitoring-api env | grep API

Acessar console do container

docker-compose exec monitoring-api /bin/bash
python3
>>> from api_client import APIClient
>>> client = APIClient()
>>> client.login()