For the complete documentation index, see llms.txt. This page is also available as Markdown.

Routine monitoring

1. Introduction

Routine monitoring is essential for maintaining a healthy and reliable OpenCRVS installation. Regular monitoring helps you identify and resolve issues before they impact users, and ensures that your infrastructure is operating within safe limits.

This section provides guidance on daily monitoring tasks and built-in alerts.

2. Monitoring and maintenance checklist

We provide a comprehensive document to understand regular tasks required to monitor and maintain a running instance of OpenCRVS.

Download the checklist:

Download the Monitoring & Maintenance document and Excel checklist from the "Technical" zip in the OpenCRVS Requirements Templates.

These cover tasks such as:

  • Tracking the OpenCRVS release and upgrading when required

  • Monitoring system upgrades such as for the server operating system

  • Refreshing expiring TLS/SSL certificates

  • Reacting to automatic alerts from Sentry or Kibana

3. Built-in alerts from Kibana

OpenCRVS comes with a built-in set of automatic email alerts that capture a minimal set of critical limits and conditions necessary for the product to work. When these alerts are triggered, the issues need to be solved as soon as possible.

Manual activation required — After deployment, these alerts are configured automatically. However, you will need to log in to Kibana to manually turn the alerts on after each deployment. We are addressing automatic enabling of these alerts by default in future versions of OpenCRVS.

4. Daily monitoring checklist

It's a good practice to monitor your production installation's infrastructure manually on a daily basis. This practice improves the reliability of your environment and gives your team a chance to include server improvements in planned work.

4.1 Disk space usage on all nodes is less than 70%

Steps:

  1. Login to Kibana

  2. Navigate to ObservabilityMetricsMetrics Explorer

  3. Use the parameters listed in the Infrastructure health section under Available disk space

  4. Verify all used disk space is under 70% on all nodes

4.2 CPU and memory usage less than 80% on all nodes

Steps:

  1. Login to Kibana

  2. Navigate to ObservabilityMetricsMetrics Explorer

  3. Use the parameters listed in the Infrastructure health section under CPU usage

  4. Select a timeframe of 24 hours

  5. Verify CPU load has not exceeded 80% on any of your server nodes

4.3 No errors in any services

Steps:

  1. Login to Kibana

  2. Navigate to ObservabilityAPMServices

  3. Select each service

  4. Check the Errors tab

  5. Investigate any errors reported

5. Responding to alerts

When alerts are triggered:

  • Acknowledge immediately — ensure the team is aware of the issue

  • Assess severity — determine if immediate action is required or if it can be planned

  • Investigate root cause — use the monitoring tools to understand what triggered the alert

  • Take corrective action — resolve the issue or scale resources as needed

  • Document — log the incident and resolution for future reference

Oftentimes it's better if issues are solved and planned for even before reaching the critical limits. Proactive monitoring helps prevent alerts from triggering in the first place.

Last updated