StatsD Metrics Monitoring

The Site24x7-StatsD integration is a metrics aggregation service bundled with the Site24x7 server monitoring agent. The agent gets your custom application metrics and pushes it into Site24x7 through the StatsD protocol.

• How it works
• Prerequisites
• Integrate StatsD
• Performance metrics
• Set thresholds
• Edit monitor details
• Custom dashboard
• Licensing

How it Works

The Site24x7 server monitoring agent acts as a listener to collect and aggregate metrics for a specified time interval from a custom application in the user environment. The metrics are sent through UDP to the Site24x7 server monitoring agent. The metrics will be pushed to the UDP port in the following format:

metric_name:metric_value|metric_type|@rate*|#tag-key:tag-value 

Users can then view performance trends, set thresholds, and receive alerts in the Site24x7 web client. Since this is based on UDP, your application can send metrics without waiting for a response from Site24x7 and ensure continued functioning even if Site24x7 becomes unavailable. 

Prerequisites

• Ensure the server monitoring agent is enabled to bind with the UDP port to collect StatsD metrics. In the Integrate StatsD page (Metrics > StatsD > All Metrics (+)), select the server(s) from the drop-down and click on Enable StatsD.
• Ensure the Enable Statsd Metrics is set to Yes under Admin > Server Monitor > Settings. This setting can be performed only by a Site24x7 Super Admin and will be applied across the entire Site24x7 account. 
• Ensure the Linux monitoring agent version is 17.7.0 and above.

Integrate StatsD

By default, the agent will be listening on the UDP port 8125. To change the port, edit the statsd.cfg file in the '/opt/site24x7/monagent/metrics/statsd/' path in your server.

1. Log in to Site24x7 and go to Metrics > StatsD > All Metrics (+).
   Note

   If you don't find the Metrics tab, click on Edit in the Dock and add it as a new Dock icon.

2. Click on Copy to Clipboard and execute the command given in the Site24x7 web client to install the server monitoring agent and monitor metrics pushed through the StatsD protocol.
   
   Note

   Ensure the device key is entered correctly for successful authentication and agent installation.

3. If you have proxy, toggle Yes and choose to install the agent as root or non root and run the installed agent as root or non root. For example, to install the agent with proxy as a root user and run as non root, execute the following command:
   

   wget https://staticdownloads.site24x7.com/server/Site24x7InstallScript.sh
   bash Site24x7InstallScript.sh -i -key=<device key> -proxy=user:password@proxyhost:proxyport -s24x7-agent

In the next data collection, the agent will start pushing the metrics to Site24x7. Go to Metrics > StatsD > All Metrics to view them and add thresholds. 

Performance Metrics

Timer, counter, gauge, and set metrics can be monitored using the Site24x7-StatsD integration. All metrics pushed through the StatsD protocol to Site24x7 can be seen under Metrics > StatsD > All Metrics. You can search for them based on their name, tags, or type. 

Click on a metric to view the Performance Report for that particular attribute or multiple attributes.

Set Thresholds

You can set thresholds for each metric pushed to Site24x7 and get alerts when they breach the configured threshold value. To set threshold for a particular metric,

1. In the Site24x7 web client, go to Metrics > StatsD > All Metrics.   
2. Click on the pencil icon under Action beside the metric that you want to set threshold.
3. Enter the Threshold value, and set the appropriate Condition (<, <=, >, >=, =), the Poll Strategy, and the type of alert that you wish to receive (Trouble or Critical). You can also associate Automations to automatically remediate the issue when there is a breach.
4. Save your changes.

Edit Monitor Details

You can edit your notification and user group preferences in the Edit Monitor Details page.

1. Go to Server > StatsD Integration > hover on the hamburger icon beside the monitor name. Click Edit.
2. In the Edit Monitor Details page, you can select your Notification Profiles, User Alert Groups, and associate Third-Party Integrations.
3. Save your changes.

Custom Dashboard

You can create your own dashboard and view all the metrics in a single dashboard using custom dashboards. Once the agent is successfully integrated, a default dashboard will be listed under Metrics > StatsD > Statsdmetrics - Default Dashboard. To create a new one, 

1. In the Site24x7 web client, go to Metrics > StatsD > All Metrics.
2. Select the metrics that you wish to add to the dashboard.
3. Click on Build Custom Dashboard.
4. Provide a Display Name and Save your changes.     

This would open the dashboard in a new tab. You can add/remove metrics using the Edit Dashboard option and Share This dashboard as a PDF or permalink. 

Licensing

Upto 500 metrics without threshold checks can be availed for free. Beyond that, 25 metrics (with or without threshold checks) will be considered as one basic monitor. 

For example,

500 metrics without threshold checks      = free

500 metrics with 100 threshold checks     = 4 basic monitors

1000 metrics with 500 threshold checks   = 40 basic monitors