FetchNode Python & Django SDK

Official Python and Django client SDK for FetchNode, the focused operations and monitoring workspace for Django teams and portfolio operators.

FetchNode captures unhandled exceptions, error logs, slow database queries, Celery background tasks, and business conversions with zero configuration bloat and privacy-safe defaults.

Installation

Install the package using pip or uv:

pip install fetchnode

(Or uv add fetchnode)

Quickstart (Django)

1. Add to INSTALLED_APPS

In your Django settings.py:

INSTALLED_APPS = [
    # ...
    "fetchnode",
]

2. Add the Middleware

Add FetchNodeMiddleware near the top of your MIDDLEWARE list:

MIDDLEWARE = [
    "fetchnode.middleware.FetchNodeMiddleware",
    "django.middleware.security.SecurityMiddleware",
    # ...
]

3. Configure settings.FETCHNODE

FETCHNODE = {
    "API_KEY": "fn_live_your_project_key_here",
    "ENVIRONMENT": "production",  # e.g. "production", "staging"
    
    # Optional: override endpoint for self-hosted FetchNode instances
    # Defaults to FetchNode Cloud: "https://monitor.fetchnode.com"
    # "ENDPOINT": "https://monitor.fetchnode.com",
}

You can also configure via environment variables:

• FETCHNODE_API_KEY
• FETCHNODE_ENVIRONMENT
• FETCHNODE_RELEASE
• FETCHNODE_ENDPOINT

Usage

Milestone & Conversion Tracking

Track business events (form submits, leads, signups, payments) server-side with automatic visitor attribution:

import fetchnode

def contact_view(request):
    form = ContactForm(request.POST)
    if form.is_valid():
        lead = form.save()
        
        # Track authoritative conversion
        fetchnode.track(
            "lead_submitted",
            request=request,
            idempotency_key=str(lead.id),
            properties={"email": lead.email},
            conversion=True,
        )
        return redirect("thank_you")

Manual Exception Capture

import fetchnode

try:
    risky_operation()
except Exception as exc:
    fetchnode.capture_exception(exc)

Celery Task Monitoring

FetchNode automatically instruments Celery when installed. To manually monitor tasks or commands:

from fetchnode import capture_job

@capture_job(name="sync_external_inventory")
def sync_inventory():
    ...

Privacy by Default

FetchNode is engineered with privacy-safe defaults:

• Sensitive keys (password, token, secret, api_key, authorization, cookie, csrfmiddlewaretoken) are scrubbed before payload transmission.
• Request bodies and raw IP addresses are excluded by default.
• Query string parameters and raw SQL values are normalized.

License

MIT License. See LICENSE for details.