Adds filterx dict_to_pairs

Author: Robert Fekete

content/filterx/_index.md

@@ -411,7 +411,8 @@ For details, see {{% xref "/filterx/operator-reference.md" %}}.
 FilterX has the following built-in functions.
 
 - [`cache_json_file`]({{< relref "/filterx/function-reference.md#cache-json-file" >}}): Loads an external JSON file to lookup contextual information.
-- [`dedup_metrics_labels`]({{< relref "/filterx/filterx-metrics/_index.md#metrics-labels" >}}): Deduplicate `metrics_labels` objects.
+- [`dedup_metrics_labels`]({{< relref "/filterx/filterx-metrics/_index.md#dedup-metrics-labels" >}}): Deduplicate `metrics_labels` objects.
+- [`dict_to_pairs`]({{< relref "/filterx/function-reference.md#dict-to-pairs" >}}): Convert dicts to list of pairs.
 - [`dpath`]({{< relref "/filterx/function-reference.md#dpath" >}}): Creates a nested path in a dictionary.
 - [`endswith`]({{< relref "/filterx/filterx-string-search/_index.md" >}}): Checks if a string ends with the specified value.
 - [`flatten`]({{< relref "/filterx/function-reference.md#flatten" >}}): Flattens the nested elements of an object.

content/filterx/function-reference.md

@@ -63,10 +63,32 @@ Usually, you use the [strptime](#strptime) FilterX function to create datetime v
 - When casting from a double, the double is the number of seconds elapsed since the UNIX epoch (00:00:00 UTC on 1 January 1970). (The part before the floating points is the seconds, the part after the floating point is the microseconds.)
 - When casting from a string, the string (for example, `1701350398.123000+01:00`) is interpreted as: `<the number of seconds elapsed since the UNIX epoch>.<microseconds>+<timezone relative to UTC (GMT +00:00)>`
 
-## dedup_metrics_labels
+## dedup_metrics_labels {#dedup-metrics-labels}
 
 Deduplicate `metrics_labels` objects. For details, see {{% xref "/filterx/filterx-metrics/_index.md#metrics-labels" %}}.
 
+## dict_to_pairs {#dict-to-pairs}
+
+Convert dicts to list of pairs.
+
+Usage: `dict_to_pairs(<input-dict>, <key-name>, <value-name>)`
+
+```shell
+my_dict = {
+    "key_1": "value_1",
+    "key_2": "value_2",
+    "key_3": ["value_3", "value_4"],
+};
+
+my_list = dict_to_pairs(my_dict, "key", "value");
+# The value of my_list will be:
+# [
+#   {"key":"key_1","value":"value_1"},
+#   {"key":"key_2","value":"value_2"},
+#   {"key":"key_3","value":["value_3","value_4"]}
+# ]
+```
+
 ## dpath
 
 Available in {{< product >}} 4.17 and later.

content/whats-new/_index.md

@@ -6,6 +6,10 @@ weight: 10
 
 {{< include-headless "banner-new-to-axosyslog.md" >}}
 
+## Version 4.19 (2025-10-15)
+
+- The [`dict_to_pairs`]({{< relref "/filterx/function-reference.md#dict-to-pairs" >}}) FilterX function can convert a dictionary to a list of pairs.
+
 ## Version 4.18 (2025-09-30)
 
 - You can now use macros and templates in the [`headers()` option]({{< relref "/chapter-destinations/configuring-destinations-http-nonjava/reference-destination-http-nonjava/_index.md#headers" >}}) of the `http()` destination to set the headers dynamically.