Skip to content

Commit 1e168e5

Browse files
authored
Update README.md
1 parent fe00e28 commit 1e168e5

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

README.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Prometheus Folder size Exporter
22

3-
[![legal](https://img.shields.io/github/license/mindflavor/prometheus_folder_size_exporter.svg)](LICENSE) [![alpha](https://img.shields.io/badge/stability-alpha-yellow.svg)](https://img.shields.io/badge/stability-alpha-yellow.svg)
3+
[![legal](https://img.shields.io/github/license/mindflavor/prometheus_folder_size_exporter.svg)](LICENSE)
4+
![Rust](https://github.com/MindFlavor/prometheus_folder_size_exporter/workflows/Rust/badge.svg)
45

56
[![Crate](https://img.shields.io/crates/v/prometheus_folder_size_exporter.svg)](https://crates.io/crates/prometheus_folder_size_exporter) [![cratedown](https://img.shields.io/crates/d/prometheus_folder_size_exporter.svg)](https://crates.io/crates/prometheus_folder_size_exporter) [![cratelastdown](https://img.shields.io/crates/dv/prometheus_folder_size_exporter.svg)](https://crates.io/crates/prometheus_folder_size_exporter)
67

7-
[![tag](https://img.shields.io/github/tag/mindflavor/prometheus_folder_size_exporter.svg)](https://github.com/MindFlavor/prometheus_folder_size_exporter/tree/0.1.1)
8-
[![release](https://img.shields.io/github/release/MindFlavor/prometheus_folder_size_exporter.svg)](https://github.com/MindFlavor/prometheus_folder_size_exporter/tree/0.1.1)
9-
[![commitssince](https://img.shields.io/github/commits-since/mindflavor/prometheus_folder_size_exporter/0.1.1.svg)](https://img.shields.io/github/commits-since/mindflavor/prometheus_folder_size_exporter/0.1.1.svg)
8+
[![release](https://img.shields.io/github/release/MindFlavor/prometheus_folder_size_exporter.svg)](https://github.com/MindFlavor/prometheus_folder_size_exporter/releases/tag/0.3.0)
9+
[![commitssince](https://img.shields.io/github/commits-since/mindflavor/prometheus_folder_size_exporter/0.3.0.svg)](https://img.shields.io/github/commits-since/mindflavor/prometheus_folder_size_exporter/0.3.0.svg)
1010

1111
## Intro
1212

@@ -46,7 +46,14 @@ Once started, the tool will listen on the specified port (or the default one, 99
4646

4747
### JSON configuration file
4848

49-
The json is very simple, it's just an array of obejcts with two mandatory fields: `path` and `recursive` and one optional `user`. `path` can be any valid path while `recursive` can be either `true` or `false`. If you specify `true`, the exporter will scan the folder contents recursively effectively giving you the folder tree size. `user` is an optional arbitrary label that will be passed to the output. For an example please refer to [example.json](example.json).
49+
Name | Valid values | Description
50+
-- | -- | --
51+
`path` | Any valid path | The starting analysis path.
52+
`explode_depth` | Any positive number or -1 | This setting controls how deep the folder explosion will go. -1 means no limit. 0 means no explosion.
53+
`sum_remaining_subfolders` | `true` or `false` | This setting specifies if the last exploded folder size should include the subfolders.
54+
55+
So, for example, to monitor a single folder set `explode_depth = 0` and pick `sum_remaining_subfolders` based on is you want the total folder + subfolder size or not.
56+
To monitor a folder and its first level subfolders you specify `explode_depth = 1`.
5057

5158
### Systemd service file
5259

0 commit comments

Comments
 (0)