Grafana

Grafana is an open source monitoring solution that can be used to configure dashboards for Istio. You can use Grafana to monitor the health of Istio and of applications within the service mesh.

Configuration

While you can build your own dashboards, Istio offers a set of preconfigured dashboards for all of the most important metrics for the mesh and for the control plane.

There are a few ways to configure Grafana to use these dashboards:

Option 1: Quick start

Istio provides a basic sample installation to quickly get Grafana up and running, bundled with all of the Istio dashboards already installed:

  1. $ kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.11/samples/addons/grafana.yaml

This will deploy Grafana into your cluster. This is intended for demonstration only, and is not tuned for performance or security.

Option 2: Import from grafana.com into an existing deployment

To quickly import the Istio dashboards to an existing Grafana instance, you can use the Import button in the Grafana UI to add the dashboard links above. When you import the dashboards, note that you must select a Prometheus data source.

You can also use a script to import all dashboards at once. For example:

  1. $ # Address of Grafana
  2. $ GRAFANA_HOST="http://localhost:3000"
  3. $ # Login credentials, if authentication is used
  4. $ GRAFANA_CRED="USER:PASSWORD"
  5. $ # The name of the Prometheus data source to use
  6. $ GRAFANA_DATASOURCE="Prometheus"
  7. $ # The version of Istio to deploy
  8. $ VERSION=1.11.0
  9. $ # Import all Istio dashboards
  10. $ for DASHBOARD in 7639 11829 7636 7630 7645; do
  11. $ REVISION="$(curl -s https://grafana.com/api/dashboards/${DASHBOARD}/revisions -s | jq ".items[] | select(.description | contains(\"${VERSION}\")) | .revision")"
  12. $ curl -s https://grafana.com/api/dashboards/${DASHBOARD}/revisions/${REVISION}/download > /tmp/dashboard.json
  13. $ echo "Importing $(cat /tmp/dashboard.json | jq -r '.title') (revision ${REVISION}, id ${DASHBOARD})..."
  14. $ curl -s -k -u "$GRAFANA_CRED" -XPOST \
  15. $ -H "Accept: application/json" \
  16. $ -H "Content-Type: application/json" \
  17. $ -d "{\"dashboard\":$(cat /tmp/dashboard.json),\"overwrite\":true, \
  18. $ \"inputs\":[{\"name\":\"DS_PROMETHEUS\",\"type\":\"datasource\", \
  19. $ \"pluginId\":\"prometheus\",\"value\":\"$GRAFANA_DATASOURCE\"}]}" \
  20. $ $GRAFANA_HOST/api/dashboards/import
  21. $ echo -e "\nDone\n"
  22. $ done

A new revision of the dashboards is created for each version of Istio. To ensure compatibility, it is recommended that you select the appropriate revision for the Istio version you are deploying.

Option 3: Implementation-specific methods

Grafana can be installed and configured through other methods. To import Istio dashboards, refer to the documentation for the installation method. For example: