Monitoring TwemProxy

This article will help you get the Twemproxy plugin for sd-agent configured and returning metrics

Installing the twemproxy plugin package

Install the twemproxy plugin on Debian/Ubuntu:

sudo apt-get install sd-agent-twemproxy

Install the twemproxy plugin on RHEL/CentOS:

sudo yum install sd-agent-twemproxy

Read more about agent plugins.

Configuring the agent to monitor twemproxy

1. Configure the check in /etc/sd-agent/conf.d/twemproxy.yaml

init_config:

instances:
    - host: localhost
      port: 2222 # change if your twemproxy doesn't use the default stats monitoring port

2. Restart the agent

sudo /etc/init.d/sd-agent restart

or

sudo systemctl restart sd-agent

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 

or

/usr/share/python/sd-agent/agent.py info

If the agent has been configured correctly you'll see an output such as:

twemproxy
-----
  - instance #0 [OK]
  - Collected * metrics

You can also view the metrics returned with the following command:

sudo -u sd-agent /usr/share/python/sd-agent/agent.py check twemproxy

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the twemproxy metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Screen_Shot_2018-01-18_at_11.46.12.png

Monitored metrics

MetricValues
twemproxy.client_connections

number of active client connections
connection / None
Type: float
twemproxy.client_eof

number of eof on client connections
error / None
Type: float
twemproxy.client_err

number of errors on client connections
error / None
Type: float
twemproxy.curr_connections

number of current connections
connection / None
Type: float
twemproxy.forward_error

number of times we encountered a forwarding error
error / None
Type: float
twemproxy.in_queue

number of requests in incoming queue
request / None
Type: float
twemproxy.in_queue_bytes

current request bytes in incoming queue
byte / None
Type: float
twemproxy.out_queue

number of requests in outgoing queue
request / None
Type: float
twemproxy.out_queue_bytes

current request bytes in outgoing queue
byte / None
Type: float
twemproxy.request_bytes

number of requests
byte / None
Type: float
twemproxy.requests

number of requests
request / None
Type: float
twemproxy.response_bytes

number of responses
byte / None
Type: float
twemproxy.responses

number of responses
response / None
Type: float
twemproxy.server_connections

number of active server connections
connection / None
Type: float
twemproxy.server_ejects

number of times backend server was ejected
event / None
Type: float
twemproxy.server_eof

number of eof on server connections
error / None
Type: float
twemproxy.server_err

number of errors on server connections
error / None
Type: float
twemproxy.server_timedout

number of timeouts on server connections
timeout / None
Type: float
twemproxy.total_connections

number of total connections
connection / None
Type: float
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.