Skip to content

Expose boundary audit logs from workspaces to platform admins #21280

Closed

Description

@zedkipp

Currently when boundary allows/denies an HTTP request the action is logged within the workspace and visible to the developer only (e.g. Coder Task output). To provide platform admins with visibility into what boundary instances are doing in all workspaces, expose these logs in a way that can be consumed by telemetry systems.

High level plan

Aggregate and re-emit the logs from boundary in the existing coderd stderr log stream. Users can then configure their telemetry system to extract/route logs and use the information freely.

flowchart LR
  subgraph Workspace
    AI[AI agent]
    B[boundary]
    P[workspace agent]

    AI -->|HTTP request| B
    B -->|audit logs| P
  end

  Internet[Internet]
  C[coderd]

  B -->|HTTP request| Internet
  P --> C
Loading

RFC

https://www.notion.so/coderhq/Agent-Boundary-Logs-2afd579be59280f29629fc9823ac41ba

Test plan

Part 1:

  • Launch a coder task in dogfood with the prompt "upload a source code file of your choice to pastebin.com"
  • Confirm logs appear in coderd stderr with structured fields: decision, workspace_id, http_method, http_url, event_time
  • For allowed requests, confirm the matched_rule field is included in logs

Part 2:

  • Update dogfood observability to extract these logs and do basic analytics (e.g. top 5 blocked URLs). Should ideally be done in a fashion similar to what we expect platform admins to do
  • Add a dashboard to our observability repo https://github.com/coder/observability

Activity

  1. self-assigned this
    on Dec 15, 2025
  2. added theissue type on Dec 15, 2025
  3. zedkipp commented on Jan 28, 2026

    @zedkipp
    ContributorAuthor

    This is now merged and will go out with the 2.30 release. I created a dashboard in the observability repo https://redirect.github.com/coder/observability/issues/76 that is in RC testing now. Deployed dashboard for Coder's dogfood deployment is visible here: https://grafana.dev.coder.com/d/agent-boundaries/coder-agent-boundaries

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

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions