Field operation functions
Updated at:2025-11-03
Field operation functions
Introduction
Field processing functions, processing fields in logs, including getting values, adding, deleting, modifying, querying, etc.
v function
Function definition
Get the field value and return the corresponding string.
Syntax description
Text
1v(field)
Parameter description
| Parameter name | Parameter description | Parameter type | Required or not | Parameter default | Parameter range |
|---|---|---|---|---|---|
| field | Field name | String | Yes | - | - |
Example
- Example 1
Original log:
Text
1{"message": "failed", "status": "500"}
Processing rules:
Text
1e_set("new_message", v("message"))
Processing results:
Text
1{"message": "failed", "new_message": "failed","status": "500"}
e_set function
Function definition
Used to set field values or add new fields.
Syntax description
Text
1e_set(key1, value1, key2, value2, ... , mode="overwrite")
Parameter description
| Parameter name | Parameter description | Parameter type | Required or not | Parameter default | Parameter range |
|---|---|---|---|---|---|
| key | Target field name | String | Yes | - | - |
| value | New field value | Any | Yes | - | - |
| mode | Field overwriting mode. The default is overwrite | String | No | overwrite | fill/fill-auto/add/add-auto/overwrite/overwrite-auto |
Example
- Example 1
Original log:
Text
1{"level": "Info"}
Processing rules:
Text
1e_set("new_level": "Warning")
Processing results:
Text
1{"level": "Info", "new_level": "Warning"}
- Example 2
Original log:
Text
1{"level": "Info"}
Processing rules:
Text
1e_set("level": "Warning")
Processing results:
Text
1{"level": "Warning"}
- Example 3
Original log:
Text
1{"level": "Info"}
Processing rules:
Text
1e_set("new1": "Warning", "new2": "Debug")
Processing results:
Text
1{"level": "Info", "new1": "Warning", "new2": "Debug"}
e_drop_fields function
Function definition
Match by field name and delete the matched fields.
Syntax description
Text
1e_drop_fields(key1, key2, ... )
Parameter description
| Parameter name | Parameter description | Parameter type | Required or not | Parameter default | Parameter range |
|---|---|---|---|---|---|
| key | Field name | String | Yes | - | - |
Example
- Example 1
Original log:
Text
1{"level": "Info", "status": "500"}
Processing rules:
Text
1e_drop_fields("status")
Processing results:
Text
1{"level": "Info"}
- Example 2
Original log:
Text
1{"level": "Info", "status": "500", "code": 200}
Processing rules:
Text
1e_drop_fields("status", "level")
Processing results:
Text
1{"code": 200}
e_rename function
Function definition
Rename fields.
Syntax description
Text
1e_rename("key1", "new key1", "key2", "new key2", ...)
Parameter description
| Parameter name | Parameter description | Parameter type | Required or not | Parameter default | Parameter range |
|---|---|---|---|---|---|
| key | Field name | String | Yes | - | - |
| new key | Renamed field name | String | Yes | - | - |
Example
- Example 1
Original log:
Text
1{"level": "Info", "status": "500"}
Processing rules:
Text
1e_rename("level", "new_level")
Processing results:
Text
1{"new_level": "Info", "status": "500"}
- Example 2
Original log:
Text
1{"level": "Info", "status": "500"}
Processing rules:
Text
1e_rename("level", "new_level", "status", "new_status")
Processing results:
Text
1{"new_level": "Info", "new_status": "500"}
