eyriehq-sdk 0.1.1

Python SDK for the EyrieHQ observability platform

EyrieHQ Python SDK

Python client library for the EyrieHQ observability platform.

Installation

pip install eyriehq-sdk

Quick Start

from eyrie import EyrieClient

client = EyrieClient(
    base_url="https://api.eyriehq.example.com",     # Backend URL for queries
    collector_url="https://collector.example.com",   # Collector URL for push
    api_key="iw_sk_a3f8b2c1...",                    # API key for push auth
    email="[e-mail]",                       # Backend login for queries
    password="secret",                               # Backend login for queries
)

# Push traces (uses API key via X-API-Key header)
client.traces.push(spans=[
    {
        "name": "http.request",
        "start_time": "2026-01-01T00:00:00Z",
        "end_time": "2026-01-01T00:00:01Z",
    }
])

# Push metrics
client.metrics.push(metrics=[
    {"name": "cpu.usage", "value": 72.5, "type": "gauge"}
])

# Push logs
client.logs.push(logs=[
    {"body": "Request processed successfully", "severity": "INFO"}
])

# Query traces (uses email/password session)
traces = client.traces.search(service="api-gateway")

# Health check
status = client.health()

Authentication

The SDK uses two authentication mechanisms:

• Push (to collector): API key via X-API-Key header. Generate your API key in Admin > Observability in the EyrieHQ UI.
• Query (from backend): Email/password session cookies. The SDK handles login automatically on the first query.

License

Proprietary. See LICENSE for details.