justanalytics-python 0.1.1

Official Python SDK for JustAnalytics — end-to-end observability (traces, errors, logs, metrics)

justanalytics-python

Official Python SDK for JustAnalytics — end-to-end observability (traces, errors, logs, metrics).

Installation

pip install justanalytics-python

With framework extras:

pip install justanalytics-python[django]
pip install justanalytics-python[flask]
pip install justanalytics-python[fastapi]
pip install justanalytics-python[requests]

Quick Start

import justanalytics

justanalytics.init(
    site_id="site_abc123",
    api_key="ja_sk_your_api_key_here",
    service_name="api-server",
    environment="production",
)

# Traced spans (context manager)
with justanalytics.start_span("process-order") as span:
    span.set_attribute("order.id", "12345")
    result = process_order()

# Decorator
@justanalytics.span(op="db.query")
def get_user(user_id: str):
    return db.query(...)

# Error capture
try:
    risky_operation()
except Exception as e:
    justanalytics.capture_exception(e, tags={"module": "payments"})

# Message capture
justanalytics.capture_message("Deployment complete", level="info")

# User context
justanalytics.set_user(id="user-123", email="[e-mail]")

# Tags
justanalytics.set_tag("feature", "checkout")

# Structured logging
justanalytics.log("info", "User logged in", {"userId": "u123"})

# Metrics
justanalytics.record_metric("custom.queue_size", 42, {"queue": "emails"})

# Flush before shutdown
justanalytics.flush()
justanalytics.close()

Framework Integrations

Django

# settings.py
MIDDLEWARE = [
    "justanalytics.integrations.django.JustAnalyticsMiddleware",
    # ... other middleware
]

Flask

from flask import Flask
from justanalytics.integrations.flask import JustAnalyticsMiddleware

app = Flask(__name__)
JustAnalyticsMiddleware(app)

FastAPI

from fastapi import FastAPI
from justanalytics.integrations.fastapi import JustAnalyticsMiddleware

app = FastAPI()
app.add_middleware(JustAnalyticsMiddleware)

requests library

from justanalytics.integrations.requests import RequestsIntegration

integration = RequestsIntegration(service_name="my-service")
integration.enable()
# All requests.get/post calls are now traced

Python logging bridge

import logging
from justanalytics.integrations.logging import JustAnalyticsHandler

handler = JustAnalyticsHandler(level=logging.WARNING)
logging.getLogger().addHandler(handler)

W3C Trace Context

from justanalytics import parse_traceparent, serialize_traceparent

# Parse incoming header
data = parse_traceparent("00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01")

# Serialize outgoing header
header = serialize_traceparent(trace_id, span_id, sampled=True)

License

MIT