Integrating with third-party add-ons
Cloud Service Mesh profiles do not 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.
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:- Install required tools
- Download
asmcli
- Grant cluster admin permissions
- Validate your project and cluster
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:
./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.
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:
Import the dashboards into an existing Grafana deployment.
Kiali:
Prometheus: