README.md in fluent-plugin-calyptia-monitoring-0.1.0.rc9 vs README.md in fluent-plugin-calyptia-monitoring-0.1.0
- old
+ new
@@ -38,14 +38,15 @@
### Configuration
|parameter|type|description|default|
|---|---|---|---|
-|endpoint|string (optional)|The endpoint for Monitoring API HTTP request, e.g. http://example.com/api|`TBD`|
+|endpoint|string (optional)|The endpoint for Monitoring API HTTP request, e.g. http://example.com/api|`"https://cloud-api.calyptia.com"`|
|api_key|string (required)|The API KEY for Monitoring API HTTP request||
|rate|time (optional)|Emit monitoring values interval. (minimum interval is 30 seconds.)|`30`|
|pending_metrics_size|size (optional)|Setup pending metrics capacity size|`100`|
+|fluentd_conf_path|string (optional)|Specify Fluentd config file path for RPC not to be available case|`nil`|
### Example
This plugin works well with [cmetrics Fluentd extension for metrics plugin](https://github.com/calyptia/fluent-plugin-metrics-cmetrics).
@@ -82,10 +83,48 @@
path /path/to/agent/accessible/directories/agent_states
</storage>
</source>
```
+And also retrieving configuration from actual file is also supported:
+
+```aconf
+<system>
+# If users want to use multi workers feature which corresponds to logical number of CPUs, please comment out this line.
+# workers "#{require 'etc'; Etc.nprocessors}"
+ enable_input_metrics true
+ # This record size measuring settings might impact for performance.
+ # Please be careful for high loaded environment to turn on.
+ enable_size_metrics true
+ <metrics>
+ @type cmetrics
+ </metrics>
+</system>
+# And other configurations....
+
+## Fill YOUR_API_KEY with your Calyptia API KEY
+<source>
+ @type calyptia_monitoring
+ @id input_caplyptia_moniroting
+ <cloud_monitoring>
+ # endpoint http://development-environment-or-production.fqdn:5000
+ api_key YOUR_API_KEY
+ rate 30
+ pending_metrics_size 100 # Specify capacity for pending metrics
+ fluentd_conf_path /path/to/fluent.conf
+ </cloud_monitoring>
+ <storage>
+ @type local
+ path /path/to/agent/accessible/directories/agent_states
+ </storage>
+</source>
+```
+
+**Note:** We recommend to use RPC version due to some circumstances should differ between a loaded configuration and a saved Fluentd configuration.
+This is because calling dumping config RPC feature can obtain from configuration contents which are loaded on memory. But retrieving configuration from the specified file is just read from the file contents and it cannot handle/retrieve loaded configurations on Fluentd.
+When users just update their Fluentd configurations and forgot to restart/reload their Fluentd instances, loaded configurations differ from just edited ones.
+
## Calyptia Monitoring API config generator
Usage:
```
@@ -102,12 +141,14 @@
--disable-input-metrics Disable Input plugin metrics. Input metrics is enabled by default
--enable-size-metrics Enable event size metrics. Size metrics is disabled by default.
--disable-get-dump Disable RPC getDump procedure. getDump is enabled by default.
--storage-agent-token-dir DIR
Specify accesible storage token dir. (default: /path/to/accesible/dir)
+ --fluentd-conf-path PATH Specify fluentd configuration file path. (default: nil)
```
## Copyright
-* Copyright(c) 2021- Hiroshi Hatake
+* Copyright(c) 2021- Calyptia Inc.
+* Maintainer: Hiroshi Hatake <hatake@calyptia.com>
* License
* Apache License, Version 2.0