Release History
Requirements

Introduction

Quick onboard

Deployment

Data Modeling

Connecting

Write data

Migration

Query

Operations and Maintenance

Performance Tuning

Troubleshooting

Reference Guide

SQL Reference

FAQ

Installation and Initialization

This document details the integrated installation of Prometheus and Grafana for YMatrix.

Prerequisites

Install Required Dependencies

The monitoring bundle depends on the rsync utility. Ensure it is installed:

yum install -y rsync

Verify mxadmin Has sudo Privileges

grep -E 'mxadmin\s+ALL=$ALL$\s+NOPASSWD:\s+ALL' /etc/sudoers /etc/sudoers.d/*

Extract the Monitoring Bundle

cd /software
unzip monitor_amd64_V1.1.zip

Note!
You must use the V1.1 unified installation package.
Older versions used .rpm packages for Grafana; the new version uniformly uses .tar.gz packages. Using an .rpm package will cause mxtool init monitor to fail.

Install Monitoring Components (Master Node Only)

mxtool is a wrapper script that prints and executes underlying commands sequentially. If any step fails, you can manually log in to the target host to reproduce and troubleshoot.

Note!
Replace paths to installation packages with your actual file locations.

mxtool init monitor \
  --mxrepo=/software/mxrepo_centos-7_amd64_v6.2.3.tar.gz \
  --grafana=/software/grafana-enterprise-12.0.1.linux-amd64.tar.gz \
  --prometheus=/software/prometheus-3.4.1.linux-amd64.tar.gz \
  --node_exporter=/software/node_exporter-1.9.1.linux-amd64.tar.gz \
  --sshport=22 \
  --monitor-hostname=fine-cluster01 \
  --data-directory=/data \
  --cluster-name=cluster1
  • Parameter Descriptions
Parameter Description
--data-directory Root directory for monitoring data storage (e.g., Prometheus, Grafana).
--monitor-hostname Hostname where Grafana and Prometheus are deployed.
--sshport SSH port for cluster nodes (default: 22).
--cluster-name Logical name of the YMatrix cluster, used in metric labels and dashboard naming.
  • Expected Successful Output

Verify Node Exporter Metric Collection

curl http://127.0.0.1:9273/metrics | grep net_dev
curl http://127.0.0.1:9273/metrics | grep conn_stat

Example curl output
Metric format validation

Log in to Prometheus and Check Targets

Access Prometheus at (replace <IP> with the actual IP address of monitor-hostname):

http://<IP>:9090

Prometheus Targets Page

Import Grafana Dashboards

Access Grafana Web UI

http://<IP>:3000

Import Dashboard JSON Files

Dashboard files are located inside the extracted mxrepo package at:
YMatrix-Field-Monitor-Ext/etc/dashboard/YMatrix Monitor ext_*.json

For detailed configuration guidance, see: Grafana Cluster Monitoring

← Previous
MXUI Health Monitoring
Next →
Grafana Cluster Monitoring