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/lookup.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ The plugin supports the following configuration parameters:
9
9
| Key | Description | Default |
10
10
| :-- | :---------- | :------ |
11
11
|`data_source`| Path to the CSV file that the Lookup filter will use as a lookup table. This file must contain one column of keys and one column of values. See [Key Considerations](#key-considerations) for details. |_none_ (required) |
12
-
|`lookup_key`| Specifies the record key whose value to search for in the CSV file's first column. Supports [record accessor](../administration/configuring-fluent-bit/classic-mode/record-accessor) syntax for nested fields and array indexing (for example, `$user['profile']['id']`, `$users[0]['id']`). |_none_ (required) |
12
+
|`lookup_key`| Specifies the record key whose value to search for in the CSV file's first column. Supports [record accessor](../../administration/configuring-fluent-bit/classic-mode/record-accessor.md) syntax for nested fields and array indexing (for example, `$user['profile']['id']`, `$users[0]['id']`). |_none_ (required) |
13
13
|`result_key`| If a CSV entry whose value matches the value of `lookup_key` is found, specifies the name of the new key to add to the output record. This new key uses the corresponding value from the second column of the CSV file in the same row where `lookup_key` was found. If this key already exists in the record, it will be overwritten. |_none_ (required) |
14
14
|`ignore_case`| Specifies whether to ignore case when searching for `lookup_key`. If `true`, searches are case-insensitive. If `false`, searches are case-sensitive. Case normalization applies to both the lookup key from the record and the keys in the CSV file. |`false`|
15
15
|`skip_header_row`| If `true`, the filter skips the first row of the CSV file, treating it as a header. If `false`, the first row is processed as data. |`false`|
@@ -142,7 +142,7 @@ Each metric includes a `name` label to identify the filter instance.
142
142
143
143
## Key considerations
144
144
145
-
- The CSV is used to create an in-memory keyvalue lookup table. Column 1 of the CSV is always used as key, while column 2 is assumed to be the value. All other columns in the CSV are ignored.
145
+
- The CSV is used to create an in-memory key-value lookup table. Column 1 of the CSV is always used as key, while column 2 is assumed to be the value. All other columns in the CSV are ignored.
146
146
- CSV fields can be enclosed in double quotes (`"`). Lines with unmatched quotes are logged as warnings and skipped.
147
147
- Multiline values in CSV file aren't currently supported.
148
148
- Duplicate keys (values in first column) in the CSV will use the last occurrence (hash table behavior)
0 commit comments