如要探索目標,Managed Service for Prometheus Operator 需要與相同命名空間中的 Workflows Controller 對應的 PodMonitoring 資源。
您可以使用下列 PodMonitoring 設定:
# Copyright 2023 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## https://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:argo-workflows-controllerlabels:app.kubernetes.io/name:argo-workflows-controllerapp.kubernetes.io/part-of:google-cloud-managed-prometheusspec:endpoints:-port:9090scheme:httpinterval:30spath:/metricsselector:matchLabels:app:workflow-controller
確認 port 和 matchLabels 欄位的值與要監控的 Workflows Pod 相符。
根據預設,工作流程會在 9090 連接埠公開指標,並包含 app: workflow-controller 標籤。
# Copyright 2023 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## https://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:argo-workflows-ruleslabels:app.kubernetes.io/component:rulesapp.kubernetes.io/name:argo-workflows-rulesapp.kubernetes.io/part-of:google-cloud-managed-prometheusspec:groups:-name:argo-workflowsinterval:30srules:-alert:ArgoWorkflowsWorkflowErrorsannotations:description:|-Argo Workflows workflow errorsVALUE = {{ $value }}LABELS: {{ $labels }}summary:Argo Workflows workflow errors (instance {{ $labels.instance }})expr:argo_workflows_error_count > 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\nArgo Workflows. This document shows you how to do the following:\n\n- Set up Workflows 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[Workflows documentation](https://github.com/argoproj/argo-workflows/)\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 Argo Workflows, see [Argo Workflows](https://argoproj.github.io/argo-workflows/).\n\nPrerequisites\n\nTo collect metrics from\n\nWorkflows Controller\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 Workflows integration, you must use `argo-workflows` version v3.4.3 or later.\n\n For more information about available dashboards, see\n\n [View dashboards](#monitoring-dashboard).\n\n\u003cbr /\u003e\n\nWorkflows exposes Prometheus-format metrics automatically; you do not have to install it separately. To verify that Workflows Controller is emitting metrics on the expected endpoints, do the following:\n\n\u003cbr /\u003e\n\n1. Set up port forwarding by using the following command:\n\n ```\n kubectl -n NAMESPACE_NAME port-forward POD_NAME 9090\n ```\n2. Access the endpoint `localhost:9090/metrics` 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\nWorkflows Controller in the same namespace.\n\nYou can use the following PodMonitoring configuration: \n\n # Copyright 2023 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 # https://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: argo-workflows-controller\n labels:\n app.kubernetes.io/name: argo-workflows-controller\n app.kubernetes.io/part-of: google-cloud-managed-prometheus\n spec:\n endpoints:\n - port: 9090\n scheme: http\n interval: 30s\n path: /metrics\n selector:\n matchLabels:\n app: workflow-controller\n\nEnsure that the values of the `port` and `matchLabels` fields match those of the Workflows pods you wish to monitor. By default, Workflows exposes metrics on port 9090 and includes the label `app: workflow-controller`.\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 Workflows metrics: \n\n # Copyright 2023 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 # https://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: argo-workflows-rules\n labels:\n app.kubernetes.io/component: rules\n app.kubernetes.io/name: argo-workflows-rules\n app.kubernetes.io/part-of: google-cloud-managed-prometheus\n spec:\n groups:\n - name: argo-workflows\n interval: 30s\n rules:\n - alert: ArgoWorkflowsWorkflowErrors\n annotations:\n description: |-\n Argo Workflows workflow errors\n VALUE = {{ $value }}\n LABELS: {{ $labels }}\n summary: Argo Workflows workflow errors (instance {{ $labels.instance }})\n expr: argo_workflows_error_count \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\nWorkflows Controller. 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=\"argo-workflows-controller\", cluster=\"CLUSTER_NAME\", namespace=\"NAMESPACE_NAME\"}\n ```\n\n\u003cbr /\u003e\n\nView dashboards\n\nThe Cloud Monitoring integration includes\n\nthe **Workflows 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, **Workflows 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 Argo Workflows 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)."]]