tinyproxy-datadog-metrics

This repo contains a Datadog agent check to monitor Tinyproxy. The check will publish one service check to Datadog, called tinyproxy. It also records a handful of custom metrics about what the Tinyproxy process is doing.

Installation

1. Configure Tinyproxy to report stats (assuming Tinyproxy is already installed):
   1. Copy stats.json to /usr/share/tinyproxy.
   2. In /etc/tinyproxy.conf, update the StatFile directive to point to /usr/share/tinyproxy/stats.json. Also make a note of the StatHost directive, if it's been changed from the default of tinyproxy.stats.
2. Configure the Datadog Agent to collect stats (assuming the agent is already installed):
   1. Copy tinyproxy.py to /etc/datadog-agent/checks.d/.
   2. Copy tinyproxy.yaml to /etc/datadog-agent/conf.d/.
   3. If you want to monitor a Tinyproxy instance other than localhost:8888, change the instance settings in the YAML file. Likewise, if Tinyproxy's StatHost doesn't match the default, you should change that here.
   4. Restart the datadog-agent service.

List of custom metrics published

• tinyproxy.response_time: gauge, response time of the stats request, in seconds.
• tinyproxy.opens: gauge, number of open connections.
• tinyproxy.reqs: monotonic counter, number of requests processed.
• tinyproxy.badconns: monotonic counter, number of bad connections.
• tinyproxy.deniedconns: monotonic counter, number of denied connections.
• tinyproxy.refusedconns: monotonic counter, number of refused connections.

All monotonic counters reset when the tinyproxy process restarts.