Monitoring node

Install the following components which constitute the monitoring node:

• InfluxDB - time-series database for collecting the metric data
• Grafana - dashboard visualization layer
• Jmxtrans - Collector to retrieve JMX metrics from remote hosts

Installing and configuring InfluxDB

To install and configure InfluxDB

1. Install InfluxDB from yum repository.
   1. Create /etc/yum.repos.d/influxdb.repo with the following:

      [influxdata]
      
      name = InfluxData Repository - Stable
      baseurl = https://repos.influxdata.com/stable/\$basearch/main
      enabled = 1
      gpgcheck = 1
      gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key

   2. Install with the command:
      

      sudo yum install -y influxdb

2. Use custom configuration file
   1. Locate /etc/influxdb/influxdb.conf. Make a note of the file ownership and permission.
   2. Locate influxdb.conf from the extracted Monitoring-Node-Install folder and replace the existing file in /etc/influxdb/; be sure to reset ownership and permission after replacement
3. Open ports for InfluxDB, if needed. Refer to port table.
4. Enable and start service
   1. Enable the InfluxDB service for startup with the command:
      

      sudo systemctl enable influxdb

   2. Start InfluxDB with the command:
      

      sudo systemctl start influxdb

      
      
5. Create InfluxDB databases with a 35-day retention policy using the following commands:
   

   sudo influx -execute "CREATE DATABASE graphite with duration 35d"
   sudo influx -execute "CREATE DATABASE telegraf with duration 35d"
   sudo influx -execute "CREATE DATABASE twcloud with duration 35d"
   sudo influx -execute "CREATE DATABASE webapp with duration 35d"

Installing Grafana

To install Grafana on the monitoring node

1. Determine a Grafana version and use the following command to install (example for version 9.2.10):

   GRAFANA_VER=9.2.10
   sudo yum install -y https://dl.grafana.com/oss/release/grafana-$GRAFANA_VER-1.x86_64.rpm

2. Open port for Grafana, if needed. Refer to port table.
3. Enable and start servicel

   1. Enable the Grafana service for startup with the command:

      sudo systemctl enable grafana-server

   2. Start Grafana with the command:

      sudo systemctl start grafana-server

Installing and configuring Jmxtrans

To install Jmxtrans on the monitoring node

1. Install with the command:

   sudo yum -y install  https://repo.maven.apache.org/maven2/org/jmxtrans/jmxtrans/270/jmxtrans-270.rpm

2. Delete the Jmxtrans System V service autostart:

   chkconfig --del jmxtrans
   and remove the System V startup script
   rm -f /etc/init.d/jmxtrans

3. Create configuration file for each telemetry node
   1. Locate twcloud.json.template from the extracted Monitoring-Node-Install folder
   2. Create a copy of this template file for each telemetry node in /var/lib/jmxtrans. We recommend using the twcloud-[hostname].json naming convention, where [hostname] is associated with the telemetry node.
   3. Edit each JSON file
      1. Replace IP_ADDRESS with the IP address or FQDN of the telemetry node
      2. Replace HOST_NAME with the hostname of the telemetry node (as per the command "hostname")