云日志服务 LTS-事件操作函数:e_drop

时间:2024-12-17 09:22:15

e_drop

根据条件判断是否丢弃日志。

  • 函数格式
    e_drop(condition=true)

    支持固定标识DROP,等价于e_drop()。

  • 参数说明

    参数名称

    参数类型

    是否必填

    说明

    condition

    Bool

    默认为true,一般传递一个条件判断函数的结果。

  • 返回结果

    满足条件则丢弃日志并返回None,否则返回原日志。

  • 函数示例
    1. 示例1:当__programe__字段的值为access时丢弃日志,否则保留该日志。
      • 测试数据
        [
        {
         "__programe__": "access", 
         "age":  18,
         "content":  123,
         "name":  "maki" 
        },
        {
         "__programe__": "error", 
         "age":  18,
         "content":  123,
         "name":  "maki"
        }
        ]
      • 加工规则
        e_if(e_search("__programe__==access"), DROP)
      • 加工结果

        丢弃__programe__字段值为access的日志,保留__programe__字段的值为error的日志。

        __programe__: error 
        age:  18
        content:  123
        name:  maki
    2. 示例2:条件判断结果为true,丢弃日志。
      • 测试数据
        {
         "k1":"v1" ,
         "k2": "v2",
         "k3": "k1"
        }
      • 加工规则
        e_drop(e_search("k1==v1"))
      • 加工结果

        因为k1==v1条件为true,因此丢弃该日志。

    3. 示例3:条件判断结果为false,保留日志。
      • 测试数据
        {
         "k1":"v1" ,
         "k2": "v2",
         "k3": "k1"
        }
      • 加工规则
        e_drop(e_search("not k1==v1"))
      • 加工结果
        k1: v1 
        k2: v2 
        k3: k1
    4. 示例4:不设置判断条件时,使用默认值true,丢弃日志。
      • 测试数据
        {
         "k1":"v1" ,
         "k2": "v2",
         "k3": "k1"
        }
      • 加工规则
        e_drop()
      • 加工结果

        丢弃日志。

  • 更多参考

    支持和其他函数组合使用。

support.huaweicloud.com/usermanual-lts/lts_07_0164.html