28 lines
1.6 KiB
Markdown
28 lines
1.6 KiB
Markdown
|
在Prometheus中，`scalar` 函数用于将一个时间序列的值转换为一个标量值。这意味着它可以将一个单值时间序列（也就是只有一个数据点的时间序列）转换为一个静态值，可以在计算中使用。
|
|||
|
|
|
|||
|
|
**函数语法**:
|
|||
|
|
```promql
|
|||
|
|
scalar(expr)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**参数**:
|
|||
|
|
- `expr`: 任何有效的PromQL表达式，该表达式应返回一个或多个时间序列。通常情况下，表达式返回的时间序列应该只有一个样本点（单值）。
|
|||
|
|
|
|||
|
|
**返回值**:
|
|||
|
|
- 返回一个单一的标量值，这个值来自于给定表达式计算后获得的时间序列的最后一个样本。如果表达式返回多个样本或没有样本，则`scalar`函数会产生错误。
|
|||
|
|
|
|||
|
|
### 使用场景
|
|||
|
|
- 当你需要在计算中使用一个查询的最后一个值，但你不关心时间序列的时间戳，只希望获取一个数值时，`scalar` 函数非常有用。
|
|||
|
|
- 例如，如果你想要通过计算某个时间序列的最后一个值来与另一个时间序列进行比较或做进一步的数学运算。
|
|||
|
|
|
|||
|
|
### 示例
|
|||
|
|
假设你有一个名为 `http_requests_total` 的计数器时间序列，你希望获取最后一次请求的总数并用这个值去做其他的计算：
|
|||
|
|
|
|||
|
|
```promql
|
|||
|
|
scalar(http_requests_total{job="my_service"})
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这会返回 `http_requests_total` 中最后一个样本的数值，而不关心它与时间的关系。
|
|||
|
|
|
|||
|
|
### 注意事项
|
|||
|
|
- 如果查询返回了多个时间序列数据，那么使用 `scalar` 函数将导致错误，因此确保你在使用该函数时，表达式的结果是一个单一的时间序列。
|