Metadata-Version: 2.4
Name: echologs
Version: 0.1.4
Summary: Monitoring and observability for Python and AI scripts. Automatically captures stdout, stderr, errors, and execution time — then sends everything to your EchoLogs dashboard.
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28

# 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

```bash
pip install echologs
```

## Quickstart

```python
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:

```bash
# 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](https://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](https://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](https://echologs.com)
- Dashboard: [app.echologs.com](https://app.echologs.com)
- Docs: [app.echologs.com/docs](https://app.echologs.com/docs)
- JavaScript SDK: [npmjs.com/package/echologs](https://npmjs.com/package/echologs)
- GitHub: [github.com/ZionCodes/echologs-python](https://github.com/ZionCodes/echologs-python)


