如要探索目標，Managed Service for Prometheus Operator 需要與相同命名空間中的 Jenkins 匯出工具對應的 PodMonitoring 資源。
您可以使用下列 PodMonitoring 設定：
# Copyright 2024 Google LLC## Licensed under the Apache License, Version 2.0 (the "License");# you may not use this file except in compliance with the License.# You may obtain a copy of the License at## http://www.apache.org/licenses/LICENSE-2.0## Unless required by applicable law or agreed to in writing, software# distributed under the License is distributed on an "AS IS" BASIS,# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.# See the License for the specific language governing permissions and# limitations under the License.apiVersion:monitoring.googleapis.com/v1kind:PodMonitoringmetadata:name:jenkinslabels:app.kubernetes.io/name:jenkinsapp.kubernetes.io/part-of:google-cloud-managed-prometheusspec:endpoints:-port:httpscheme:httpinterval:30spath:/prometheusselector:matchLabels:app.kubernetes.io/name:jenkins
確認 port 和 matchLabels 欄位的值與要監控的 Jenkins Pod 相符。根據預設，Jenkins Helm 安裝包含 port 值 http，以及值為 jenkins 的 app.kubernetes.io/name 標籤。
# Copyright 2024 Google LLC## Licensed under the Apache License, Version 2.0 (the "License");# you may not use this file except in compliance with the License.# You may obtain a copy of the License at## http://www.apache.org/licenses/LICENSE-2.0## Unless required by applicable law or agreed to in writing, software# distributed under the License is distributed on an "AS IS" BASIS,# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.# See the License for the specific language governing permissions and# limitations under the License.apiVersion:monitoring.googleapis.com/v1kind:Rulesmetadata:name:jenkins-ruleslabels:app.kubernetes.io/component:rulesapp.kubernetes.io/name:jenkins-rulesapp.kubernetes.io/part-of:google-cloud-managed-prometheusspec:groups:-name:jenkinsinterval:30srules:-alert:JenkinsHealthScoreBelowOneannotations:description:|-Jenkins health score below oneVALUE = {{ $value }}LABELS: {{ $labels }}summary:Jenkins health score below one (instance {{ $labels.instance }})expr:jenkins_health_check_score < 1for:5mlabels:severity:critical-alert:JenkinsPluginFailureannotations:description:|-Jenkins plugin failureVALUE = {{ $value }}LABELS: {{ $labels }}summary:Jenkins plugin failure (instance {{ $labels.instance }})expr:jenkins_plugins_failed > 0for:5mlabels:severity:critical
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-08-12 (世界標準時間)。"],[],[],null,["\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis document describes how to configure your Google Kubernetes Engine deployment\nso that you can use Google Cloud Managed Service for Prometheus to collect metrics from\n\nJenkins. This document shows you how to do the following:\n\n- Set up Jenkins to report metrics.\n- Access a dashboard in Cloud Monitoring to view the metrics.\n- Configure alerting rules to monitor the metrics.\n\n\u003cbr /\u003e\n\nThese instructions apply only if you are using [managed collection](/stackdriver/docs/managed-prometheus/setup-managed)\nwith Managed Service for Prometheus.\nIf you are using self-deployed collection, then see the\n\n[Jenkins documentation](https://github.com/jenkinsci/prometheus-plugin)\n\nfor installation information.\n\nThese instructions are provided as an example and are expected to work in\nmost Kubernetes environments.\n\nIf you are having trouble installing an\napplication or exporter due to restrictive security or organizational policies,\nthen we recommend you consult open-source documentation for support.\n\nFor information about Jenkins, see [Jenkins](https://www.jenkins.io/).\n\nPrerequisites\n\nTo collect metrics from\n\nthe Jenkins exporter\n\nby using\nManaged Service for Prometheus and managed collection, your deployment must\nmeet the following requirements:\n\n- Your cluster must be running Google Kubernetes Engine version 1.28.15-gke.2475000 or later.\n- You must be running Managed Service for Prometheus with managed collection enabled. For more information, see [Get started with managed collection](/stackdriver/docs/managed-prometheus/setup-managed).\n\n \u003cbr /\u003e\n\n- To use dashboards available in Cloud Monitoring for the Jenkins integration, you must use `jenkins` version 2.0.11 or later.\n\n For more information about available dashboards, see\n\n [View dashboards](#monitoring-dashboard).\n\n\u003cbr /\u003e\n\nJenkins exposes Prometheus-format metrics only after you install the [Metrics](https://plugins.jenkins.io/metrics/) and [Prometheus](https://plugins.jenkins.io/prometheus/) plugins.\n\n\u003cbr /\u003e\n\nIf you installed the [Jenkins community helm chart](https://github.com/jenkinsci/helm-charts/tree/main/charts/jenkins), you can append the Metrics and Prometheus plugins\nin the `controller.installPlugins` values field:\n\n\u003cbr /\u003e\n\n```\n controller:\n installPlugins:\n - kubernetes:3734.v562b_b_a_627ea_c\n - workflow-aggregator:590.v6a_d052e5a_a_b_5\n - git:4.13.0\n - configuration-as-code:1569.vb_72405b_80249\n - metrics\n - prometheus:2.0.11\n \n```\n\n\u003cbr /\u003e\n\nAlternatively, you can create your own Jenkins container image with the following Dockerfile:\n\n\u003cbr /\u003e\n\n```\n FROM jenkins/jenkins:lts\n RUN jenkins-plugin-cli --plugins prometheus metrics\n \n```\n\n\u003cbr /\u003e\n\nTo verify that the Jenkins exporter is emitting metrics on the expected endpoints,\ndo the following:\n\n1. Set up port-forwarding with the following command:\n\n ```\n kubectl -n NAMESPACE_NAME port-forward POD_NAME 8080\n ```\n2. Access the endpoint `localhost:8080/prometheus` by using the browser\n or the `curl` utility in another terminal session.\n\nDefine a PodMonitoring resource\n\nFor target discovery, the Managed Service for Prometheus Operator\nrequires a PodMonitoring resource that corresponds to\nthe Jenkins exporter in the same namespace.\n\nYou can use the following PodMonitoring configuration: \n\n # Copyright 2024 Google LLC\n #\n # Licensed under the Apache License, Version 2.0 (the \"License\");\n # you may not use this file except in compliance with the License.\n # You may obtain a copy of the License at\n #\n # http://www.apache.org/licenses/LICENSE-2.0\n #\n # Unless required by applicable law or agreed to in writing, software\n # distributed under the License is distributed on an \"AS IS\" BASIS,\n # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n # See the License for the specific language governing permissions and\n # limitations under the License.\n\n apiVersion: monitoring.googleapis.com/v1\n kind: PodMonitoring\n metadata:\n name: jenkins\n labels:\n app.kubernetes.io/name: jenkins\n app.kubernetes.io/part-of: google-cloud-managed-prometheus\n spec:\n endpoints:\n - port: http\n scheme: http\n interval: 30s\n path: /prometheus\n selector:\n matchLabels:\n app.kubernetes.io/name: jenkins\n\nEnsure that the values of the `port` and `matchLabels` fields match those of the Jenkins pods you want to monitor. By default, Jenkins [Helm installations](https://github.com/jenkinsci/helm-charts/tree/main/charts/jenkins) include a `port` value of `http` and a `app.kubernetes.io/name` label with the value `jenkins`.\n\nTo apply configuration changes from a local file, run the following command:\n\n```\nkubectl apply -n NAMESPACE_NAME -f FILE_NAME\n```\n\n\u003cbr /\u003e\n\nYou can also\n[use Terraform](/stackdriver/docs/managed-prometheus/setup-managed#terraform-scrape)\nto manage your configurations.\n\nDefine rules and alerts\n\nYou can use the following `Rules` configuration to define\nalerts on your Jenkins metrics: \n\n # Copyright 2024 Google LLC\n #\n # Licensed under the Apache License, Version 2.0 (the \"License\");\n # you may not use this file except in compliance with the License.\n # You may obtain a copy of the License at\n #\n # http://www.apache.org/licenses/LICENSE-2.0\n #\n # Unless required by applicable law or agreed to in writing, software\n # distributed under the License is distributed on an \"AS IS\" BASIS,\n # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n # See the License for the specific language governing permissions and\n # limitations under the License.\n\n apiVersion: monitoring.googleapis.com/v1\n kind: Rules\n metadata:\n name: jenkins-rules\n labels:\n app.kubernetes.io/component: rules\n app.kubernetes.io/name: jenkins-rules\n app.kubernetes.io/part-of: google-cloud-managed-prometheus\n spec:\n groups:\n - name: jenkins\n interval: 30s\n rules:\n - alert: JenkinsHealthScoreBelowOne\n annotations:\n description: |-\n Jenkins health score below one\n VALUE = {{ $value }}\n LABELS: {{ $labels }}\n summary: Jenkins health score below one (instance {{ $labels.instance }})\n expr: jenkins_health_check_score \u003c 1\n for: 5m\n labels:\n severity: critical\n - alert: JenkinsPluginFailure\n annotations:\n description: |-\n Jenkins plugin failure\n VALUE = {{ $value }}\n LABELS: {{ $labels }}\n summary: Jenkins plugin failure (instance {{ $labels.instance }})\n expr: jenkins_plugins_failed \u003e 0\n for: 5m\n labels:\n severity: critical\n\nTo apply configuration changes from a local file, run the following command:\n\n```\nkubectl apply -n NAMESPACE_NAME -f FILE_NAME\n```\n\n\u003cbr /\u003e\n\nYou can also\n[use Terraform](/stackdriver/docs/managed-prometheus/setup-managed#terraform-scrape)\nto manage your configurations.\n\nFor more information about applying rules to your cluster, see\n[Managed rule evaluation and alerting](/stackdriver/docs/managed-prometheus/rules-managed).\nYou can adjust the alert thresholds to suit your application.\n\nVerify the configuration\n\nYou can use Metrics Explorer to verify that you correctly configured\nthe Jenkins exporter. It might take one or two minutes for\nCloud Monitoring to ingest your metrics.\n\nTo verify the metrics are ingested, do the following:\n\n1. In the Google Cloud console, go to the\n *leaderboard* **Metrics explorer** page:\n\n [Go to **Metrics explorer**](https://console.cloud.google.com/monitoring/metrics-explorer)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the toolbar of the query-builder pane, select the button whose name is either *code* **MQL** or *code* **PromQL**.\n3. Verify that **PromQL** is selected in the **Language** toggle. The language toggle is in the same toolbar that lets you format your query.\n4. Enter and run the following query: \n\n ```\n up{job=\"jenkins\", cluster=\"CLUSTER_NAME\", namespace=\"NAMESPACE_NAME\"}\n ```\n\n\u003cbr /\u003e\n\nView dashboards\n\nThe Cloud Monitoring integration includes\n\nthe **Jenkins Prometheus Overview** dashboard.\n\nDashboards are automatically installed when you configure the integration.\nYou can also view static previews of dashboards without installing the\nintegration.\n\n\nTo view an installed dashboard, do the following:\n\n1. In the Google Cloud console, go to the **Dashboards** page:\n\n [Go to **Dashboards**](https://console.cloud.google.com/monitoring/dashboards)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. Select the **Dashboard List** tab.\n3. Choose the **Integrations** category.\n4. Click the name of the dashboard, for example, **Jenkins Prometheus Overview**.\n\n\u003cbr /\u003e\n\nTo view a static preview of the dashboard, do the following:\n\n1. In the Google Cloud console, go to the\n **Integrations**\n page:\n\n [Go to **Integrations**](https://console.cloud.google.com/monitoring/integrations)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. Click the **Kubernetes Engine** deployment-platform filter.\n3. Locate the Jenkins integration and click **View Details**.\n4. Select the **Dashboards** tab.\n\n\u003cbr /\u003e\n\nTroubleshooting\n\nFor information about troubleshooting metric ingestion problems, see\n[Problems with collection from exporters](/stackdriver/docs/managed-prometheus/troubleshooting#exporter-problems) in [Troubleshooting ingestion-side problems](/stackdriver/docs/managed-prometheus/troubleshooting#ingest-problems)."]]
頁面：
「Integrations」(整合) 頁面：