Anthos Service Mesh and Traffic Director are now Cloud Service Mesh. For more information, see the Cloud Service Mesh overview.

Integrating with third-party add-ons

Cloud Service Mesh profiles don't include Prometheus, Kiali, and Grafana add-ons.

Note, however, you can install your own instance of Prometheus, Kiali, and Grafana dashboards according to the applicable third-party documentation.

This document applies to the in-cluster control plane only.

Enabling metrics export to Prometheus

To use the Prometheus, Grafana, or Kiali dashboards, Cloud Service Mesh must be configured to export metrics to Prometheus.

Metrics export to Prometheus is enabled by default when you install Cloud Service Mesh on Google Distributed Cloud (software only) for VMware or on bare metal. On these platforms, you are all set to install your own instance of the dashboards.

You can enable metrics export to Prometheus instead of Stackdriver (now called Google Cloud Observability) on GKE on Google Cloud clusters.

Before you begin

Follow the steps in Install dependent tools and validate cluster to:

Enable metrics export to Prometheus

Follow the steps in the install and upgrade Cloud Service Mesh guide to install or upgrade Cloud Service Mesh on GKE. When you run asmcli install, include the following option:
```
--option prometheus
```
For example:
```
./asmcliinstall\
--project_idPROJECT_ID\
--cluster_nameCLUSTER_NAME\
--cluster_locationCLUSTER_LOCATION\
--output_dirDIR_PATH\
--enable_all\
--camesh_ca\
--optionprometheus
```
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.
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. To disable Prometheus annotations during Cloud Service Mesh installation, see disable Prometheus metrics merging feature.

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 to install an ingress gateway.

Be sure to specify any other overlay files that you need to configure Cloud Service Mesh.
Complete the Cloud Service Mesh installation to enable automatic sidecar proxy injection on your workloads. For new installations, see Deploy and redeploy workloads. For upgrades, see Switch to the new control plane

Third-party documentation

You can deploy Prometheus and Grafana through the Cloud Marketplace or refer to the following documentation for installation.

Grafana:
- Getting started
- Import the dashboards into an existing Grafana deployment.
Kiali:
- Quick Start guide
- Installation Guide
Prometheus:
- Getting started