RFC-015: Unified Observability Protocol (UOP) — 3. Metrics Schema

AIGP Specification › RFC-015: Unified Observability Protocol (UOP) › 3. Metrics Schema

← 2. Signal Types · Section index · 4. Dashboard Specification →

3. Metrics Schema

All metrics are emitted as structured events and stored in the governance-server DynamoDB table.

3.1 Signal Event Schema

Every signal emitted to UOP conforms to this base schema:

{
  "signal_type": "AIGP_REQUEST",
  "signal_id": "sig-1714800000000-abc",
  "request_id": "req-1714800000000",
  "app_id": "identity-service",
  "timestamp": "2026-05-04T10:00:00Z",
  "payload": { }
}

Field	Type	Required	Description
signal_type	string	YES	One of the signal types from 2
signal_id	string	YES	Unique signal identifier
request_id	string	YES	Correlation ID propagated across all amigos
app_id	string	YES	Emitting application
timestamp	ISO 8601	YES	When the signal was emitted
payload	object	YES	Signal-specific data

3.2 AIGP Metrics Payload

{
  "signal_type": "AIGP_RECORD",
  "request_id": "req-1714800000000",
  "app_id": "identity-service",
  "payload": {
    "use_case": "gandalf_magic",
    "model_id": "us.anthropic.claude-opus-4-7",
    "user_id": "owner@ai-governance-protocol.org",
    "decision": "ALLOW",
    "duration_ms": 3200,
    "status": "SUCCESS",
    "tokens": {
      "input_tokens": 1850,
      "output_tokens": 620,
      "total_tokens": 2470
    },
    "cost_usd": 0.0247
  }
}

3.3 ACP Metrics Payload

{
  "signal_type": "ACP_FETCH",
  "request_id": "req-1714800000000",
  "app_id": "runbook-service",
  "payload": {
    "provider": "identity-service",
    "context_type": "user_entitlements",
    "schema_version": "1.0",
    "fetch_duration_ms": 120,
    "payload_bytes": 2048,
    "cache_hit": false,
    "validation_status": "PASS"
  }
}

3.4 ALP Metrics Payload

{
  "signal_type": "ALP_EXECUTE",
  "request_id": "req-1714800000000",
  "app_id": "runbook-service",
  "payload": {
    "artifact_id": "art-remediation-001",
    "artifact_type": "python_script",
    "plan_id": "plan-prisma-gaps-v1",
    "execution_status": "SUCCESS",
    "steps_total": 5,
    "steps_succeeded": 5,
    "duration_ms": 8500
  }
}

3.5 Aggregation Buckets

governance-server computes rolling aggregates from raw signals:

Aggregate	Granularity	Key Dimensions
Token consumption	Hourly, Daily, Monthly	app_id, model_id, use_case
Request volume	Hourly, Daily	app_id, signal_type
Error rate	Hourly, Daily	app_id, use_case, error_type
Latency percentiles	Hourly	app_id, model_id (p50, p95, p99)
Budget consumption	Daily, Monthly	app_id
Artifact throughput	Daily	app_id, artifact_type

---

← 2. Signal Types · Section index · 4. Dashboard Specification →