ABS Core
API Reference

Telemetry API

Multi-tenant observability via Datadog and Sentry. Query metrics, logs, and issues per agent.

Telemetry API

The Telemetry API provides multi-tenant observability for AI agent governance. All data is tagged with tenant_id and agent_id for per-client filtering. Events flow into Datadog (metrics/logs) and Sentry (errors/issues) automatically — you can also query them programmatically.

Base URL: https://api.abscore.app/v1/telemetry


Status

GET /v1/telemetry/status

Returns the current connectivity status of all telemetry providers.

curl https://api.abscore.app/v1/telemetry/status \
  -H "Authorization: Bearer $ABS_PAT"
{
  "mode": "SAAS_CONNECTED",
  "providers": {
    "datadog": "ACTIVE",
    "sentry": "ACTIVE"
  },
  "sanitization": "PII_ENABLED",
  "latency_ms": 4
}

Ingest Telemetry Event

POST /v1/telemetry/ingest

Sends custom metrics, logs, or error events to Datadog/Sentry. All events are tagged with tenant_id.

curl -X POST https://api.abscore.app/v1/telemetry/ingest \
  -H "Authorization: Bearer $ABS_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "traceId":  "trace_a3b2c1d0",
    "tenantId": "my-org",
    "agentId":  "finance-agent-01",
    "log": {
      "level":   "error",
      "message": "Agent exceeded rate limit",
      "attributes": {
        "endpoint":   "/v1/decide",
        "retryCount": 3,
        "ruleId":     "RATE-001"
      }
    }
  }'

Response:

{
  "status":    "ingested",
  "traceId":   "trace_a3b2c1d0",
  "providers": ["datadog", "sentry"]
}

Query Datadog Logs

GET /v1/telemetry/query/logs

Returns Datadog log entries filtered by tenant and agent.

curl "https://api.abscore.app/v1/telemetry/query/logs?tenantId=my-org&agentId=finance-agent-01&limit=10" \
  -H "Authorization: Bearer $ABS_PAT"
{
  "data": [
    {
      "id":        "AAAAAWs8aG9vdGxldGUAAA==",
      "timestamp": "2026-02-25T14:22:10Z",
      "level":     "warn",
      "message":   "Budget threshold 80% reached: R$80.00 / R$100.00",
      "agentId":   "finance-agent-01",
      "traceId":   "tr_9f8e7d6c"
    }
  ],
  "total": 142,
  "cursor": "AAAAAWs8aG9vdGxldGUAAA=="
}

Query Datadog Metrics

GET /v1/telemetry/query/stats

Returns time-series metrics for a specific metric name.

curl "https://api.abscore.app/v1/telemetry/query/stats?tenantId=my-org&metric=decision.latency_ms&from=1740870000&to=1740873600" \
  -H "Authorization: Bearer $ABS_PAT"
ParameterRequiredDescription
tenantIdYour workspace ID
metricMetric name (see available metrics below)
fromUnix timestamp — start of window
toUnix timestamp — end of window
agentIdOptionalFilter by specific agent

Available metrics:

MetricDescription
decision.latency_msGovernance kernel latency per request
decision.countTotal decisions per time window
decision.blocked_countTotal blocked decisions
budget.cost_brlToken cost per agent in BRL
heartbeat.missed_countMissed heartbeats per agent
{
  "metric":   "decision.latency_ms",
  "series": [
    { "timestamp": 1740870000, "value": 14.2 },
    { "timestamp": 1740870060, "value": 12.8 },
    { "timestamp": 1740870120, "value": 16.1 }
  ],
  "avg": 14.4,
  "p95": 24.1,
  "p99": 38.7
}

Query Sentry Issues

GET /v1/telemetry/query/sentry/issues

Returns open Sentry issues tagged with the given tenant.

curl "https://api.abscore.app/v1/telemetry/query/sentry/issues?tenantId=my-org&limit=10" \
  -H "Authorization: Bearer $ABS_PAT"
{
  "data": [
    {
      "id":       "ABSC-123",
      "title":    "PolicyViolation: EXFIL-001 triggered 12x in last hour",
      "level":    "error",
      "count":    12,
      "firstSeen": "2026-02-24T09:00:00Z",
      "lastSeen":  "2026-02-25T14:22:00Z",
      "agentId":   "finance-agent-01"
    }
  ],
  "total": 3
}

Query Sentry Events

GET /v1/telemetry/query/sentry/events

Returns the most recent Sentry events for a given tenant.

curl "https://api.abscore.app/v1/telemetry/query/sentry/events?tenantId=my-org&limit=5" \
  -H "Authorization: Bearer $ABS_PAT"
{
  "data": [
    {
      "id":        "evt_sentry_001",
      "issueId":   "ABSC-123",
      "timestamp": "2026-02-25T14:22:10Z",
      "message":   "PolicyViolation: EXFIL-001",
      "context": {
        "agentId":  "finance-agent-01",
        "ruleId":   "EXFIL-001",
        "traceId":  "tr_1a2b3c4d"
      }
    }
  ]
}

The ABS Dashboard at abscore.app/dashboard provides a visual interface for all telemetry endpoints with auto-refresh every 30 seconds, agent-level filtering, and exportable CSV reports.

On this page