Métricas de Rede

As métricas de rede ajudam a investigar tráfego HTTP, códigos de status, rotas mais acessadas, latência, user agents e IPs de origem. Estes endpoints estão disponíveis para projetos HTTP em planos com acesso a métricas.

Headers

Header	Obrigatório	Descrição
`x-api-key`	Sim	API Key do projeto
`x-organization-id`	Sim	Organização ativa do projeto

Endpoints

Endpoint	Uso principal
`GET /project/:id/metrics/network/summary`	Visão agregada de requests, bytes, latência e classes de status
`GET /project/:id/metrics/network/status-codes`	Agrupamento por código HTTP
`GET /project/:id/metrics/network/routes`	Rotas mais acessadas e status por rota
`GET /project/:id/metrics/network/user-agents`	User agents mais frequentes
`GET /project/:id/metrics/network/request-events`	Eventos individuais de requisição
`GET /project/:id/metrics/network/source-ips`	IPs de origem com maior volume

Parâmetros de Path

Parâmetro	Tipo	Descrição
`id`	string	ID do projeto (ObjectId)

Filtros de Query

Parâmetro	Tipo	Descrição
`range_seconds`	number	Janela relativa. Valores aceitos: `300`, `3600`, `21600`, `86400`, `604800`
`from`	string	Data inicial em formato ISO 8601
`to`	string	Data final em formato ISO 8601
`status_code`	string	Código HTTP específico, como `500`
`status_class`	string	Classe HTTP: `2xx`, `3xx`, `4xx` ou `5xx`
`source_ip`	string	IP de origem para filtrar eventos
`path`	string	Caminho HTTP para filtrar eventos
`page`	number	Página da paginação. Padrão: `1`
`limit`	number	Itens por página. Padrão: `5`, máximo: `50`

Use range_seconds para dashboards simples. Use from e to quando precisar comparar uma janela específica de incidente.

Summary

GET /project/:id/metrics/network/summary

{
  "status": "success",
  "message": "get network analytics summary with success",
  "data": {
    "project_id": "507f1f77bcf86cd799439011",
    "window": {
      "from": "2026-05-23T13:00:00.000Z",
      "to": "2026-05-23T14:00:00.000Z",
      "seconds": 3600
    },
    "summary": {
      "requests": 1200,
      "bytes_received": 420000,
      "bytes_sent": 1800000,
      "avg_latency_ms": 42,
      "p95_latency_ms": 120
    },
    "status_classes": {
      "2xx": 1160,
      "3xx": 20,
      "4xx": 15,
      "5xx": 5
    }
  }
}

Listas Paginadas

Os endpoints status-codes, routes, user-agents, request-events e source-ips retornam data e pagination.

{
  "status": "success",
  "message": "get network analytics status codes with success",
  "data": {
    "data": [
      {
        "status_code": "200",
        "requests": 1160,
        "user_agents": {
          "Mozilla/5.0": 900,
          "curl/8.0": 260
        },
        "routes": {
          "GET /": 800,
          "GET /health": 360
        },
        "bytes_received": 390000,
        "bytes_sent": 1600000,
        "avg_latency_ms": 39,
        "p95_latency_ms": 110
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 5,
      "total": 1,
      "total_pages": 1
    }
  }
}

Exemplos

Resumo da última hora

curl -X GET "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/metrics/network/summary?range_seconds=3600" \
  -H "x-api-key: sua-api-key" \
  -H "x-organization-id: sua-organization-id"

Rotas com erros 5xx

curl -X GET "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/metrics/network/routes?status_class=5xx&limit=10" \
  -H "x-api-key: sua-api-key" \
  -H "x-organization-id: sua-organization-id"

Eventos de um IP específico

curl -X GET "https://api.zenifra.com/v1/project/507f1f77bcf86cd799439011/metrics/network/request-events?source_ip=203.0.113.10" \
  -H "x-api-key: sua-api-key" \
  -H "x-organization-id: sua-organization-id"

Python

import requests

API_KEY = "sua-api-key"
ORGANIZATION_ID = "sua-organization-id"
PROJECT_ID = "507f1f77bcf86cd799439011"

headers = {"x-api-key": API_KEY, "x-organization-id": ORGANIZATION_ID}

summary = requests.get(
    f"https://api.zenifra.com/v1/project/{PROJECT_ID}/metrics/network/summary",
    params={"range_seconds": 3600},
    headers=headers
).json()

print(summary)

Erros Comuns

Código	Motivo provável	Como resolver
`400`	Projeto não é HTTP	Use métricas de banco em Métricas e Logs
`402`	Plano não permite acesso a métricas	Faça upgrade para um plano com métricas habilitadas
`403`	Organização ou permissão inválida	Confirme `x-organization-id` e acesso ao projeto
`404`	Projeto não encontrado	Confira `Project ID`, API Key e organização

Próximos Passos

Use Métricas e Logs para CPU, memória e logs.
Consulte Instâncias para relacionar tráfego com réplicas.
Veja Histórico de Deployments ao investigar incidentes após deploy.

Nessa Página