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:
| Tier | Lens Access |
|---|---|
| Community | 24-hour fleet snapshot (read-only) |
| Pro | Full interactive dashboard, single service, 30-day retention |
| Enterprise | Fleet-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
- Dashboard Guide — Learn to navigate the fleet overview and service drill-downs
- Performance Analytics — Understand JIT stats, latency, and throughput data
- Enhancement Levels — How Epochly's L0-L4 optimization works