Deploy and Explore the All‑in‑One Open‑Source Monitoring System Xrkmonitor

Project Overview

Xrkmonitor is an open‑source, domestic monitoring system that integrates point monitoring, log monitoring, data visualization, and alerting, ready for immediate deployment.

It supports rich monitoring data types and expressive charts such as line, pie, and geographic maps, with more chart types planned.

Advantages Over Other Open‑Source Monitoring Systems

Plugin support – monitoring plugins can be installed without development.

Built‑in alerting with multiple notification methods.

Integrated distributed log system.

Flexible deployment options:

Centralized deployment – all services on a single machine, suitable for individuals or small teams.

Distributed deployment – services across multiple machines, suitable for small‑to‑medium enterprises.

Automatic configuration – agents register automatically after deployment.

Multi‑user access – sub‑accounts added by an admin.

Reporting APIs support major programming languages with convenient library‑like interfaces.

Featured Functions

IP address library – converts reported IPs to physical locations and aggregates them for easy monitoring.

Monitoring plugin marketplace – reusable monitoring components with ongoing development.

Distributed log system – supports large‑scale log ingestion, rate limiting, log coloring, custom fields, and advanced filtering by keyword, time, or host.

View mechanism – customizable chart views based on reporting servers or monitoring points, with direct alarm threshold settings.

Integrated alerting – email, SMS, WeChat, and PC client notifications without additional development.

Online Deployment

Online deployment notes:

The installer first checks system compatibility; if unsupported, download the source and compile locally.

Currently only centralized deployment is supported, requiring MySQL/Apache on the host machine.

The script uses UTF‑8 encoding; ensure the terminal is set to UTF‑8 to avoid garbled text.

Both root and regular accounts are supported. For regular accounts, the script must be run in /home/mtreport and may require additional permissions.

It is recommended to test the online installation on a local VM before deploying to production.

Offline Deployment (Compile from Source)

If online installation fails or custom development is needed, use source compilation:

Run make to compile the source.

Enter the tools_sh directory and execute make_all.sh to generate the deployment package.

Extract the package in the installation directory and run local_install.sh to complete installation.

Technology Stack

Apache + MySQL – data and configuration storage, supports distributed deployment.

Frontend web console built with the DWZ open‑source framework.

Charts rendered using the open‑source ECharts library.

Backend CGI powered by the Clearsilver template engine, deployed via FastCGI.

Backend services implemented with the open‑source C++ Sockets framework.

Project URL

Official website: http://xrkmonitor.com/