echologs

Monitoring and observability for Python automation scripts.

Know when your scripts fail, why they failed, and how long they took — without changing how they run.

Install

pip install echologs

Quickstart

import echologs

with echologs.run():
    # your existing code — nothing changes
    print("Running invoice sync...")
    data = fetch_invoices()
    print(f"Done. {len(data)} invoices processed.")

Set ECHOLOGS_API_KEY in your environment before running:

# Mac / Linux — set once per terminal session
export ECHOLOGS_API_KEY=el_your_key_here
python your_script.py

# Windows
set ECHOLOGS_API_KEY=el_your_key_here
python your_script.py

Get your API key at app.echologs.com.

What it captures

• ✓ Every execution with timestamp, duration and pass/fail status
• ✓ Full stdout and stderr output
• ✓ Full error traceback on failure
• ✓ Email alerts on failure
• ✓ Slack alerts on failure
• ✓ Failure streaks — escalated alerts after 3 consecutive failures

No dotenv required

The SDK reads ECHOLOGS_API_KEY from os.environ directly. In production on any platform (Railway, Render, GitHub Actions, cron) the env var is injected automatically — no package installs needed.

Dashboard

Every execution appears in your dashboard at app.echologs.com with:

• Full stdout/stderr log output
• Duration history chart
• Pass rate tracking
• Failure streak detection
• Public status page (shareable URL per script)

Links

• Website: echologs.com
• Dashboard: app.echologs.com
• Docs: app.echologs.com/docs
• JavaScript SDK: npmjs.com/package/echologs
• GitHub: github.com/ZionCodes/echologs-python