/api/query/exp

该端点允许使用表达式查询数据。该查询分为多个部分。

允许两个设置操作(或联接)。所有时间序列的并集或相交。

例如，我们可以在主机字段上使用 group by 来计算“ a b”。单独查询的两个 Metrics 将为每个主机发出一个时间序列，例如也许是“ web01”，“ web02”和“ web03”的代表。假设 Metrics“ a”具有所有 3 个主机的值，但 Metrics“ b”缺少“ web03”。

使用交集运算符，该表达式将有效地添加“ a.web01 b.web01”和“ a.web02 b.web02”，但是将跳过为“ web03”发出任何内容。请注意，如果看到的输出较少，或者在相交后没有可用序列的错误，请注意这一点。

使用联合运算符，该表达式将添加web01和web02系列，但对于度量标准“ b”，它将用度量标准的填充策略值替代结果。

Verbs

• POST

Requests

实施的各个部分包括：

"time"

时间部分是必需的，并且是单个 JSON 对象。这会影响时间范围和所有请求 Metrics 的可选减少。

E.g.

"time":{ "start":"1h-ago", "end":"10m-ago", "downsampler":{"interval":"15m","aggregator":"max"}

Downsampler

Fill Policies

这些用于替换“丢失”的值，即当期望数据点但在存储中找不到数据点时。

请注意，如果您尝试提供与该类型不兼容的值，则查询将引发异常。例如。用 NaN 提供非 NaN 的值将引发错误。

E.g.

{"policy":"scalar","value":"1"}

"filters"

过滤器用于根据标签键和值选择各种时间序列。必须至少指定一个过滤器(目前)，并至少提供一个聚合函数。字段包括：

E.g.

"filters":[
  "id":"f1",
  "tags":[
    {
      "type":"wildcard",
      "tagk":"host",
      "filter":"*",
      "groupBy":true
    },
    {
      "type":"literal_or",
      "tagk":"colo",
      "filter":"lga",
      "groupBy":false
    }
   ]
  ]

Filter Fields

在“标签”字段中，您可以具有一个或多个过滤器。过滤器列表可通过/api/config/filters端点找到。

"metrics"

Metrics 列表确定表达式中包含哪些 Metrics。必须至少有一个 Metrics。

E.g.

{"id":"cpunice", "filter":"f1", "metric":"system.cpu.nice"}

"expressions"

Metrics 上的一个或多个表达式的列表。表达式“必须”中的变量引用度量标准 ID 字段或表达式 ID 字段。支持嵌套表达式，但是如果检测到自引用或循环依赖项，则将引发异常。到目前为止，仅支持基本操作，例如加，减，乘，除，取模

E.g.

{
  "id": "cpubusy",
  "expr": "(((a + b + c + d + e + f + g) - g) / (a + b + c + d + e + f + g)) * 100",
  "join": {
      "operator": "intersection",
      "useQueryTags": true,
      "includeAggTags": false
  }
}

Joins

联接对象控制如何将给定度量的各种时间序列合并到表达式中。目前支持的两个基本操作是联合和相交运算符。其他标志控制联接行为。

"outputs"

这些确定输出行为，并允许您从结果中消除某些表达式或包括原始 Metrics。默认情况下，如果缺少此部分，则所有表达式以及仅表达式将被序列化。该字段是一个或多个输出对象的列表。稍后将添加带有标志的更多字段以影响输出。

E.g.

{"id":"e", "alias":"System Busy"}

Complete Example

{
   "time": {
       "start": "1y-ago",
       "aggregator":"sum"
   },
   "filters": [
       {
           "tags": [
               {
                   "type": "wildcard",
                   "tagk": "host",
                   "filter": "web*",
                   "groupBy": true
               }
           ],
           "id": "f1"
       }
   ],
   "metrics": [
       {
           "id": "a",
           "metric": "sys.cpu.user",
           "filter": "f1",
           "fillPolicy":{"policy":"nan"}
       },
       {
           "id": "b",
           "metric": "sys.cpu.iowait",
           "filter": "f1",
           "fillPolicy":{"policy":"nan"}
       }
   ],
   "expressions": [
       {
           "id": "e",
           "expr": "a + b"
       },
       {
         "id":"e2",
         "expr": "e * 2"
       },
       {
         "id":"e3",
         "expr": "e2 * 2"
       },
       {
         "id":"e4",
         "expr": "e3 * 2"
       },
       {
         "id":"e5",
         "expr": "e4 + e2"
       }
    ],
    "outputs":[
      {"id":"e5", "alias":"Mega expression"},
      {"id":"a", "alias":"CPU User"}
    ]
 }

Response

输出将包含outputs数组中的对象列表，结果将在一个数组数组中表示每个时间序列，然后是每个系列的元数据和整个查询。还包括原始查询和一些摘要统计信息。字段包括：

meta 部分包含有关输出数组中每个时间序列的有序信息。数组中的第一个元素将始终具有metrics值timestamp且没有其他数据。

Example Responses

{
  "outputs": [
      {
          "id": "Mega expression",
          "dps": [
              [
                  1431561600000,
                  1010,
                  1030
              ],
              [
                  1431561660000,
                  "NaN",
                  "NaN"
              ],
              [
                  1431561720000,
                  "NaN",
                  "NaN"
              ],
              [
                  1431561780000,
                  1120,
                  1140
              ]
          ],
          "dpsMeta": {
              "firstTimestamp": 1431561600000,
              "lastTimestamp": 1431561780000,
              "setCount": 4,
              "series": 2
          },
          "meta": [
              {
                  "index": 0,
                  "metrics": [
                      "timestamp"
                  ]
              },
              {
                  "index": 1,
                  "metrics": [
                      "sys.cpu",
                      "sys.iowait"
                  ],
                  "commonTags": {
                      "host": "web01"
                  },
                  "aggregatedTags": []
              },
              {
                  "index": 2,
                  "metrics": [
                      "sys.cpu",
                      "sys.iowait"
                  ],
                  "commonTags": {
                      "host": "web02"
                  },
                  "aggregatedTags": []
              }
          ]
      },
      {
          "id": "sys.cpu",
          "dps": [
              [
                  1431561600000,
                  1,
                  2
              ],
              [
                  1431561660000,
                  3,
                  0
              ],
              [
                  1431561720000,
                  5,
                  0
              ],
              [
                  1431561780000,
                  7,
                  8
              ]
          ],
          "dpsMeta": {
              "firstTimestamp": 1431561600000,
              "lastTimestamp": 1431561780000,
              "setCount": 4,
              "series": 2
          },
          "meta": [
              {
                  "index": 0,
                  "metrics": [
                      "timestamp"
                  ]
              },
              {
                  "index": 1,
                  "metrics": [
                      "sys.cpu"
                  ],
                  "commonTags": {
                      "host": "web01"
                  },
                  "aggregatedTags": []
              },
              {
                  "index": 2,
                  "metrics": [
                      "sys.cpu"
                  ],
                  "commonTags": {
                      "host": "web02"
                  },
                  "aggregatedTags": []
              }
          ]
      }
  ],
  "statsSummary": {
      "datapoints": 0,
      "rawDatapoints": 0,
      "aggregationTime": 0,
      "serializationTime": 33,
      "storageTime": 77,
      "timeTotal": 148.63
  },
  "query": {
      "name": null,
      "time": {
          "start": "1y-ago",
          "end": null,
          "timezone": null,
          "downsampler": null,
          "aggregator": "sum"
      },
      "filters": [
          {
              "id": "f1",
              "tags": [
                  {
                      "tagk": "host",
                      "filter": "web*",
                      "group_by": true,
                      "type": "wildcard"
                  }
              ]
          }
      ],
      "metrics": [
          {
              "metric": "sys.cpu",
              "id": "a",
              "filter": "f1",
              "aggregator": null,
              "fillPolicy": {
                  "policy": "nan",
                  "value": "NaN"
              },
              "timeOffset": null
          },
          {
              "metric": "sys.iowait",
              "id": "b",
              "filter": "f1",
              "aggregator": null,
              "fillPolicy": {
                  "policy": "nan",
                  "value": "NaN"
              },
              "timeOffset": null
          }
      ],
      "expressions": [
          {
              "id": "e",
              "expr": "a + b"
          },
          {
              "id": "e2",
              "expr": "e * 2"
          },
          {
              "id": "e3",
              "expr": "e2 * 2"
          },
          {
              "id": "e4",
              "expr": "e3 * 2"
          },
          {
              "id": "e5",
              "expr": "e4 + e2"
          }
      ],
      "outputs": [
          {
              "id": "e5",
              "alias": "Woot!"
          },
          {
              "id": "a",
              "alias": "Woot!2"
          }
      ]
   }
}