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 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

  1. 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:

    ./asmcli install \
      --project_id PROJECT_ID \
      --cluster_name CLUSTER_NAME \
      --cluster_location CLUSTER_LOCATION \
      --output_dir DIR_PATH  \
      --enable_all \
      --ca mesh_ca \
      --option prometheus

    Be sure to specify any other overlay files that you need to configure Cloud Service Mesh.

  2. 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.