阿里云日志服务SLS时序数据查询和分析简介-云淘科技

PromQL语法

PromQL语法示例如下所示。

• 查询指标名为http_requests_total，job标签为apiserver，handler标签为/api/comments的时间序列。

  http_requests_total{job="apiserver", handler="/api/comments"}

• 查询过去5分钟内，按照应用程序app和进程类型proc分组的前3个CPU用户。

  topk(3, sum by (app, proc) (rate(instance_cpu_time_ns[5m])))

• 查找不健康的Pod。

  min_over_time(sum by (namespace, pod) (kube_pod_status_phase{phase=~"Pending|Unknown|Failed"})[15m:1m]) > 0

• 查询K8s DaemonSet CPU 使用率。

  sum (rate (container_cpu_usage_seconds_total{pod=~"^x.*$",cluster=~".*",namespace=~".*"}[1m])) / sum (kube_pod_container_resource_limits_cpu_cores{pod=~"^null.*$",cluster=~".*",namespace=~".*"}) * 100

PromQL语法的更多信息，请参见Prometheus官方文档，查询示例。

SQL语法

SQL语法示例如下所示。

• 查询和分析全部数据。

  *| SELECT * FROM "my_metric_store.prom" WHERE __name__ != '' 

• 查询__labels__, ‘domain’值为www.example.com的数据，并对__value__字段进行求和计算。

  *| SELECT sum(__value__) FROM "my_metric_store.prom" WHERE element_at(__labels__, 'domain')='www.example.com' 

• 查询__labels__, ‘domain’值为www.example.com的数据，并对__value__字段进行求和计算以及对数据按小时聚合。

  *| SELECT sum(__value__),date_trunc('hour', __time_nano__/1000000) as t
  FROM "my_metric_store.prom" 
  WHERE element_at(__labels__, 'domain')='www.example.com'
  GROUP BY t
  ORDER BY t DESC

SQL语法相关说明如下所示。

• 时序数据的SQL语法与日志的SQL语法一致。更多信息，请参见分析语法。但在时序数据的SQL语法中，FROM的表名只能为{metrics_store_name}.prom，其中{metrics_store_name}为您已创建的MetricStore名称。 说明 请保留表名两端的双引号（””）。
• __labels__可使用element_at()函数获取其中某个Key的值，例如element_at(__labels__, ‘key’)。
• 表结构请参见编码方式。

SQL+PromQL语法

日志服务提供7个PromQL函数，其中promql_query、promql_labels、promql_label_values和promql_series函数只能在MetricStore的自定义查询分析页面中执行。详细说明如下表所示。

重要

• 当使用SQL+PromQL语法查询和分析时序数据时，您FROM的表名固定为metrics。
• PromQL函数的详细接口特性和说明，请参见Prometheus官方文档。

PromQL函数相当于UDTF，即返回一个表。

• promql_query(string)、promql_query_range(string, string)函数返回的表的结构如下表所示。
  

  字段名	字段类型	说明
  metric	varchar	时序名称。如果使用了Group By语法，那么该值可能为空。
  labels	map	Lables信息，Map类型。
  time	bigint	时间。
  value	double	某个时间点对应的值。

  查询示例如下：

  • promql_query(string)函数
  • promql_query_range(string, string)函数
• promql_labels()、promql_labels(string)、promql_label_values(string)、promql_label_values(string， string)函数返回的表的结构如下表所示。
  

  字段	字段类型	说明
  label	varchar	Label Key

  查询示例如下：

  • promql_labels()函数
  • promql_labels(string)函数
  • promql_label_values(string)函数
  • promql_label_values(string, string)函数
• promql_series(string)函数返回的表的结构如下表所示。
  

  字段	字段类型	说明
  series	map	时间序列

  查询示例如下：

使用限制

• MetricStore仅支持Prometheus查询和分析API（例如/query API、/query_range API等），其它API如/admin API、/alerts API、/rules API等均不支持。
• 使用PromQL语法、SQL+PromQL语法时，最多返回11000个时间点对应的值。
• 使用PromQL语法、SQL+PromQL语法时，您的Metric name和Label命名应符合命名规范。更多信息，请参见时序标识。