Authentication & Billing
AgentLens cloud requires an account to access the dashboard and ingest traces. This page covers registration, API key management, billing tiers, and session counting.
Registration
To use AgentLens cloud, create an account at agentlens.vectry.tech/register. You will need to provide an email address and password. Once registered, log in at agentlens.vectry.tech to access the dashboard.
The dashboard requires authentication -- there is no anonymous access. All features including trace viewing, analytics, and settings are available only after login.
API keys
API keys authenticate your SDKs and integrations when sending traces to AgentLens. Keys are generated per-user in the dashboard.
Creating an API key
- Log in to the AgentLens dashboard.
- Navigate to Settings → API Keys.
- Click Create API Key, give it a name, and copy the generated key.
- Store the key securely. It will not be shown again after you leave the page.
Using your API key
Pass the key to the SDK during initialization, or set it as the AGENTLENS_API_KEY environment variable. The SDKs will pick it up automatically.
Security note: Treat API keys like passwords. Do not commit them to version control. Use environment variables or a secrets manager in production.
Billing tiers
AgentLens cloud offers three billing tiers. One trace equals one session for billing purposes.
| Plan | Price | Sessions | Details |
|---|---|---|---|
| Free | $0 | 20 sessions/day | No credit card required. Ideal for experimentation and personal projects. |
| Starter | $5/month | 1,000 sessions/month | For individual developers with moderate tracing needs. |
| Pro | $20/month | 100,000 sessions/month | For teams and production workloads with high trace volume. |
Session counting
A session is equivalent to a single trace sent to the AgentLens API. Each call to POST /api/traces that includes one trace counts as one session, regardless of how many spans, decision points, or events are inside that trace.
If you batch multiple traces in a single API call, each trace in the batch counts as a separate session.
Managing your subscription
To view your current plan, upgrade, downgrade, or manage payment methods, go to Settings → Billing in the dashboard. Changes take effect immediately. If you downgrade mid-cycle, you retain access to the higher tier until the end of the current billing period.
Self-hosted instances
If you are running a self-hosted AgentLens instance, registration with the hosted SaaS service is not required. Self-hosted deployments manage their own authentication and have no session limits or billing tiers. See the Self-Hosting guide for setup instructions.