如需使用 Prometheus、Grafana 或 Kiali 信息中心,必须将 Cloud Service Mesh 配置为将指标导出到 Prometheus。
当您安装 Cloud Service Mesh on Google Distributed Cloud for VMware(纯软件)或 Cloud Service Mesh on Google Distributed Cloud on Bare Metal(纯软件)时,系统会默认启用将指标导出到 Prometheus。在这些平台上,您可以开始安装自己的信息中心实例。
您可以在 GKE on Google Cloud 集群上启用将指标导出到 Prometheus 的功能,而不是导出到 Stackdriver(现称为 Google Cloud Observability)。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-19。"],[],[],null,["# Integrating with third-party add-ons\n====================================\n\n| **Note:** This guide only supports Cloud Service Mesh with Istio APIs and does not support Google Cloud APIs. For more information see, [Cloud Service Mesh overview](/service-mesh/docs/overview).\n\nCloud Service Mesh profiles don't include\n[Prometheus](https://prometheus.io/),\n[Kiali](https://kiali.io/), and\n[Grafana](https://grafana.com/docs/grafana/latest/) add-ons.\n\nNote, however, you can install your own instance of Prometheus, Kiali, and\nGrafana dashboards according to the applicable\n[third-party documentation](#third-party_documentation).\n\nThis document applies to the in-cluster control plane only.\n\nEnabling metrics export to Prometheus\n-------------------------------------\n\nTo use the Prometheus, Grafana, or Kiali dashboards, Cloud Service Mesh must\nbe configured to export metrics to Prometheus.\n\nMetrics export to Prometheus is enabled by default when you install\nCloud Service Mesh on Google Distributed Cloud (software only) for VMware or on bare metal. On these\nplatforms, you are all set to install your own instance of the dashboards.\n\nYou can enable metrics export to Prometheus instead of Stackdriver (now called\nGoogle Cloud Observability) on GKE on Google Cloud clusters.\n\nBefore you begin\n----------------\n\nFollow the steps in [Install dependent tools and validate cluster](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools) to:\n\n- [Install required tools](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#install_required_tools)\n- [Download `asmcli`](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#download_asmcli)\n- [Grant cluster admin permissions](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#grant_cluster_admin_permissions)\n- [Validate your project and cluster](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-dependent-tools#validate_project_and_cluster)\n\nEnable metrics export to Prometheus\n-----------------------------------\n\n1. Follow the steps in the\n [install](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/plan-install) and [upgrade](/service-mesh/docs/upgrade/upgrade)\n Cloud Service Mesh guide to install or upgrade Cloud Service Mesh on\n GKE. When you run `asmcli install`, include the following\n option:\n\n --option prometheus\n\n For example: \n\n ./asmcli install \\\n --project_id \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --cluster_name \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e \\\n --cluster_location \u003cvar translate=\"no\"\u003eCLUSTER_LOCATION\u003c/var\u003e \\\n --output_dir \u003cvar translate=\"no\"\u003eDIR_PATH\u003c/var\u003e \\\n --enable_all \\\n --ca mesh_ca \\\n --option prometheus\n\n | **Caution:** Using `--option prometheus` will disable metrics export to Stackdriver. You must export metrics to Stackdriver if you want or need to use the Cloud Service Mesh dashboard features. You can enable both Stackdriver and Prometheus by using `--option prometheus-and-stackdriver`.\n | **Warning:** With installation on GKE Enterprise On-premises clusters configured with `enableStackdriverForApplications=true`, enabling Prometheus may incur extra Cloud Monitoring charges. For more information and disabling `enableStackdriverForApplications`, see [GKE Enterprise clusters on-prem known issues](/anthos/clusters/docs/on-prem/latest/known-issues#unexpected-monitoring-billing). To disable Prometheus annotations during Cloud Service Mesh installation, see [disable Prometheus metrics merging feature](https://istio.io/latest/docs/ops/integrations/prometheus/#option-1-metrics-merging).\n | Note: By default, \\`asmcli\\` doesn't install an ingress gateway, which you can use to manage inbound traffic to applications running on your service mesh. Follow the steps in [Install gateways](/service-mesh/docs/unified-install/install-anthos-service-mesh#install_gateways) to install an ingress gateway.\n\n Be sure to specify any other\n [overlay files](/service-mesh/docs/enable-optional-features-in-cluster#about_the_overlay_files)\n that you need to configure Cloud Service Mesh.\n2. Complete the Cloud Service Mesh installation to enable automatic sidecar\n proxy injection on your workloads. For new installations, see\n [Deploy and redeploy workloads](/service-mesh/docs/onboarding/kubernetes-off-gcp/install/install-in-cluster-cloud-service-mesh#deploy_and_redeploy_workloads).\n For upgrades, see\n [Switch to the new control plane](/service-mesh/docs/upgrade/upgrade#switch_to_the_new_control_plane)\n\nThird-party documentation\n-------------------------\n\nYou can\n[deploy Prometheus and Grafana through the Cloud Marketplace](https://console.cloud.google.com/marketplace/details/google/prometheus) or\nrefer to the following documentation for installation.\n\n- Grafana:\n\n - [Getting started](https://grafana.com/docs/grafana/latest/getting-started/getting-started/)\n\n - [Import the dashboards](https://istio.io/v1.26/docs/ops/integrations/grafana/#option-2-import-from-grafana-com-into-an-existing-deployment)\n into an existing Grafana deployment.\n\n- Kiali:\n\n - [Quick Start guide](https://kiali.io/docs/installation/quick-start/)\n\n - [Installation Guide](https://kiali.io/docs/installation/installation-guide/)\n\n- Prometheus:\n\n - [Getting started](https://prometheus.io/docs/prometheus/latest/getting_started/)"]]