Skip to main content

Quick Start

Analyze your first error log in under 60 seconds

1. Create an account

Sign up at errorlens.ai. No credit card required. Free plan includes 25 analyses per month.

2. Submit your log

From the dashboard, click New Analysis. You have two options:

  • Drag and drop a log file onto the upload zone.
  • Paste your stack trace or log content directly into the text area.

3. Click Analyze

Click the โšก Analyze Errors button. Analysis typically completes in 5โ€“12 seconds depending on log size.

4. Review results

Results are displayed as prioritized error cards, sorted by severity then occurrence count. Each card shows:

  • Error type and severity badge
  • Occurrence count
  • Description and root cause
  • Numbered solution steps
  • Code patch (before/after diff) where applicable
  • Prevention tip

Supported log formats

ErrorLens analyzes any text-based log content. The format-detection step picks up structure, but the AI is happy with plain text too.

  • Plain text โ€” .log .txt (the default)
  • Structured JSON โ€” .json .ndjson (Winston, Pino, Logrus, structlog, Zap)
  • XML โ€” Log4j appender output, JBoss / WildFly logs
  • CSV / YAML โ€” spreadsheet exports, K8s events, CI step output
  • Stack traces โ€” Java, .NET, Python, Ruby, Go panics, Rust, Node, etc.
  • Kubernetes / Docker container logs, CloudWatch, GCP Cloud Logging, Azure Monitor exports
  • Nginx / Apache access & error logs
  • SQL queries (use the dedicated SQL Debug tab on the New Analysis page)

Limits: 100ย KB per pasted log on the dashboard, 200ย KB per POST /api/connectors/ingest body. Larger logs are automatically truncated to fit the model context window.

Calling the API

API access requires a Starter plan or higher. Generate a key in Settings โ†’ API Keys; keys carry the prefix el_live_.

Authentication uses the x-api-key header (not Authorization: Bearer โ€” that's for session tokens).

curl

curl -X POST https://app.errorlens.ai/api/connectors/ingest \ -H 'Content-Type: application/json' \ -H 'x-api-key: el_live_your_key_here' \ -d '{ "logs": "ERROR PaymentService NullPointerException at line 42", "title": "Production payment failures", "source": "k8s-prod" }'

Node.js (fetch)

const res = await fetch('https://app.errorlens.ai/api/connectors/ingest', { method: 'POST', headers: { 'Content-Type': 'application/json', 'x-api-key': process.env.ERRORLENS_API_KEY, }, body: JSON.stringify({ logs: errorLogText, title: 'Background worker crash', source: 'worker-prod-2', }), }); const { analysisId } = await res.json();

Python (requests)

import os, requests resp = requests.post( 'https://app.errorlens.ai/api/connectors/ingest', headers={'x-api-key': os.environ['ERRORLENS_API_KEY']}, json={'logs': error_text, 'title': 'Cron failure', 'source': 'cron-prod'}, timeout=10, ) resp.raise_for_status() analysis_id = resp.json()['analysisId']

All ingest requests are rate-limited at 100/minute per key. The response is 202 Accepted with the new analysisId; configure a Custom Webhook integration to receive the result, or open the analysis in the dashboard.

Browser & device support

Chrome 100+, Firefox 100+, Safari 15+, Edge 100+. Fully responsive โ€” works on iOS 15+, Android 10+, iPadOS 15+. Minimum screen width 320px; 768px+ recommended.

Next steps

  • Full API Reference โ€” endpoints, request/response schema, webhooks.
  • Security โ€” encryption, data handling, vulnerability reporting.
  • Support โ€” docs, community, email, Enterprise support.
Start analyzing โ†’