Advanced Django performance monitoring agent - Middleware tracking, database query optimization, template rendering analysis, session monitoring, and comprehensive view-level performance metrics.
npm install @stacksleuth/django-agentStackSleuth Django Agent
Advanced Django performance monitoring agent - Middleware tracking, database query optimization, template rendering analysis, session monitoring, and comprehensive view-level performance metrics.
- 🐍 Django Middleware Tracking: Request/response middleware performance
- 🗄️ ORM Query Optimization: Django ORM query performance analysis
- 🎨 Template Rendering: Django template performance monitoring
- 👤 Session Monitoring: User session performance tracking
- 🔍 View-level Metrics: Detailed view function performance data
- 🔄 Real-time Updates: WebSocket integration for live monitoring
- 📊 Admin Integration: Django admin performance insights
- ⚡ Production Ready: Minimal overhead Django integration
``bashnpm
npm install @stacksleuth/django-agent
bash
yarn add @stacksleuth/django-agent
`bash
pnpm add @stacksleuth/django-agent
`🏁 Quick Start
python
settings.py
INSTALLED_APPS = [
# ... your apps
'stacksleuth.django',
]MIDDLEWARE = [
'stacksleuth.django.middleware.StackSleuthMiddleware',
# ... your middleware
]
STACKSLEUTH = {
'ENABLED': True,
'SAMPLE_RATE': 0.1,
'MONITOR_DATABASE': True,
'MONITOR_TEMPLATES': True,
}
views.py
from stacksleuth.django import track_performance@track_performance('user-list-view')
def user_list(request):
users = User.objects.all()
return JsonResponse({'users': list(users.values())})
`
📖 Comprehensive Examples
$3
typescript
settings.py
INSTALLED_APPS = [
# ... your apps
'stacksleuth.django',
]MIDDLEWARE = [
'stacksleuth.django.middleware.StackSleuthMiddleware',
# ... your middleware
]
STACKSLEUTH = {
'ENABLED': True,
'PROJECT_ID': 'your-project-id',
'API_KEY': 'your-api-key',
'SAMPLE_RATE': 0.1,
'MONITOR_DATABASE': True,
'MONITOR_TEMPLATES': True,
}
`$3
typescript
views.py
from stacksleuth.django import track_performance
from django.http import JsonResponse@track_performance('user-list-view')
def user_list(request):
users = User.objects.select_related('profile').all()
# Track business metrics
track_metric('users.listed', len(users), {
'request_method': request.method,
'user_authenticated': request.user.is_authenticated
})
return JsonResponse({'users': list(users.values())})
`🎯 Real-World Usage
$3
typescript
const agent = new DjangoAgent({
enabled: process.env.NODE_ENV === 'production',
projectId: process.env.STACKSLEUTH_PROJECT_ID,
apiKey: process.env.STACKSLEUTH_API_KEY,
sampleRate: process.env.NODE_ENV === 'production' ? 0.01 : 0.1,
bufferSize: 1000,
flushInterval: 10000
});
`$3
- Sampling Rate: Use lower sampling rates (1-5%) in production
- Buffer Management: Configure appropriate buffer sizes for your traffic
- Error Handling: Always include error context in your monitoring
- Security: Never log sensitive data like passwords or API keys
- Performance: Monitor the monitoring - track agent overhead
🛠️ Troubleshooting
$3
Agent Not Starting
typescript
// Enable debug mode
const agent = new DjangoAgent({
enabled: true,
debug: true
});
`High Memory Usage
typescript
// Optimize memory usage
const agent = new DjangoAgent({
bufferSize: 500,
flushInterval: 5000,
sampleRate: 0.01
});
`Missing Metrics
- Check that the agent is enabled
- Verify your API key and project ID
- Ensure sampling rate allows data through
- Check network connectivity to StackSleuth API
$3
bash
DEBUG=stacksleuth:* node your-app.js
``- Official Documentation
- API Reference
- Examples Repository
We welcome contributions! Please see our Contributing Guide for details.
MIT License - see the LICENSE file for details.
---
Website •
Documentation •
NPM Registry •
GitHub
Made with ⚡ by StackSleuth