Page History

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:

      Code Block
      language bash theme DJango linenumbers true
      [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:
      

      Code Block
      language bash theme DJango linenumbers true
      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:
      

      Code Block
      language bash theme DJango linenumbers true
      sudo systemctl enable influxdb

   2. Start InfluxDB with the command:
      

      Code Block
      language bash theme DJango linenumbers true
      sudo systemctl start influxdb

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

   Code Block
   language bash theme DJango linenumbers true
   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):

   Code Block
   language bash theme DJango linenumbers true
   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:

      Code Block
      language bash theme DJango linenumbers true
      sudo systemctl enable grafana-server

   2. Start Grafana with the command:

      Code Block
      language bash theme DJango linenumbers true
      sudo systemctl start grafana-server

Installing and configuring Jmxtrans

To install Jmxtrans on the monitoring node

1. Install with the command:

   Code Block
   language bash theme DJango linenumbers true
   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:

   Code Block
   language bash theme DJango linenumbers true
   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")