news: added the news file

Signed-off-by: Hofi <hofione@gmail.com>

Author: HofiOne

news/feature-5259.md

@@ -0,0 +1,32 @@
+`prometheus-stats`: Added two new sources `prometheus-stats()` and `prometheus-stats-dont-log()` which can serve output of the `syslog-ng-ctl stats` and `syslog-ng-ctl query` commands directly to a prometheus scraper. The only difference between the two is that the latter drops the log messages of the incoming scraper requests (so, an attached destination will not recieve any messages in the log path from the given `prometheus-stats-dont-log()` source). The  `prometheus-stats()` source will produce log messages unparsed and store the incoming scraper HTTP requests in the `MSG` field of the log message.
+
+You can set it up like:
+
+``` config
+@version: 4.9
+@include "scl.conf"
+
+source s_prometheus_stat {
+    prometheus-stats-dont-log(
+        ip("0.0.0.0")
+        port(8080)
+        stat-type("query")
+        stat-query("*")
+        scrape-freq-limit(30)
+        single-instance(yes)
+    );
+};
+
+log {
+    source(s_prometheus_stat);
+};
+```
+
+NOTE: Please see that you do not need a destination to get this work, `prometheus-stats()` source will responde to the scraper regardless of the presence of a destination in the log path.
+
+Options can be used:
+
+`stat-type(string)` - `query` or `stats`
+`stat-query(string)` -
+`scrape-freq-limit(none-negative-int)` -
+`single-instance(yes/no)` -