Monitoring
Monitor your application's health, performance, and resource usage in real-time. Get visibility into CPU, memory, network traffic, and response times to proactively detect and resolve issues.
Real-Time Metrics
Temps provides real-time metrics for every deployed container, giving you instant visibility into your application's performance.
Available Metrics:
- Requests - Total requests and request rate
- Response Time - Average response time in ms
- CPU Usage - Percentage of CPU resources used
- Memory Usage - RAM consumption in MB and percentage
- Network I/O - Inbound and outbound data transfer rate
Metrics update in real-time, so you always see current performance data.
Where to View:
- Navigate to your project in the dashboard
- Open the Monitoring tab
- View real-time metrics and charts
Accessing Metrics
Via Dashboard
- Go to Projects → Select your project
- Click the Monitoring tab
- View real-time metrics: requests, response time, CPU, memory, and network I/O
The monitoring dashboard shows:
- Requests - Total requests over time with request rate
- Response Time - Average response time graph
- CPU - Live CPU usage percentage
- Memory - Live memory usage in MB and percentage
- Network I/O - Real-time inbound/outbound data transfer
Via API
Access metrics programmatically using the API:
# Get real-time metrics for an environment
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://your-temps-instance.com/api/projects/{project_id}/environments/{environment_id}/metrics"
The API returns:
{
"requests_total": 1523,
"requests_rate": 12.5,
"response_time_avg_ms": 45,
"cpu_percent": 23.5,
"memory_bytes": 268435456,
"memory_percent": 52.0,
"network_rx_bytes_per_sec": 1024,
"network_tx_bytes_per_sec": 2048
}
Understanding Metrics
- Name
Requests- Description
What it shows: Total number of requests and request rate over time When to worry: - Sudden spikes in traffic - Unusually high error rates - Request rate exceeds expected capacity Action: Monitor traffic patterns and scale resources if needed
- Name
Response Time- Description
What it shows: Average time to process requests in milliseconds When to worry: - Consistently above 500ms may indicate performance issues - Sudden spikes in response time Action: - Optimize application code - Add caching - Review database queries - Consider scaling
- Name
CPU Usage- Description
What it shows: Percentage of CPU resources your container is using When to worry: - Consistently above 80% may indicate performance issues
- Spikes above 90% during traffic surges are normal
- Sustained 100% usage suggests you need more CPU resources Action: If CPU is consistently high, consider: - Increasing CPU allocation in project settings - Optimizing application code
- Name
Memory Usage- Description
What it shows: RAM consumption in bytes and percentage of allocated memory When to worry: - Approaching 90% of allocated memory
- Memory usage continuously growing (potential memory leak)
- Container restarts due to OOM (Out of Memory) errors Action: If memory is high: - Increase memory allocation - Investigate memory leaks in your code
- Name
Network I/O- Description
What it shows: Data transfer rates (inbound and outbound) in bytes per second What to monitor: - Unusual spikes in traffic - Asymmetric patterns (high outbound, low inbound) - Network saturation Action: High network usage is usually normal for web applications, but monitor for: - DDoS attacks (sudden massive spikes) - Data exfiltration (unusual outbound patterns)
Health Checks
Configure health checks to automatically monitor your application's availability:
Setting Up Health Checks
Health checks are configured in your project's deployment settings:
- Go to Project Settings → Deployment
- Configure Health Check settings:
- Path: Endpoint to check (e.g.,
/healthor/api/health) - Interval: How often to check (default: 30 seconds)
- Timeout: Maximum wait time (default: 5 seconds)
- Retries: Number of failed attempts before marking unhealthy
- Path: Endpoint to check (e.g.,
Health Check Endpoint
Your application should expose a health check endpoint that returns quickly:
// Express.js example
app.get("/health", (req, res) => {
res.status(200).json({ status: "ok", timestamp: Date.now() });
});
# Flask example
@app.route('/health')
def health():
return {'status': 'ok', 'timestamp': time.time()}, 200
Best Practice: Keep health checks lightweight. They should check basic application state (database connectivity, critical services) but avoid expensive operations.
Monitoring Best Practices
- Name
Set Resource Limits- Description
Configure appropriate CPU and memory limits based on your application's needs. Monitor actual usage and adjust as needed. How to set: 1. Project Settings → Deployment → Resources 2. Set CPU (millicores) and Memory (MB) 3. Monitor for a few days 4. Adjust based on actual usage patterns
- Name
Monitor Trends- Description
Don't just look at current values—watch for trends: - Gradual memory increases (memory leaks) - CPU spikes during specific times (traffic patterns) - Network anomalies (security issues)
- Name
Set Up Alerts- Description
Configure alerts for critical thresholds: - CPU > 90% for 5 minutes - Memory
85% of allocation - Container restarts - Health check failures Alerts can notify you via email, webhooks, or integrations.
- Name
Compare Environments- Description
Compare metrics across environments to identify issues: - Production vs staging performance - Preview environment resource usage - Before/after deployment comparisons
Troubleshooting
- Name
High CPU Usage- Description
Symptoms: CPU consistently above 80-90% Possible causes: - Inefficient code or algorithms - Too many concurrent requests - Insufficient CPU allocation Solutions: 1. Increase CPU allocation in project settings 2. Optimize application code 3. Add caching to reduce computation 4. Scale horizontally (multiple containers)
- Name
High Memory Usage- Description
Symptoms: Memory approaching allocation limit, container restarts Possible causes: - Memory leaks in application code - Insufficient memory allocation - Large data structures in memory Solutions: 1. Increase memory allocation 2. Profile application for memory leaks 3. Implement pagination for large datasets 4. Use streaming for large file operations
- Name
Container Restarts- Description
Symptoms: Frequent container restarts, deployment failures Possible causes: - Out of memory (OOM) errors - Application crashes - Health check failures Solutions: 1. Check deployment logs for error messages 2. Review memory usage patterns 3. Verify health check endpoint is working 4. Check application error logs
- Name
Metrics Not Updating- Description
Symptoms: Monitoring dashboard showing stale data or errors Possible causes: - No active deployments - Network connectivity issues - Service unavailable Solutions: 1. Verify a deployment is running 2. Check deployment status 3. Refresh the monitoring page 4. Contact support if issue persists
Next Steps
- Configure Resource Limits to set CPU and memory allocations
- Set Up Health Checks to monitor availability
- View Application Logs to correlate metrics with application behavior
- Set Up Alerts for proactive issue detection