Lambda 表达式

TICKscript 使用 lambda 表达式来定义数据点上的转换以及定义充当过滤器的布尔条件。Lambda 表达式封装了数学运算、布尔运算、内部函数调用或这三者的组合。TICKscript 试图在大多数你会在 InfluxQL WHERE 子句中使用的表达式也能在 TICKscript 中作为表达式工作，但具有自己的语法。

• 所有字段或标签标识符都必须用双引号括起来。
• 相等比较运算符是 == 而不是 =。

TICKscript 中的所有 lambda 表达式都以 lambda: 关键字开头。

.where(lambda: "host" == 'server001.example.com')

在某些节点中，lambda 表达式的结果可以使用属性设置器 .as() 捕获到一个新字段中，并命名。通过这种方式，它们可以在管道下游的其他节点中使用。

lambda 表达式的内部函数可以是无状态的，也可以是有状态的。有状态意味着每次函数被评估时，内部状态都可以改变，并且会持续到下一次评估。

例如，内置函数 sigma 计算运行平均值和标准差，并返回当前数据点与平均值的标准差数量。

示例 1 – sigma 函数

sigma("value") > 3.0

每次评估表达式时，它都会更新运行统计数据，然后返回偏差。示例 1 中的简单表达式在它接收到的数据点流保持在运行平均值的 3.0 标准差以内时评估为 false。一旦处理了一个值，其距离平均值超过 3.0 标准差，它就会评估为 true。这样的表达式可以在 TICKscript 中用于定义强大的警报，如下面的示例 2 所示。

示例 2 – 带有 lambda 表达式的 TICKscript

stream
    |from()
    ...
    |alert()
        // use an expression to define when an alert should go critical.
        .crit(lambda: sigma("value") > 3.0)

关于无意类型转换的注意事项

请注意，在 TICKscript 中声明的数值遵循 语法 文档中引入的字面量解析规则。它们可能不是函数或操作的合适类型。包含小数点的数值将被解释为浮点数。不包含小数点的数值将被解释为整数。当整数和浮点数在同一个表达式中使用时，如果需要浮点数结果，整数值需要使用 float() 类型转换函数。如果不遵守此规则，可能会产生意外结果。例如，当使用 lambda 表达式计算类型为浮点数的 0 到 1 之间的比例以生成百分比时；当字段为整数类型时，可能会假定子字段可以被总数字段整除以获得比例（例如 subset/total * 100）。这种整数除以整数的运算将导致整数值 0。此外，将此类操作的结果乘以字面量 100（一个整数）也将导致 0。将整数值转换为浮点数将得到一个介于 0 和 1 之间的有效比例，然后乘以字面量 100.0（一个浮点数）将得到一个有效的百分比值。正确编写的操作应如下所示：

eval(lambda: float("total_error_responses")/float("total_responses") * 100.0).

如果在日志中出现 E! mismatched type to binary operator... 类型的错误，请检查确保运算符两侧的字段类型相同且符合预期。

简而言之，为了确保字段值的类型正确，请使用内置类型转换函数（参见 下方）。

内置函数

有状态函数

Count

Count 不接受任何参数，但返回表达式被评估的次数。

count() int64

Sigma

计算给定值与运行平均值的标准差数量。每次评估表达式时，运行平均值和标准差都会更新。

sigma(value float64) float64

Spread

计算传递给它的所有值的运行范围。范围是接收到的最大值和最小值之间的差值。

spread(value float64) float64

无状态函数

类型转换函数

Bool

通过 Golang 的 strconv.ParseBool 函数将字符串转换为布尔值。数字类型也可以转换为布尔值，其中 0 -> false，1 -> true。

bool(value) bool

Int

通过 Golang 的 strconv.ParseInt 或简单的 int64() 强制类型转换将字符串或 float64 转换为 int64。字符串假定为十进制数。持续时间将被转换为以纳秒为单位的 int64。布尔值将被转换为 int64，其中 false -> 0，true -> 1。

int(value) int64

浮点数

通过 Golang 的 strconv.ParseFloat 或简单的 float64() 强制类型转换将字符串或 int64 转换为 float64。布尔值将被转换为 float64，其中 false -> 0.0，true -> 1.0。

float(value) float64

字符串

通过 Golang 的 strconv.Format* 函数将 bool、int64 或 float64 转换为字符串。持续时间将被转换为持续时间的字符串表示形式。

string(value) string

Duration

将 int64 或 float64 转换为持续时间，假设单位是指定的第二个参数。字符串将被转换为 TICKscript 中的持续时间字面量形式。

duration(value int64|float64, unit duration) duration
duration(value string) duration

Existence

IsPresent

根据指定的字段或标签键是否存在返回布尔值。用于过滤掉缺少指定字段或标签的数据。

|where(lambda: isPresent("myfield"))

如果 myfield 是一个有效标识符，则返回 TRUE，否则返回 FALSE。

时间函数

time 字段

在每个表达式中，time 字段包含当前数据点的时间。以下函数可用于 time 字段。每个函数都返回一个 int64。

示例用法

lambda: hour("time") >= 9 AND hour("time") < 19

如果数据点的小时数在 0900 小时到 1900 小时之间，则上述表达式评估为 true。

Now

返回当前时间。

now() time

示例用法

lambda: "expiration" < unixNano(now())

数学函数

以下数学函数可用。每个函数都通过等效的 Go 函数实现（仅为参考链接到下表）。

字符串函数

以下字符串操作函数可用。每个函数都通过等效的 Go 函数实现（仅为参考链接到下表）。

示例

.where(lambda: !strContains("fstype", 'nfs') OR !strContains("fstype", 'cifs'))

人类可读字符串函数

HumanBytes

将具有字节单位的 int64 或 float64 转换为表示字节数的、人类可读的字符串。

humanBytes(value) string

条件函数

If

根据第一个参数的值返回其操作数的结果。第二个和第三个参数必须返回相同类型。

示例

|eval(lambda: if("field" > threshold AND "field" != 0, 'high', 'normal'))
    .as('value')

在上面的示例中，字段 value 的值将是字符串 high 或 normal，具体取决于作为第一个参数传递的条件。

if 函数的返回类型与其第二个和第三个参数的类型相同。

if(condition, true expression, false expression)