Monitor metrics for your CI/CD environment · Gitlab 中文文檔

# Monitor metrics for your CI/CD environment > 原文：[https://docs.gitlab.com/ee/operations/metrics/](https://docs.gitlab.com/ee/operations/metrics/) * [Populate your metrics dashboard](#populate-your-metrics-dashboard) * [Customize your metrics dashboard](#customize-your-metrics-dashboard) * [Metrics dashboard visibility](#metrics-dashboard-visibility) * [Adding custom metrics](#adding-custom-metrics) * [Editing additional metrics from the dashboard](#editing-additional-metrics-from-the-dashboard) * [Keyboard shortcuts for charts](#keyboard-shortcuts-for-charts) # Monitor metrics for your CI/CD environment[](#monitor-metrics-for-your-cicd-environment "Permalink") 在[為群集配置 Prometheus](../../user/project/integrations/prometheus.html)之后，GitLab 會嘗試在成功部署的任何[環境中](../../ci/environments/index.html)檢索性能指標. GitLab 在 Prometheus 服務器上掃描來自 Kubernetes 和 NGINX 等已知服務器的指標，并嘗試識別各個環境. 要了解有關支持的指標和掃描過程的更多信息，請參閱[Prometheus Metrics Library 文檔](../../user/project/integrations/prometheus_library/index.html) . 要查看已[完成至少一個部署](#populate-your-metrics-dashboard)的環境的指標儀表板，請執行[以下操作](#populate-your-metrics-dashboard) ： 1. *如果指標儀表盤僅對項目成員可見，請以項目成員*身份登錄到 GitLab. 了解有關[指標儀表板可見性的](#metrics-dashboard-visibility)更多[信息](#metrics-dashboard-visibility) . 2. 在您的項目中，導航到 **操作>指標** . GitLab 顯示環境的默認指標儀表板，如以下示例所示： [![Example of metrics dashboard](https://img.kancloud.cn/df/0e/df0e9da0967a56b95c0e9c9286ac8e4e_989x593.png)](img/example-dashboard_v13_1.png) 儀表板的頂部包含一個導航欄. 從左到右，導航欄包含： * **儀表板** -項目可用的所有儀表板的下拉列表，其中加星標的儀表板排在最前面. * **環境** -所有[環境的](../index.html)下拉列表，可在您鍵入時搜索所有環境. * **范圍** -要顯示的數據的時間段. * **刷新儀表板** -用當前數據重新加載儀表板. * **設置刷新率** - Set a time frame for refreshing the data displayed. * **明星儀表板** -單擊以將儀表板標記為收藏夾. 已加星標的信息中心顯示實心星按鈕，然后在" **儀表板"**下拉列表中首先顯示. （在 GitLab 13.0 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/214582) .） * **創建儀表板** - [為您的項目](dashboards/index.html#adding-a-new-dashboard-to-your-project)創建一個[新的自定義儀表板](dashboards/index.html#adding-a-new-dashboard-to-your-project) . * **指標設置** -配置[此儀表板](dashboards/index.html#manage-the-metrics-dashboard-settings)的[設置](dashboards/index.html#manage-the-metrics-dashboard-settings) . ## Populate your metrics dashboard[](#populate-your-metrics-dashboard "Permalink") 在[為群集配置 Prometheus](../../user/project/integrations/prometheus.html)之后，您還必須為 **操作>指標**頁面以包含數據. 設置[Auto DevOps](../../topics/autodevops/index.html)有助于快速創建部署： 1. 導航到您項目的 **操作> Kubernetes**頁面. 2. 確保除了 Prometheus 外，還安裝了 Runner 和 Ingress. 3. 安裝 Ingress 后，復制其端點. 4. Navigate to your project’s **設置> CI / CD** page. In the **自動 DevOps** section, select a deployment strategy and save your changes. 5. 在同一頁上的" **變量"**部分中，添加一個名為`KUBE_INGRESS_BASE_DOMAIN`的變量， `KUBE_INGRESS_BASE_DOMAIN`包含您先前復制的 Ingress 端點的值. 將類型保留為**Variable** . 6. 導航到您項目的 **CI / CD>管道**頁面，然后在任何分支上運行管道. 7. 管道成功運行后，圖表將在 **操作>指標**頁面. [![Monitoring Dashboard](https://img.kancloud.cn/55/fb/55fbed17003d34ea36d75bb12cd6b419_1000x453.png)](../../user/project/integrations/img/prometheus_monitoring_dashboard_v13_1.png) ## Customize your metrics dashboard[](#customize-your-metrics-dashboard "Permalink") 創建儀表板后，您可以對其進行自定義以滿足您的需求： * **添加自定義指標** ：除了 GitLab 默認指標之外，您還可以[創建自定義指標](#adding-custom-metrics)并將其顯示在指標儀表板上. * **配置指標警報** ：當環境性能超出您設置的范圍時，為團隊[配置自定義警報](alerts.html) . * **通過警報觸發操作** ： [為您的團隊打開新問題](alerts.html#trigger-actions-from-alerts-ultimate) 當環境性能超出您設置的范圍時. ## Metrics dashboard visibility[](#metrics-dashboard-visibility "Permalink") 在 GitLab 13.0 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/201924) . 您可以將指標儀表板的可見性設置為" **僅項目成員"**或" **具有訪問權限的所有人"** . 當設置為" **具有訪問權的所有人"時** ，指標儀表板對于已認證和未認證的用戶都是可見的. ## Adding custom metrics[](#adding-custom-metrics "Permalink") 版本歷史 * 在[GitLab Premium](https://about.gitlab.com/pricing/) 10.6 中[引入](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/3799) . * [移至](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/28527) [GitLab Core](https://about.gitlab.com/pricing/) 12.10\. 可以通過在監控儀表板頁面上添加自定義指標來對其進行監控. 保存它們后，它們將顯示在環境指標儀表板上，前提是： * 使用具有匹配[環境范圍的](../../ci/environments/index.html#scoping-environments-with-specs) [連接的 Kubernetes 群集](../../user/project/clusters/add_remove_clusters.html) ，并將[Prometheus 安裝在群集上](../../user/project/integrations/prometheus.html#enabling-prometheus-integration) . * Prometheus 是[手動配置的](../../user/project/integrations/prometheus.html#manual-configuration-of-prometheus) . [![Add New Metric](https://img.kancloud.cn/c6/4b/c64b3ae88d100c3bf7625bcc743f5f54_1002x1548.png)](../../user/project/integrations/img/prometheus_add_metric.png) 必須填寫幾個字段： * **名稱** ：圖表標題 * **類型** ：指標的類型. 相同類型的指標將一起顯示. * **查詢** ：有效的[PromQL 查詢](https://s0prometheus0io.icopy.site/docs/prometheus/latest/querying/basics/) . * **Y 軸標簽** ：Y 軸標題顯示在儀表板上. * **單位標簽** ：查詢單位，例如`req / sec` . 值旁邊顯示. 如果指標之間的**名稱** ， **類型**和**Y 軸標簽**字段匹配，則可以在同一圖表上顯示多個指標. 例如，具有" **名稱** `Requests Rate` ，" `Business` **類型"**和**Y 軸標簽** `rec / sec`度量標準將與另一個具有相同值的度量標準顯示在同一圖表上. 如果使用此功能，則建議使用**圖例標簽** . ## Editing additional metrics from the dashboard[](#editing-additional-metrics-from-the-dashboard "Permalink") 在 GitLab 12.9 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/208976) . 您可以通過以下方式為信息中心編輯現有的其他自定義指標： **更多操作**下拉菜單，然后選擇**編輯指標** . [![Edit metric](https://img.kancloud.cn/43/c5/43c5031426555d630ab6241197b657dd_800x544.png)](../../user/project/integrations/img/prometheus_dashboard_edit_metric_link_v_12_9.png) ## Keyboard shortcuts for charts[](#keyboard-shortcuts-for-charts "Permalink") 在 GitLab 13.2 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/202146) . 您可以使用鍵盤快捷鍵與當前關注的圖表面板更快地進行交互. 要激活鍵盤快捷鍵，請使用鍵盤標簽突出顯示 **"更多操作"**下拉菜單，或用鼠標懸停在下拉菜單上，然后按與所需操作對應的鍵： * **展開面板** - `e` * **查看日志** `-l` （小寫" L"） * **下載 CSV** - `d` * **復制鏈接到圖表** - `c` * **Alerts** - `a`