1. Using Variables

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

• Query Variables

• Predefined variables

  • __range

• User-defined variables

• Query Variables from URL

2. Using Variables

2.1. Query Variables

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

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

2.2. 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 查询的变量必须小写.

2.2.1. range[](#range "Permalink")

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

2.3. User-defined variables

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

2.4. Query Variables from URL

在 GitLab 13.0 中引入 .

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

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

该查询的 URL 为：

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