treblle 2.0.1

Treblle SDK for Django - Production-ready API monitoring and intelligence platform

Treblle - API Intelligence Platform

Website • Documentation • Pricing

Treblle is an API intelligence platfom that helps developers, teams and organizations understand their APIs from a single integration point.

---

Treblle Django SDK

Requirements

• Python: 3.7 or higher
• Django: 2.2 or higher
• requests: 2.25.0 or higher

Note: Django 5.0+ requires Python 3.10 or higher. If you're using Django 5.x, ensure you have Python 3.10+.

Getting Started

You can install Treblle for django via PyPI.

For the latest stable version:

$ pip install treblle

Don’t forget to load the required python modules in your settings.py like so:

INSTALLED_APPS = [
...
'treblle',
]

MIDDLEWARE = [
    ...
    'treblle.middleware.TreblleMiddleware',
]

Create a FREE account on treblle.com, copy your SDK Token and API Key from the Treblle Dashboard to settings.py like so:

TREBLLE = {
    'SDK_TOKEN': os.environ.get('TREBLLE_SDK_TOKEN'),
    'API_KEY': os.environ.get('TREBLLE_API_KEY'),
    'MASKED_FIELDS': ['custom_field', 'internal_id'],  # Optional - additonal fields to mask
    'DEBUG': True,  # Optional - enables debug logging (default: False)
    'EXCLUDED_ROUTES': ['/health/', '/ping', '/admin/*'],  # Optional - routes to exclude from tracking
}

Visit the Treblle Dashboard and see requests appear in real-time.

Version 2.0 🚀

Treblle Django SDK v2.0 brings significant performance improvements, better security, and enhanced developer experience. This version has been completely rewritten with production-grade optimizations.

🔄 Migrating from v1 to v2

If you're upgrading from v1, you'll need to make these changes:

1. Configuration Format (REQUIRED)

❌ Old v1 Format:

TREBLLE_INFO = {
    'api_key': 'your_sdk_token',
    'project_id': 'your_api_key',
    'hidden_keys': ['password']
}

✅ New v2 Format:

TREBLLE = {
    'SDK_TOKEN': 'your_sdk_token',
    'API_KEY': 'your_api_key',
    'MASKED_FIELDS': ['password'], # Optional
    'DEBUG': False, # Optional
    'EXCLUDED_ROUTES': ['/health/', '/ping'], # Optional
}

2. Django Settings Update (REQUIRED)

❌ Old v1 Middleware:

MIDDLEWARE_CLASSES = [  # Deprecated Django setting
    'treblle.middleware.TreblleMiddleware',
]

✅ New v2 Middleware:

MIDDLEWARE = [  # Modern Django setting
    'treblle.middleware.TreblleMiddleware',
]

---

Debug Mode

Enable debug mode to get detailed logging about the SDK's operation:

• Configuration errors: Missing or invalid SDK_TOKEN/API_KEY
• Middleware loading: Confirmation that Treblle is active
• API responses: HTTP status codes from Treblle endpoints
• Error handling: 4xx/5xx errors with helpful troubleshooting tips
• Data processing: JSON validation and masking information

TREBLLE = {
    'SDK_TOKEN': 'your_sdk_token',
    'API_KEY': 'your_api_key', 
    'DEBUG': True  # Enable debug mode
}

Route Exclusion

You can exclude specific routes from being tracked by Treblle. This is useful for health checks, monitoring endpoints, or other routes that generate high-frequency, low-value traffic:

TREBLLE = {
    'SDK_TOKEN': 'your_token',
    'API_KEY': 'your_key',
    'EXCLUDED_ROUTES': [
        '/health/',           # Exact path match
        '/api/health',        # Exact path match  
        '/ping',              # Exact path match
        '/admin/*',           # Wildcard: excludes /admin/login, /admin/users, etc.
        '*/metrics',          # Wildcard: excludes /api/metrics, /internal/metrics, etc.
        '/status/*',          # Wildcard: excludes anything under /status/
    ],
}

Pattern matching:

• Exact matches: /health/ only matches exactly /health/
• Wildcards: Use * for flexible matching (e.g., /admin/* matches /admin/login, /admin/users/1)
• Debug logging: Enable DEBUG: True to see which routes are being excluded

See the docs for this SDK to learn more.

Getting Help

If you continue to experience issues:

1. Enable debug: true and check console output
2. Verify your SDK token and API key are correct in Treblle dashboard
3. Test with a simple endpoint first
4. Check Treblle documentation for the latest updates
5. Contact support at https://treblle.com or email [e-mail]

Support

If you have problems of any kind feel free to reach out via https://treblle.com or email [e-mail] and we'll do our best to help you out.

License

Copyright 2025, Treblle Inc. Licensed under the MIT license: http://www.opensource.org/licenses/mit-license.php