diff --git a/CHANGELOG.md b/CHANGELOG.md index 8cbdf17..4a5597d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,16 @@ # Changelog +## [Unreleased] + +### Fixed + +- `Configuration::LOCAL_ENDPOINT_PATH`, the class docs and the README's + self-hosting example pointed at `/active_agent/api/traces`, a path no + current dashboard mount serves. The actionagent engine ingests at + `/api/traces` and is mounted at `/activeagents` by default, so the + constant and the docs now say `/activeagents/api/traces` and note that a + custom mount changes the prefix. (#3) + ## [0.2.0] - 2026-08-14 ### Added @@ -18,8 +29,6 @@ the application sends the model, so enabling this is a data-handling decision — the truncation is a cap on trace size, not a redaction boundary. -## [Unreleased] - ## [0.1.0] - 2026-08-10 First public release of both gems: `activeagents-telemetry` (the shared diff --git a/README.md b/README.md index ff9c873..f350f90 100644 --- a/README.md +++ b/README.md @@ -56,12 +56,16 @@ backtraces are never transmitted. ## Self-hosting -Point the endpoint at your mounted dashboard — same gems, same wire format: +Point the endpoint at your mounted dashboard — same gems, same wire format. +The dashboard engine ingests at `/api/traces`; its install generator +mounts it at `/activeagents`, so on a default install that is: ```ruby -config.endpoint = "https://your-app.example.com/active_agent/api/traces" +config.endpoint = "https://your-app.example.com/activeagents/api/traces" ``` +If you mounted `ActionAgent::Engine` somewhere else, use that prefix instead. + ## Development ```bash diff --git a/lib/activeagents/telemetry/configuration.rb b/lib/activeagents/telemetry/configuration.rb index e038408..55c0894 100644 --- a/lib/activeagents/telemetry/configuration.rb +++ b/lib/activeagents/telemetry/configuration.rb @@ -14,13 +14,17 @@ module Telemetry # end # # A self-hosted ActiveAgent dashboard is the same thing with a different - # endpoint — point it at "https://your-app.example.com/active_agent/api/traces". + # endpoint — point it at "https://your-app.example.com/activeagents/api/traces" + # (the actionagent engine's default mount; adjust the prefix to wherever + # the host app actually mounted ActionAgent::Engine). class Configuration # The hosted platform. Self-hosters override `endpoint`. DEFAULT_ENDPOINT = "https://api.activeagents.ai/v1/traces" - # Path a mounted ActiveAgent::Dashboard::Engine serves traces on. - LOCAL_ENDPOINT_PATH = "/active_agent/api/traces" + # The ingest path of the dashboard engine (ActionAgent::Engine) at its + # default mount. The engine ingests at "/api/traces", so a host + # that mounted it elsewhere uses that prefix instead. + LOCAL_ENDPOINT_PATH = "/activeagents/api/traces" # Attribute keys scrubbed from spans before delivery. Name-based — a # secret inside free text is not caught; see the wiki's privacy page.