docs-v2/content/telegraf/v1/input-plugins/raindrops/_index.md

74 lines
2.5 KiB
Markdown

---
description: "Telegraf plugin for collecting metrics from Raindrops Middleware"
menu:
telegraf_v1_ref:
parent: input_plugins_reference
name: Raindrops Middleware
identifier: input-raindrops
tags: [Raindrops Middleware, "input-plugins", "configuration", "server"]
introduced: "v0.10.3"
os_support: "freebsd, linux, macos, solaris, windows"
related:
- /telegraf/v1/configure_plugins/
- https://github.com/influxdata/telegraf/tree/v1.36.1/plugins/inputs/raindrops/README.md, Raindrops Middleware Plugin Source
---
# Raindrops Middleware Input Plugin
This plugin collects statistics for [Raindrops middleware](http://raindrops.bogomips.org/Raindrops/Middleware.html) instances.
**Introduced in:** Telegraf v0.10.3
**Tags:** server
**OS support:** all
[raindrops]: http://raindrops.bogomips.org/Raindrops/Middleware.html
## Global configuration options <!-- @/docs/includes/plugin_config.md -->
In addition to the plugin-specific configuration settings, plugins support
additional global and plugin configuration settings. These settings are used to
modify metrics, tags, and field or create aliases and configure ordering, etc.
See the [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
## Configuration
```toml @sample.conf
# Read raindrops stats (raindrops - real-time stats for preforking Rack servers)
[[inputs.raindrops]]
## An array of raindrops middleware URI to gather stats.
urls = ["http://localhost:8080/_raindrops"]
```
## Metrics
- raindrops
- tags:
- server
- port
- fields:
- calling (integer, count)
- writing (integer, count)
- raindrops_listen
- tags:
- ip (IP only)
- port (IP only)
- socket (unix socket only)
- fields:
- active (integer, bytes)
- queued (integer, bytes)
## Example Output
```text
raindrops,port=8080,server=localhost calling=0i,writing=0i 1455479896806238204
raindrops_listen,ip=0.0.0.0,port=8080 active=0i,queued=0i 1455479896806561938
raindrops_listen,ip=0.0.0.0,port=8081 active=1i,queued=0i 1455479896806605749
raindrops_listen,ip=127.0.0.1,port=8082 active=0i,queued=0i 1455479896806646315
raindrops_listen,ip=0.0.0.0,port=8083 active=0i,queued=0i 1455479896806683252
raindrops_listen,ip=0.0.0.0,port=8084 active=0i,queued=0i 1455479896806712025
raindrops_listen,ip=0.0.0.0,port=3000 active=0i,queued=0i 1455479896806779197
raindrops_listen,socket=/tmp/listen.me active=0i,queued=0i 1455479896806813907
```