Using Variables · Gitlab 中文文檔

# Using Variables > 原文：[https://docs.gitlab.com/ee/operations/metrics/dashboards/variables.html](https://docs.gitlab.com/ee/operations/metrics/dashboards/variables.html) * [Query Variables](#query-variables) * [Predefined variables](#predefined-variables) * [__range](#__range) * [User-defined variables](#user-defined-variables) * [Query Variables from URL](#query-variables-from-url) # Using Variables[](#using-variables "Permalink") ## Query Variables[](#query-variables "Permalink") 可以使用雙花括號來指定變量，例如`"{{ci_environment_slug}}"` （在 GitLab 12.7 中已[添加](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/20793) ）. 在 GitLab 13.0 中[刪除](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/31581)了對`"%{ci_environment_slug}"`格式的支持. 繼續使用舊格式的查詢將不會顯示任何數據. ## Predefined variables[](#predefined-variables "Permalink") GitLab 在 Prometheus 查詢中支持一組有限的[CI 變量](../../../ci/variables/README.html) . 這對于標識特定環境（例如`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 [范圍向量選擇器中](https://s0prometheus0io.icopy.site/docs/prometheus/latest/querying/basics/)很有用. 它的值是儀表板時間范圍內的總秒數. 例如，如果儀表板時間范圍設置為 8 小時，則`__range`值為`28800s` . ## User-defined variables[](#user-defined-variables "Permalink") [可以](../../../operations/metrics/dashboards/yaml.html#templating-templating-properties)在自定義儀表板 YAML 文件中[定義變量](../../../operations/metrics/dashboards/yaml.html#templating-templating-properties) . ## Query Variables from URL[](#query-variables-from-url "Permalink") 在 GitLab 13.0 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/214500) . 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 ```