Skip to content

docs(server): add hosted collector section (#129)#132

Merged
Siddhant-K-code merged 1 commit into
mainfrom
docs/129-hosted-collector
May 24, 2026
Merged

docs(server): add hosted collector section (#129)#132
Siddhant-K-code merged 1 commit into
mainfrom
docs/129-hosted-collector

Conversation

@Siddhant-K-code

Copy link
Copy Markdown
Owner

What

Adds a "Hosted collector" section to docs/server.md for issue #129.

Refs #129

Changes

  • docs/server.md: new section at the top describing the planned collector.agent-strace.dev endpoint
    • Marked as planned / not yet live
    • Links to a separate infrastructure repo (agent-strace/agent-strace-collector) for the deployment work
    • Shows the one-line client change needed when it is available (AGENT_STRACE_ENDPOINT + AGENT_STRACE_AUTH_KEY)
    • No code changes — the client is already fully ready

Note

The infrastructure work (persistent HTTP service, storage, domain, free tier) belongs in a separate repo. See comment on #129.

Adds a 'Hosted collector' section to docs/server.md describing the
planned collector.agent-strace.dev endpoint. Notes that it is not yet
live, links to the separate infrastructure repo, and shows the one-line
client change needed when it is available.

Refs #129

Co-authored-by: Ona <no-reply@ona.com>
@Siddhant-K-code Siddhant-K-code merged commit 385ba75 into main May 24, 2026
4 checks passed
@Siddhant-K-code Siddhant-K-code deleted the docs/129-hosted-collector branch May 24, 2026 15:27
Siddhant-K-code added a commit that referenced this pull request May 31, 2026
…e identity (#155)

Live OTLP streaming (#132)
- watch: StreamConfig gains otlp=True flag and service_name field
- EventStreamer._flush routes to _flush_otlp when otlp=True, converting
  events to OTLP GenAI spans and POSTing to <url>/v1/traces
- CLI: --stream-otlp flag on agent-strace watch

Baseline anomaly detection (#134)
- baseline.py: new module — build_baseline() computes mean/stddev for
  cost, tool_calls, duration_ms, error_rate, llm_requests from recent
  sessions; check_session() flags sessions beyond a sigma threshold
- CLI: agent-strace baseline update|check|show

Machine identity (#141)
- identity.py: new module — stable per-machine UUID + HMAC-SHA256 session
  signing using stdlib only; identity stored at ~/.agent-trace/identity.json
  (override with AGENT_TRACE_IDENTITY_FILE); signatures stored as a sidecar
  identity.json alongside each session
- CLI: agent-strace identity show|sign|verify

1259/1259 tests passing.

Closes #132
Closes #134
Closes #141

Co-authored-by: Ona <no-reply@ona.com>
@Siddhant-K-code

Copy link
Copy Markdown
Owner Author

Fixed in #155, released in v0.60.0.

agent-strace watch now streams events as OTLP GenAI spans to any compatible backend:

agent-strace watch --stream-to https://api.honeycomb.io --stream-otlp

StreamConfig.otlp=True routes flushes through _flush_otlp() which converts batches via session_to_otlp_genai() and POSTs to <url>/v1/traces. HTTP/JSON only per ADR-0006.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant