Supported OS:
Track overall and per-pool stats on each of your twemproxy servers. This Agent check collects metrics for client and server connections and errors, request and response rates, bytes in and out of the proxy, and more.
The Agent’s Twemproxy check is included in the Datadog Agent package, so you don’t need to install anything else on your Twemproxy servers.
Follow the instructions below to configure this check for an Agent running on a host. For containerized environments, see the Containerized section.
Edit the twemproxy.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample twemproxy.d/conf.yaml for all available configuration options:
init_config:
instances:
- host: localhost
port: 22222 # change if your twemproxy doesn't use the default stats monitoring port
Restart the Agent to begin sending twemproxy metrics to Datadog.
For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.
| Parameter | Value |
|---|---|
<INTEGRATION_NAME> | twemproxy |
<INIT_CONFIG> | blank or {} |
<INSTANCE_CONFIG> | {"host": "%%host%%", "port":"22222"} |
Run the Agent’s status subcommand and look for twemproxy under the Checks section.
| twemproxy.curr_connections (gauge) | number of current connections Shown as connection |
| twemproxy.total_connections (gauge) | rate of new connections Shown as connection |
| twemproxy.client_eof (gauge) | number of eof on client connections Shown as error |
| twemproxy.client_err (gauge) | number of errors on client connections Shown as error |
| twemproxy.client_connections (gauge) | number of active client connections Shown as connection |
| twemproxy.server_ejects (gauge) | number of times backend server was ejected Shown as event |
| twemproxy.forward_error (gauge) | number of times we encountered a forwarding error Shown as error |
| twemproxy.fragments (gauge) | number of fragments created from a multi-vector request Shown as request |
| twemproxy.in_queue (gauge) | number of requests in incoming queue Shown as request |
| twemproxy.out_queue (gauge) | number of requests in outgoing queue Shown as request |
| twemproxy.in_queue_bytes (gauge) | current request bytes in incoming queue Shown as byte |
| twemproxy.out_queue_bytes (gauge) | current request bytes in outgoing queue Shown as byte |
| twemproxy.server_connections (gauge) | number of active server connections Shown as connection |
| twemproxy.server_err (gauge) | number of errors on server connections Shown as error |
| twemproxy.server_timedout (gauge) | number of timeouts on server connections Shown as timeout |
| twemproxy.server_eof (gauge) | number of eof on server connections Shown as error |
| twemproxy.responses (gauge) | number of responses Shown as response |
| twemproxy.requests (gauge) | number of requests Shown as request |
| twemproxy.response_bytes (gauge) | number of responses Shown as byte |
| twemproxy.request_bytes (gauge) | number of requests Shown as byte |
The Twemproxy check does not include any events.
twemproxy.can_connect:
Returns CRITICAL if the Agent cannot connect to the Twemproxy stats endpoint to collect metrics, otherwise OK.
Need help? Contact Datadog support.
Mistake in the docs? Feel free to contribute!