Capacity Intelligence API.

Serviço separado do Capacity Operations Center: recebe snapshots de múltiplas instâncias SQL Server, persiste histórico em PostgreSQL e disponibiliza indicadores por API, com opção de envio de métricas ao Dynatrace.

Arquitetura

SQL Server → PowerShell Collector → HTTPS API → PostgreSQL
                                      └→ /v1/summary
                                      └→ Dynatrace Metrics API v2

Endpoints

• GET /health — status do serviço e banco.
• POST /v1/snapshots — ingestão; exige x-api-key.
• GET /v1/summary?days=30 — resumo; exige x-api-key.
• POST /v1/dynatrace/push — envia uso, espaço livre e capacidade; exige x-api-key e token Dynatrace no servidor.

Deploy independente no Render

1. Crie PostgreSQL gerenciado e copie DATABASE_URL.
2. Crie Web Service com root directory capacity-intelligence-api ou use render.yaml.
3. Configure DATABASE_URL, EMRQ_API_KEY, DYNATRACE_ENVIRONMENT_URL e DYNATRACE_API_TOKEN como segredos.
4. Use token Dynatrace com escopo metrics.ingest. Nunca exponha o token no navegador ou PowerShell.
5. Agende o coletor PowerShell por instância usando conta de menor privilégio.

Coletor

Use collector/Collect-CapacitySnapshot.ps1. Requer módulo SqlServer e permissões de leitura em sys.master_files e sys.dm_os_volume_stats.

Segurança e limites

• API key em header, comparação em tempo constante, limite de payload, validação e CORS restrito.
• Use HTTPS, rotacione chaves, restrinja rede e faça backup/retention do PostgreSQL.
• O coletor envia tamanho provisionado e filesystem; espaço usado internamente no arquivo não é coletado nesta versão.
• O push publica métricas, mas não cria automaticamente regras de alerting no Dynatrace.

Abrir Capacity Operations Center 4.0 ↗