Índice

Visão Geral Verificações de Integridade Métricas e Monitoramento Configuração de Alertas Registro de Solicitações Rastreamento Distribuído Monitoramento de SLA Painéis Ferramentas de Monitoramento Melhores Práticas

Documentação da API

Monitoramento de API, Métricas e Verificações de Integridade

Monitore a Smart Money API com verificações de integridade abrangentes, métricas de desempenho e alertas. Acompanhe o tempo de atividade, latência, taxas de erro e conformidade com SLA.

Publicado em 21 de março de 2026 • 13 min de leitura • Operações

Visão Geral do Monitoramento

A Smart Money API oferece capacidades abrangentes de monitoramento para acompanhar a saúde, desempenho e confiabilidade do serviço. Implemente essas estratégias de monitoramento para detectar problemas antecipadamente e manter um alto tempo de atividade.

Três camadas de monitoramento:

Verificações de Integridade — Disponibilidade do endpoint e funcionalidade básica
Métricas — Dados de desempenho (latência, taxa de transferência, taxas de erro)
Registro — Detalhes de solicitação/resposta para depuração e auditoria

Métricas Alvo: 99,9% de tempo de atividade, <100ms de latência p95, <0,1% de taxa de erro, <5 segundos de tempo médio para detecção.

Verificações de Integridade

Endpoint de Integridade da API

Verificação de Integridade
// Verificação simples de vitalidade (sem autenticação necessária)
GET /health
// Resposta
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Status de Integridade Detalhado

Integridade Detalhada
// Status detalhado com saúde dos componentes
GET /v1/status
  -H "Authorization: Bearer token"
{
 "status": "operational",
 "components": {
 "api": "healthy",
 "database": "healthy",
 "cache": "healthy",
 "exchanges": "healthy"
  },
 "metrics": {
 "p95_latency_ms": 85,
 "error_rate": 0.0012,
 "uptime_percent": 99.95
  }
}

Obtenha sua chave de API em 30 segundos

Pronto para construir? Obtenha uma chave de API gratuita (200 chamadas/dia, sem cartão) e comece a puxar dados ao vivo de baleias, financiamento e on-chain.

Obtenha sua chave de API →

Métricas e Monitoramento

Métricas Principais para Acompanhar

Métrica	Alvo	Limite de Alerta
Tempo de Atividade	99.9%	<99.5%
Latência P95	<100ms	>500ms
Taxa de Erro	<0.1%	>1%
Solicitações/seg	Varia	Aproximando-se do limite
Taxa de Acerto do Cache	>70%	<50%

Endpoint de Métricas da API

Consulta de Métricas
// Obtenha métricas da API para monitoramento
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Retorna métricas no formato Prometheus
# HELP api_requests_total Total de solicitações da API
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Configuração de Alertas

Alertas via Webhook

Criar Alerta
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Taxa de Erro Alta",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "alta"
  }'

Tipos de Alertas

Alerta de Tempo de Atividade — API indisponível por mais de 5 minutos
Alerta de Latência — Latência P95 excede o limite
Alerta de Taxa de Erro — Taxa de erro acima de 1%
Alerta de Limite de Taxa — Aproximando-se do limite de taxa
Alerta de Atualização de Dados — Dados mais antigos que o limite

Registro de Solicitações

Níveis de Registro

Exemplo de Registro
// Entrada típica de registro de solicitação da API
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 método: GET,
 caminho: /v1/whales/btc,
 status: 200,
 duração_ms: 45,
 ID do usuário: acct_12345
}

Registro Estruturado

Todos os logs são em JSON estruturado para fácil análise e processamento:

Carimbo de data/hora no formato ISO 8601
ID de solicitação para rastreamento
Método HTTP e caminho
Status de resposta e latência
ID do usuário e impressão digital da chave de API
Mensagens de erro, se aplicável

Rastreamento Distribuído

Rastreamento de ID de Solicitação

Cabeçalhos de Rastreamento
// Todas as solicitações incluem cabeçalhos de rastreamento
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// A resposta inclui o mesmo ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Propagação de Contexto de Rastreamento

Use o padrão W3C Trace Context para sistemas distribuídos:

W3C Trace Context
// A solicitação inclui contexto de rastreamento
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID de Rastreamento: 4bf92f3577b34da6a3ce929d0e0e4736
// ID de Span: 00f067aa0ba902b7
// Amostrado: true (01)

Monitoramento de SLA

Objetivos de Nível de Serviço

Plano	SLA de Tempo de Atividade	Tempo de Resposta	Suporte
Grátis	99%	Melhor esforço	Comunidade
Trader	99.5%	<200ms p95	E-mail
Pro	99.95%	<100ms p95	Prioritário
Enterprise	99.99%	<50ms p95	Dedicado

Créditos de SLA

Se o tempo de atividade ficar abaixo do SLA, receba créditos de serviço:

99.0% - 99.5%: 10% de crédito mensal
95.0% - 99.0%: 25% de crédito mensal
< 95.0%: 100% de crédito mensal

Painéis de Monitoramento

Painel Integrado

Acesse o painel de desempenho em: https://status.smartmoney.io

Configuração de Painel Personalizado

Consulta Prometheus
// Consulta a taxa de solicitações da API
rate(api_requests_total[5m])
// Consulta a taxa de erro
rate(api_requests_total{status=~"5.."}[5m])
// Consulta o percentil de latência
histogram_quantile(0.95, api_request_duration_ms)

Integração de Ferramentas de Monitoramento

Plataformas Suportadas

Ferramenta	Integração	Recursos
Prometheus	Endpoint nativo /metrics	Coleta de métricas
Grafana	Plugin de fonte de dados	Painéis personalizados
Datadog	Integração via API	Rastreamento APM
New Relic	Integração com agente	Observabilidade completa
PagerDuty	Alertas por webhook	Gerenciamento de incidentes

Melhores Práticas de Monitoramento

1. Monitore Métricas-Chave

Foque em métricas que impactam diretamente seu negócio: tempo de atividade, latência, taxa de erro.

2. Defina Alertas Adequados

Alerta sobre sintomas, não apenas limites. Encaminhe alertas por severidade.

3. Use IDs de Solicitação

Sempre correlacione solicitações com IDs únicos para rastreamento ponta a ponta.

4. Implemente Rastreamento Distribuído

Use W3C Trace Context para visibilidade entre microsserviços.

5. Testes Regulares de Alertas

Teste canais de alerta mensalmente para garantir que a escalada funcione.

6. Documente a Resposta a Alertas

Crie manuais para alertas comuns com etapas de resolução.

Garanta 99,9% de Tempo de Atividade

Monitore a Smart Money API com verificações de integridade, métricas e alertas abrangentes. Mantenha conformidade com SLA usando ferramentas de observabilidade integradas.

Comece Agora

Planos Pro e Enterprise incluem suporte dedicado e monitoramento de SLA.