Telemetry Node

Downloads

Download the twc-scripts-<version>-linux-monitoring-stack.zip here.

 The following components are deployed on each Teamwork Cloud/Cassandra node:

• Telegraf - system metrics collector
• jolokia-agent-jvm, version 2.3.0 - a metrics publishing agent for Java

Installing Telegraf

To install and configure Telegraf

1. Install Telegraf
   1. Create yum repo entry, if needed. Refer to Step 1a from Monitoring node installation.
   2. Install with the command:
      

      sudo yum install -y telegraf

      BASH
2. Use a custom configuration file:
   1. Locate /etc/telegraf/telegraf.conf. Make a note of the file ownership and permission.
   2. Locate telegraf.conf.template from the extracted Telemetry-Node-Install folder and replace the existing file in /etc/telegraf/telegraf.conf; be sure to reset ownership and permission after replacement.
   3. Edit telegraf.conf and replace HOST_NAME with the monitoring node address.
3. Enable the Telegraf service for startup with the command:
   

   sudo systemctl enable telegraf

   BASH
4. Start Telegraf:
   

   sudo systemctl start telegraf

   SHELL
5. Proceed with installing Jolokia for Cassandra on nodes with Cassandra, and Jolokia for Teamwork Cloud on nodes with Teamwork Cloud.

Installing Jolokia

Nodes with Teamwork Cloud

To install Jolokia

1. Run the following:
   

   wget -c https://repo1.maven.org/maven2/org/jolokia/jolokia-agent-jvm/2.3.0/jolokia-agent-jvm-2.3.0-javaagent.jar
   cp ./jolokia-agent-jvm-2.3.0-javaagent.jar /opt/local/CATIANoMagicServices/TeamworkCloud/lib/

   TEXT
2. Backup JVM.options in /opt/local/CATIANoMagicServices/TeamworkCloud/
3. Append the following at the end of jvm.options:
   

   -javaagent:/opt/local/CATIANoMagicServices/TeamworkCloud/lib/jolokia-agent-jvm-2.3.0-javaagent.jar=port=8779,host=127.0.0.1,protocol=http

   TEXT
4. Restart twcloud:
   

   systemctl restart twcloud

   SHELL

Nodes with Cassandra

To install Jolokia

1. Run  the following:
   

   wget -c https://repo1.maven.org/maven2/org/jolokia/jolokia-agent-jvm/2.3.0/jolokia-agent-jvm-2.3.0-javaagent.jar
   cp ./jolokia-agent-jvm-2.3.0-javaagent.jar /usr/share/cassandra/lib/
   

   TEXT
2. Backup jvm17-server.options in /etc/cassandra/default.conf/
3. Append the following at the end of jvm17-server.options:
   

   -javaagent:/usr/share/cassandra/lib/jolokia-agent-jvm-2.3.0-javaagent.jar=port=8778,host=127.0.0.1,protocol=http

   TEXT
4. Backup jvm11-server.options in /etc/cassandra/default.conf/
5. Append the following at the end of jvm11-server.options:
   

   -javaagent:/usr/share/cassandra/lib/jolokia-agent-jvm-2.3.0-javaagent.jar=port=8778,host=127.0.0.1,protocol=http

   TEXT
6. Reboot Cassandra:
   

   systemctl restart cassandra

   SHELL
7. Continue to configure Grafana.

Ports

The following are the default ports used by services running on the telemetry node. These ports are only for internal communication between Telegraf and Cassandra/Teamwork Cloud and therefore are blocked by the local firewall operating on the system.