epok

Docs

Use Epok with coding agents

Epok is agent-native. The entire setup surface — authentication, ingest for every signal, the query API, search syntax, rate limits, and a verification checklist — is published in one machine-readable guide. Point your agent at it and let it do the onboarding.

The one URL that matters

getepok.dev/llms-full.txt is the complete operations guide written for agents: exact endpoints, the OTel Collector config that works on the first try (including the one gotcha everyone hits), and how to verify data is flowing. The shorter index lives at /llms.txt, and request/response schemas at /openapi.json.

Paste this into your agent

Works with Claude Code, Cursor, Codex, or any agent that can fetch a URL and run shell commands:

text
Set up Epok observability for this project.

1. Read https://getepok.dev/llms-full.txt — it contains everything you
   need: auth, ingest endpoints for logs/traces/metrics, the query API,
   search syntax, and a verification checklist.
2. I'll provide an API key (ingest+read) and my tenant id when you ask.
3. Wire our services to send telemetry to Epok, verify data is arriving,
   and confirm detection is live. Keep the API key in environment
   variables — never commit it.

What the agent can do

  • Wire logs, traces, and metrics from your services via OpenTelemetry or common shippers — and verify arrival with the unified search API instead of asking you to check a dashboard.
  • Query telemetry during its own debugging sessions: one search/unified call tells it which signal holds the evidence.
  • Read alerts and their full evidence payloads — detectors run automatically on everything you send, so there is no alert-rule setup step to automate in the first place.

Two things to know

  • Keys stay in env vars. The guide instructs agents to never commit keys; if one leaks, rotate it in Settings → API Keys.
  • Agents share your plan's rate limits. Query limits are per-tenant; a runaway agent gets 429s with Retry-After, not a surprise bill.

Looking for the human-paced version? Start at the quickstart.