Documentation

Lens

Epochly Lens: Getting Started

Access Epochly Lens, connect your services, and see your fleet dashboard in under 60 seconds.

Access Epochly Lens, connect your services, and see your fleet dashboard in under 60 seconds.

What is Lens?

Epochly Lens is the fleet-wide observability dashboard for teams running Epochly in production. It transforms the telemetry data already collected by Epochly Runtime into actionable dashboards showing service health, performance analytics, and optimization coverage.

Accessing Lens

Visit lens.epochly.com and sign up with your email. Lens is included with every Epochly tier:

TierLens Access
Community24-hour fleet snapshot (read-only)
ProFull interactive dashboard, single service, 30-day retention
EnterpriseFleet-wide dashboard, 13-month retention, RBAC + audit log

Connecting Your First Service

Step 1: Create an API Key

In Lens, go to Settings → API Keys and create a new key. This key allows your Epochly Runtime instances to send telemetry to Lens.

Step 2: Set the Environment Variable

export EPOCHLY_API_KEY=your_api_key_here

Step 3: Run Your Service

python your_service.py

Your service will appear in the Lens fleet overview within 60 seconds. The health indicator will show green once a heartbeat is received.

Verifying the Connection

After starting your service, verify the connection in two places:

1. Check Lens dashboard: Open lens.epochly.com and look for your service in the fleet overview. A green status dot confirms the connection is active.

2. Check CLI stats: Run the following to confirm Epochly is active on your service:

python -c "import epochly; print(epochly.stats())"

This shows runtime optimization metrics (functions optimized, speedup, enhancement level). Lens receives the same telemetry data automatically when EPOCHLY_API_KEY is set and telemetry is enabled (the default). If you have disabled telemetry (EPOCHLY_DISABLE_TELEMETRY=1, EPOCHLY_TELEMETRY=false, or EPOCHLY_TELEMETRY=0), Lens will not receive data — remove those settings to connect.

Next Steps