84 lines
2.3 KiB
Markdown
84 lines
2.3 KiB
Markdown
# bcache Input Plugin
|
|
|
|
Get bcache stat from stats_total directory and dirty_data file.
|
|
|
|
## Metrics
|
|
|
|
Meta:
|
|
|
|
- tags: `backing_dev=dev bcache_dev=dev`
|
|
|
|
Measurement names:
|
|
|
|
- dirty_data
|
|
- bypassed
|
|
- cache_bypass_hits
|
|
- cache_bypass_misses
|
|
- cache_hit_ratio
|
|
- cache_hits
|
|
- cache_miss_collisions
|
|
- cache_misses
|
|
- cache_readaheads
|
|
|
|
## Description
|
|
|
|
```text
|
|
dirty_data
|
|
Amount of dirty data for this backing device in the cache. Continuously
|
|
updated unlike the cache set's version, but may be slightly off.
|
|
|
|
bypassed
|
|
Amount of IO (both reads and writes) that has bypassed the cache
|
|
|
|
|
|
cache_bypass_hits
|
|
cache_bypass_misses
|
|
Hits and misses for IO that is intended to skip the cache are still counted,
|
|
but broken out here.
|
|
|
|
cache_hits
|
|
cache_misses
|
|
cache_hit_ratio
|
|
Hits and misses are counted per individual IO as bcache sees them; a
|
|
partial hit is counted as a miss.
|
|
|
|
cache_miss_collisions
|
|
Counts instances where data was going to be inserted into the cache from a
|
|
cache miss, but raced with a write and data was already present (usually 0
|
|
since the synchronization for cache misses was rewritten)
|
|
|
|
cache_readaheads
|
|
Count of times readahead occurred.
|
|
```
|
|
|
|
## 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][CONFIGURATION.md] for more details.
|
|
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
|
|
|
## Configuration
|
|
|
|
```toml @sample.conf
|
|
# Read metrics of bcache from stats_total and dirty_data
|
|
# This plugin ONLY supports Linux
|
|
[[inputs.bcache]]
|
|
## Bcache sets path
|
|
## If not specified, then default is:
|
|
bcachePath = "/sys/fs/bcache"
|
|
|
|
## By default, Telegraf gather stats for all bcache devices
|
|
## Setting devices will restrict the stats to the specified
|
|
## bcache devices.
|
|
bcacheDevs = ["bcache0"]
|
|
```
|
|
|
|
## Example Output
|
|
|
|
```text
|
|
bcache,backing_dev="md10",bcache_dev="bcache0" dirty_data=11639194i,bypassed=5167704440832i,cache_bypass_hits=146270986i,cache_bypass_misses=0i,cache_hit_ratio=90i,cache_hits=511941651i,cache_miss_collisions=157678i,cache_misses=50647396i,cache_readaheads=0i
|
|
```
|