Documentación

Guías de producto, API e integraciones.

Manual de usuario

Roles, login, panel interno y flujo de incidencias.

API REST

Autenticación, CRUD de dominios y webhooks de alertas.

Integraciones

RabbitMQ, extensiones salientes y firma de webhooks.

Grafana

Contact point, token, payloads de firing y resolved.

Manual de usuario

Registre el primer usuario como owner, inicie sesión, cree equipos, defina servicios, configure políticas y gestione incidencias desde el panel interno.

API REST

POST /api/auth/register
POST /api/auth/login
POST /api/alerts/webhook
POST /api/integrations/grafana
POST /api/integrations/grafana/webhook
GET  /api/incidents
POST /api/incidents/:id/acknowledge
POST /api/incidents/:id/resolve
POST /api/incidents/:id/escalate
GET  /api/analytics

Integraciones

Los webhooks entrantes aceptan firma HMAC en X-Alert-Signature. Los eventos relevantes se publican en la cola notifications para procesar correos, Slack, Teams o webhooks salientes.

Integración con Grafana

Cree o seleccione una cuenta y servicio en BeaconDuty.
Genere un token con POST /api/integrations/grafana.
Configure un contact point Webhook en Grafana.
Use Authorization: Bearer <token> como header.
Pruebe un payload firing y luego uno resolved con el mismo fingerprint.

POST /api/integrations/grafana/webhook
Authorization: Bearer <grafana-token>

{
  "status": "firing",
  "title": "High API latency",
  "message": "p95 latency is above threshold",
  "ruleName": "API latency",
  "fingerprint": "grafana-api-latency-prod"
}