The following components are deployed on each TWC/Cassandra node:

• Telegraf - system metrics collector
• Dropwizard metrics-graphite-3.1.2.jar - metrics publishing agent for Java

Install Telegraf

1. Install Telegraf in the TWCloud/Cassandra node
   
   1. If you have not created the influxdb.repo as in step 1a of the Monitoring Mode, do so at this time.

   2. Install with the command

      Code Block
      language text
      sudo yum install telegraf

   3. Edit /etc/telegraf/telegraf.conf as follows
      1. Locate the section titled "[[outputs.influxdb]]"

      2. Edit the line with the urls = tag as follows:

         Code Block
         language text
         urls = ["http://monitoringnode_ip:8086"] where monitoringnode_ip is the IP address of the node where infuxdb is installed (if it is located on the same machine, you may use 127.0.0.1).

   4. Enable the telegraf service on startup 

      Code Block
      language text
      sudo systemctl enable telegraf

   5. Start the Telegraf service 

      Code Block
      language text
      sudo systemctl start telegraf

2. Restart the Teamwork Cloud service

   Code Block
   sudo service twcloud-svc restart

3. Modify Cassandra to allow remote monitoring
   1. Download metrics-graphite-3.1.2.jar from http://central.maven.org/maven2/io/dropwizard/metrics/metrics-graphite/3.1.2/metrics-graphite-3.1.2.jar

   2. Change permissions to allow execution

      Code Block
      language text
      sudo chmod 755 metrics-graphite-3.1.2.jar

   3. Copy metrics-graphite-3.1.2.jar to /usr/share/cassandra/lib/

   4. Edit /etc/cassandra/default.conf/cassandra-env.sh, adding the following at the bottom:

      Code Block
      language text
      # Enable metrics reporting to InfluxDB using the yammer library METRICS_REPORTER_CFG="metrics-reporter-graphite.yaml" JVM_OPTS="$JVM_OPTS -Dcassandra.metricsReporterConfigFile=$METRICS_REPORTER_CFG"

   5. Create fie /etc/cassandra/default.conf/metrics-reporter-graphite.yaml with the following content:

      Code Block
      language text
      graphite:   -     period: 30     timeunit: 'SECONDS'     prefix: 'HOST_NAME'     hosts:      - host: 'IP_ADDRESS'        port: 2003     predicate:       color: 'white'       useQualifiedName: true       patterns:         - '^org.apache.cassandra.+'         - '^jvm.+'

      1. Replacing HOST_NAME with the Cassandra node's host name, and IP_ADDRESS with the IP address of the monitoring node (where influxdb is installed)

   6. Restart Cassandra

      Code Block
      language text
      sudo service cassandra restart

      
      Configure Grafana

4. Configuring Grafana monitoring dashboard  
   1. Log into http://MONTORINGNODE_IP:3000 - you will be displayed the Grafana Login Screen - default credentials are admin/admin.  Upon logging in, you will be prompted to change the admin password.
   2. You will be presented with the following screen, click Add data source: 
      

   3. Create the data sources, entering the information as in the following screenshots, and pressing Save & Test for each.  After the data source gets created, click the Data Sources link to continue adding data sources. 

      

      

      

      

      

      
      

   4. Now that the data sources have been added, select the option to import a dashboard
       
   5. To upload .json file, click the Upload .json File 
      
      1. Select the provided Teamwork_Cloud_Dashboard.json. 
   6. At this point, you will be presented with the following screen, in which you will need to map the data sources 
      
   7. Map the data sources as shown below and click the Import button 
      
   8. To make the Teamwork Cloud dashboard your home dashboard, perform the following steps:
      1. Mark the Teamwork Cloud Dashboard as a favorite
         
      2.  Select Configuration > Preferences
          
      3. Select the Teamwork Cloud Dashboard to be your Home Dashboard and click Save.
          
      4. The admin user has permissions allowing full access.  Create a limited access user which will be allowed of viewing the dashboard without the ability of making modifications. Click Users.
         
      5. You will be presented with the following screen.  Click Invite 
         
      6. Create a guest user by entering the information as below, and clicking Invite
          
      7. You will be shown a screen as below.  Click the Pending Invites button 
         
      8. Click the Copy Invite button 
         
      9. Paste the link which was copied to your clipboard on a new browser window, and replace "localhost" with the IP address of the monitoring node.  You will be presented with the following screen. Change the email field from "guest" to "guest@localhost", enter a password and click on the Sign Up button. 
         
         At this point, you will be redirected to the Grafana dashboard under the new login. Sign out, and sign back in as admin.
          
      10. At this point, change the default admin password.