diff --git a/doc/_admin-guide/060_Sources/153_stats_exporter/000_stats_exporter_source_options.md b/doc/_admin-guide/060_Sources/153_stats_exporter/000_stats_exporter_source_options.md index a981ff9..a5b969f 100644 --- a/doc/_admin-guide/060_Sources/153_stats_exporter/000_stats_exporter_source_options.md +++ b/doc/_admin-guide/060_Sources/153_stats_exporter/000_stats_exporter_source_options.md @@ -2,12 +2,12 @@ title: stats-exporter() source options id: adm-src--stats-exporter-opt description: >- - The stats-exporter() sources directly can serve the output of syslog-ng-ctl stats and syslog-ng-ctl query to a HTTP Scraper. Unlike the stats-exporter-dont-log() that suppresses log messages from incoming scraper requests, the stats-exporter() logs the unparsed messages, storing incoming scraper HTTP requests in the MSG field. + The stats-exporter() sources directly can serve the output of syslog-ng-ctl stats and syslog-ng-ctl query to an HTTP Scraper. Unlike the stats-exporter-dont-log() that suppresses log messages from incoming scraper requests, the stats-exporter() logs the unparsed messages, storing incoming scraper HTTP requests in the MSG field. --- -Technically, both sources are specialized versions of the network() source. See the network() source options for details. +Technically, both sources are specialized versions of the network() source. For more options and details, see the network() source options. ->**NOTE:** A destination is not required for this source to work; the `stats-exporter()` sources will respond to the scraper regardless of whether a destination is present in the log path. +>**NOTE:** A destination is not required for this source to work; the stats-exporter() sources will respond to the scraper regardless of whether a destination is present in the log path. {: .notice--info} These drivers have the following additional options: @@ -17,43 +17,43 @@ These drivers have the following additional options: |Accepted values:| query \| stats | |Default: | stats | -*Description:* The stat type you wish to provide in the response to a HTTP Scraper request, just like for the syslog-ng-ctl command line tool. +*Description:* This option sets the desired stat type to be produced in response to an HTTP Scraper request. This method operates like the syslog-ng-ctl command line tool. ## stat-query() |Accepted values:| regular expression | |Default: | | -*Description:* The query regex string that can be used to filter the output of a `query` type request. +*Description:* This option sets the query regex string which can be used to filter the output of a query type request. ## stat-format() |Accepted values:| csv \| kv \| prometheus | |Default: | prometheus | -*Description:* Specifies the format of the statistics output in HTTP responses, similar to the options available in syslog-ng-ctl. The available formats are: +*Description:* This option specifies the format of the statistics output in HTTP responses, similar to the options available in syslog-ng-ctl. The available formats are the following: -- csv – comma-separated values format -- kv – key-value pairs, one per line -- prometheus – Prometheus-compatible exposition format +- `csv` – comma-separated values format +- `kv` – key-value pairs, one per line +- `prometheus` – Prometheus-compatible exposition format ## scrape-pattern() |Accepted values:| regular expression | -|Default: | GET /metrics* | +|Default: | `GET /metrics*` | -*Description:* The pattern used to match the HTTP header of incoming scraping requests. A stat response will be generated and sent only if the header matches the scrape-pattern(). +*Description:* This option sets the pattern used to match the HTTP header of incoming scraping requests. A stat response will be generated and sent only if the header matches the one set in the `scrape-pattern()` option. ## scrape-freq-limit() |Accepted values:| number | -|Default: | 0 | +|Default: | `0` | -*Description:* Limits the frequency of repeated scraper requests to the specified number of seconds. Any repeated request within this period will be ignored. A value of 0 means no limit. +*Description:* This option limits the frequency of repeated scraper requests to the specified number of seconds. Any repeated request within this period will be ignored. A set value of `0` means no limit. ## single-instance() |Accepted values:| yes \| no | |Default: | no | -*Description:* If set to `yes` only one scraper connection and request will be allowed at once. +*Description:* If this option is set to `yes`, only one scraper connection and request will be allowed at once. \ No newline at end of file diff --git a/doc/_admin-guide/060_Sources/153_stats_exporter/README.md b/doc/_admin-guide/060_Sources/153_stats_exporter/README.md index e7e8086..484a7a3 100644 --- a/doc/_admin-guide/060_Sources/153_stats_exporter/README.md +++ b/doc/_admin-guide/060_Sources/153_stats_exporter/README.md @@ -30,7 +30,7 @@ log { }; ``` -Example usage for a generic HTTP Scraper which sends e.g. the `GET /stats HTTP/1.1` HTTP request to get statistics of {{ site.product.short_name }}, do not want to log or further process the HTTP requests in the log pipe, and needs the response in CSV format: +Example usage for a generic HTTP Scraper which sends the `GET /stats HTTP/1.1` HTTP request to get statistics of a {{ site.product.short_name }} system, which is not required to log or further process the HTTP requests in the log pipe, and needs the response in CSV format: ``` config @version: 4.9 @@ -53,5 +53,5 @@ log { }; ``` ->**NOTE:** A destination is not required for this to work; the `stats-exporter()` sources will respond to the scraper regardless of whether a destination is present in the log path. +>**NOTE:** A destination is not required for this to work. The stats-exporter() sources will respond to the scraper regardless of whether a destination is present in the log path or not. {: .notice--info}