Using Variables

原文:https://docs.gitlab.com/ee/operations/metrics/dashboards/variables.html

Using Variables

Query Variables

可以使用双花括号来指定变量,例如"{{ci_environment_slug}}" (在 GitLab 12.7 中已添加 ).

在 GitLab 13.0 中删除了对"%{ci_environment_slug}"格式的支持. 继续使用旧格式的查询将不会显示任何数据.

Predefined variables

GitLab 在 Prometheus 查询中支持一组有限的CI 变量 . 这对于标识特定环境(例如ci_environment_slug )特别有用. 支持的变量是:

  • ci_environment_slug
  • kube_namespace
  • ci_project_name
  • ci_project_namespace
  • ci_project_path
  • ci_environment_name
  • __range

注意: Prometheus 查询的变量必须小写.

range[](#range “Permalink”)

__range变量在 Prometheus 范围向量选择器中很有用. 它的值是仪表板时间范围内的总秒数. 例如,如果仪表板时间范围设置为 8 小时,则__range值为28800s .

User-defined variables

可以在自定义仪表板 YAML 文件中定义变量 .

Query Variables from URL

在 GitLab 13.0 中引入 .

GitLab 支持通过 URL 参数设置自定义变量. 用双花括号( {{example}} )包围变量名称,以在查询中插入变量:

  1. avg(sum(container_memory_usage_bytes{container_name!="{{pod}}"}) by (job)) without (job) /1024/1024/1024'

该查询的 URL 为:

  1. http://gitlab.com/<user>/<project>/-/environments/<environment_id>/metrics?dashboard=.gitlab%2Fdashboards%2Fcustom.yml&pod=POD