> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managed Architecture

> How Asymptote Managed centralizes agent telemetry, policy, detections, and investigations

## Overview

Asymptote Managed builds on the open-source Agent Beacon foundation with hosted ingest, retention, search, detections, policy controls, identity mapping, approvals, and investigation workflows.

Use this architecture when agent activity needs to be visible across teams, endpoints, cloud agent applications, and security workflows from one managed control plane.

<img src="https://mintcdn.com/asymptotelabs/G1ArxTrgtbPXTwMs/images/asymptote-platform-diagram.png?fit=max&auto=format&n=G1ArxTrgtbPXTwMs&q=85&s=428116637036c69c0be6d7de1c64b8a2" alt="Asymptote platform architecture showing agent activity flowing into managed visibility, policy, and investigation workflows." width="1586" height="992" data-path="images/asymptote-platform-diagram.png" />

## System architecture

1. **Agent activity sources:** Endpoint agent harnesses, cloud-hosted agent applications, services, workers, serverless functions, and other execution environments produce runtime telemetry.
2. **Collection paths:** Agent Beacon collects local endpoint activity, while the Asymptote Observe SDK instruments cloud-hosted agent applications.
3. **Managed ingest:** Asymptote centralizes telemetry for managed retention, search, detections, and fleet-wide visibility.
4. **Governance layer:** Policy controls, identity mapping, approvals, SSO, RBAC, and audit trails connect runtime activity to users, teams, and security workflows.
5. **Investigation workflows:** Timelines and case workflows organize prompts, tool calls, file access, command execution, and related context for review.

## How endpoint telemetry reaches Asymptote

Beacon on the endpoint stays a local JSONL producer. `beacon endpoint connect` adds the managed path:

1. **Approval.** The CLI registers the machine's hostname, OS and Beacon version and opens the dashboard's approval page. A member of the organization signs in with Clerk, picks the organization, and clicks Approve. Only organizations Asymptote has enabled for managed ingest can approve devices.
2. **Device key.** The CLI redeems a one-time code with a PKCE verifier and receives a key for this one device. The key is stored in a `0600` secrets file and read only by Vector; it is never in Beacon's config or the process environment. Revoking the device, or removing the approving user from the organization, invalidates it within about a minute.
3. **Forwarding.** A Vector service tails `runtime.jsonl` (from the point of approval) and `inventory_state.jsonl` and POSTs gzip NDJSON batches to Asymptote's ingest service with the device key. A disk buffer covers offline periods.
4. **Ingest.** The service verifies the key, the approver's membership and the organization's enablement, validates each line, stamps a `tenant` block (organization, device, approving user, receive time) server-side, and writes one object per batch under `orgs/<organization>/<stream>/date=…/` in Asymptote's bucket.
5. **Per-organization tables.** Each object triggers a notification; the organization's own ClickPipe loads it into that organization's ClickHouse tables. The dashboard resolves an organization to its tables through a mapping row, so tenant isolation is a table boundary, and duplicates from retried batches collapse on Beacon's deterministic event id.

## Managed capabilities

| Capability | Purpose |
| - | - |
| Managed ingest and retention | Centralize runtime telemetry and preserve it according to managed retention policy |
| Fleet-wide visibility | Track agent harnesses, endpoints, users, teams, and cloud execution environments |
| Search and detections | Find risky activity and surface detection signals across the managed dataset |
| Policy and approvals | Govern agent actions and connect approvals back to identity and workflow context |
| Investigation timelines | Reconstruct agent sessions from prompts, tool calls, files, commands, and outcomes |
| Access control | Use SSO, RBAC, and audit trails for enterprise access governance |

## Related

<Columns cols={2}>
  <Card title="Open Source Architecture" icon="diagram-project" href="/architecture/architecture">
    Review the local-first Agent Beacon architecture.
  </Card>

  <Card title="Asymptote Managed" icon="key" href="/deployment/managed">
    Review managed ingest, governance, investigations, and rollout support.
  </Card>

  <Card title="Asymptote Observe SDK" icon="code" href="/sdk/quickstart">
    Instrument cloud-hosted agent applications with Asymptote telemetry.
  </Card>

  <Card title="Hosting Options" icon="cloud" href="/deployment/hosting-options">
    Compare Open Source, Managed, and Private Deployment paths.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.