TelemetryDiagnose OTLP setup

Diagnose OTLP setup

Samples recent OTLP events and reports how many carry the fields needed to map an event to a workstation and a person. Use it when telemetry arrives but does not appear against the right host. Enterprise only.

curl -X GET "https://www.agentkeeper.dev/api/v1/otlp/setup-health" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "last_events": [
    {}
  ],
  "stats": {
    "total_events_sampled": 42,
    "raw_events_sampled": 42,
    "runtime_events_ignored": 42,
    "host_name_present_count": 10,
    "host_name_present_pct": 42,
    "session_id_present_count": 123,
    "session_id_present_pct": 123,
    "actor_mapped_count": 10,
    "actor_mapped_pct": 42,
    "mapped_count": 10,
    "mapped_pct": 42,
    "latest_event_at": "null",
    "correlation_key_count": 10,
    "session_correlation_sample_count": 10,
    "session_correlation_sample_pct": 42,
    "actor_only_count": 10,
    "unmapped_identities": [
      {}
    ]
  },
  "warnings": [
    {
      "code": "session_correlation_missing",
      "message": "example_string",
      "severity": "info"
    }
  ]
}
GET
/api/v1/otlp/setup-health
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An AgentKeeper API key, sent as Authorization: Bearer ak_live_….

An AgentKeeper API key, sent as Authorization: Bearer ak_live_….
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An AgentKeeper API key, sent as Authorization: Bearer ak_live_….

Responses

last_eventsobject[]
statsobject
warningsarray