From 7aff541661682dc6c6fb8c943338d12140e0fbea Mon Sep 17 00:00:00 2001
From: "lei.ch1941" <lei.ch1941@gmail.com>
Date: Wed, 5 Jul 2023 13:59:58 +0800
Subject: [PATCH] Feat: add toStr function in transformer interceptor (#152)

Co-authored-by: Mercurius-lei <lei.ch1941@gmail.com}>
---
 .../pipelines/interceptor/transformer.md        | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/reference/pipelines/interceptor/transformer.md b/docs/reference/pipelines/interceptor/transformer.md
index 6fe7e2a..f62075c 100644
--- a/docs/reference/pipelines/interceptor/transformer.md
+++ b/docs/reference/pipelines/interceptor/transformer.md
@@ -570,6 +570,23 @@ const (
     }
     ```
 
+### toStr(key, type)
+
+将字段值转换为字符串。
+
+参数：
+
+- key: 目标字段
+- type: 转换前的字段类型，可为`bool`, `int`, `float`, `int64`, `float64`。非必填，如果已知字段类型，建议填写，填写时请自行保证类型正确，否则可能导致转换失败；如果未填写，将根据反射获取字段类型，可能会对采集效率产生影响。
+
+!!! example
+
+    ``yaml     - action: toStr(code, int)     ``
+
+    input:``json     {       "body": "2021-02-16T09:21:20.545525544Z DEBUG this is log body",       "code": 200     }     ``
+
+    output:``json     {       "body": "2021-02-16T09:21:20.545525544Z DEBUG this is log body",       "code": "200"     }     ``
+
 ### print()
 打印event。一般用于调试阶段使用。