You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pipeline/filters/nest.md
+23-31Lines changed: 23 additions & 31 deletions
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,9 @@
1
1
# Nest
2
2
3
-
The _Nest Filter_ plugin lets you operate on or with nested data. Its modes of operation are:
3
+
The _Nest_ filter plugin lets you operate on or with nested data. Its modes of operation are:
4
4
5
-
-`nest` - Take a set of records and place them in a map.
6
-
-`lift`- Take a map by key and lift its records up.
5
+
-`nest`: Take a set of records and place them in a map.
6
+
-`lift` Take a map by key and lift its records up.
7
7
8
8
## Example usage for `nest`
9
9
@@ -59,7 +59,7 @@ Output:
59
59
}
60
60
```
61
61
62
-
## Configuration Parameters
62
+
## Configuration parameters
63
63
64
64
The plugin supports the following configuration parameters:
65
65
@@ -69,26 +69,22 @@ The plugin supports the following configuration parameters:
69
69
|`Wildcard`| FIELD WILDCARD |`nest`| Nest records which field matches the wildcard |
70
70
|`Nest_under`| FIELD STRING |`nest`| Nest records matching the `Wildcard` under this key |
71
71
|`Nested_under`| FIELD STRING |`lift`| Lift records nested under the `Nested_under` key |
72
-
|`Add_prefix`| FIELD STRING |ANY| Prefix affected keys with this string |
73
-
|`Remove_prefix`| FIELD STRING |ANY| Remove prefix from affected keys if it matches this string |
72
+
|`Add_prefix`| FIELD STRING |Any| Prefix affected keys with this string |
73
+
|`Remove_prefix`| FIELD STRING |Any| Remove prefix from affected keys if it matches this string |
74
74
75
-
## Getting Started
75
+
## Get started
76
76
77
-
To start filtering records, run the filter from the command line or through the
78
-
configuration file. The following example invokes the
79
-
[Memory Usage Input Plugin](../inputs/memory-metrics.md), which outputs the
80
-
following:
77
+
To start filtering records, run the filter from the command line or through the configuration file. The following example invokes the [Memory Usage input plugin](../inputs/memory-metrics.md), which outputs the following:
This example nests all `Mem.*` and `Swap.*` items under the `Stats` key and then
160
-
reverses these actions with a `lift` operation. The output appears unchanged.
155
+
This example nests all `Mem.*` and `Swap.*` items under the `Stats` key and then reverses these actions with a `lift` operation. The output appears unchanged.
161
156
162
-
### Example 2 Configuration File
157
+
### `nest` and `lift` undo configuration file
163
158
164
159
{% tabs %}
165
160
{% tab title="fluent-bit.conf" %}
@@ -220,19 +215,19 @@ pipeline:
220
215
{% endtab %}
221
216
{% endtabs %}
222
217
223
-
### Result
218
+
### `nest` and `lift` undo result
224
219
225
220
```text
226
221
[2018/06/21 17:42:37] [ info] [engine] started (pid=17285)
## Example 4 - multiple nest and lift filters with prefix
320
+
## Example 4 - multiple `nest` and `lift` filters with prefix
326
321
327
-
This example uses the 3-level deep nesting of _Example 2_ and applies the
328
-
`lift`filter three times to reverse the operations. The end result is that all
329
-
records are at the top level, without nesting, again. One prefix is added for each
330
-
level that's lifted.
322
+
This example uses the 3-level deep nesting of Example 2 and applies the `lift` filter three times to reverse the operations. The end result is that all records are at the top level, without nesting, again. One prefix is added for each level that's lifted.
0 commit comments