Guides

Monitoring Setup

Monitor your Odoo instances and get alerted when issues occur.

Overview

Nurosentrix provides built-in monitoring for all your servers and instances. The monitoring system tracks health metrics, resource usage, and service status.

Dashboard Metrics

The monitoring dashboard shows:

  • Instance Status - Running, stopped, or error state
  • Health Score - Overall health rating (0-100)
  • Resource Usage - CPU, memory, and disk utilization
  • Response Time - HTTP response latency
  • Uptime - Time since last restart

You can access the metrics dashboard from Monitoring in the main navigation. Each instance has a detailed view with history and charts.

Health Checks

Nurosentrix performs automatic health checks every 60 seconds:

CheckDescription
HTTP HealthVerifies Odoo web interface is responding
Database ConnectionTests PostgreSQL connectivity
Container StatusChecks Docker container is running
Disk SpaceMonitors available disk space
Memory UsageTracks memory consumption
CPU UsageMonitors CPU utilization

Health Scoring

Each instance receives a health score from 0-100 based on multiple factors:

Score RangeStatusDescription
80-100HealthyAll systems operating normally
60-79WarningSome metrics need attention
40-59DegradedPerformance issues detected
0-39CriticalImmediate attention required

Health scores appear on the instance card and in the instance detail view so you can spot issues quickly.

Setting Up Alerts

Alert Channels

Configure where to receive alerts:

  1. Go to Settings → Notifications
  2. Click "Add Channel"
  3. Select channel type:
    • Email
    • Slack
    • Webhook
  4. Configure the channel settings
  5. Click "Save"

Slack Integration

  1. Create an Incoming Webhook in Slack
  2. Copy the webhook URL
  3. In Nurosentrix, add a Slack channel
  4. Paste the webhook URL
  5. Test the connection

Alert Rules

Create custom alert rules:

  1. Go to Settings → Alert Rules
  2. Click "Add Rule"
  3. Configure:
    • Metric to monitor
    • Threshold value
    • Duration (how long before alerting)
    • Notification channels
  4. Click "Save"

Alert rules are evaluated continuously against the latest metrics. If a condition remains true for the configured duration, a new alert is created and notifications are dispatched to your selected channels.

Default Alert Rules

MetricWarningCritical
CPU Usage> 80% for 5 min> 95% for 2 min
Memory Usage> 85% for 5 min> 95% for 2 min
Disk Usage> 80%> 90%
Response Time> 2s for 5 min> 5s for 2 min
Health Check2 failures3 consecutive failures

Alert rules and triggered alerts are listed under Settings → Alerts.

Viewing Logs

Instance Logs

  1. Go to your instance
  2. Click the "Logs" tab
  3. Select log type:
    • Odoo - Application logs
    • Nginx - Web server logs
    • PostgreSQL - Database logs

Log Filtering

Filter logs by:

  • Time range
  • Log level (DEBUG, INFO, WARNING, ERROR)
  • Search text

Auto-Healing

Nurosentrix includes AI-powered auto-healing that can automatically recover from common issues:

  • Restart service - Automatically restart crashed containers
  • Clear cache - Clear caches when memory is high
  • Cleanup disk - Remove old logs and temp files
  • Rotate logs - Archive and compress old log files

Enabling Auto-Healing

  1. Go to instance settings
  2. Enable "Auto-Healing"
  3. Select which actions to allow
  4. Save settings

Resource Recommendations

Based on your usage patterns, Nurosentrix may recommend:

  • Upgrading server resources when consistently hitting limits
  • Downgrading when resources are underutilized
  • Optimizing Odoo configuration for better performance

Troubleshooting

Not Receiving Alerts

  • Verify notification channel is properly configured
  • Check email spam folder
  • Test the channel with the "Send Test" button
  • Verify alert rules are enabled

High Resource Usage

  • Check for runaway processes in instance logs
  • Review recent code deployments
  • Consider upgrading server resources
  • Enable auto-scaling if available