Gloo Mesh Core comes with an insights engine that automatically analyzes your Istio setup for health issues. To view insights for your environment, you must deploy the Gloo analyzer along with pipelines in the Gloo telemetry pipeline that analyze Istio components and store analyzer results as logs in Redis. Then, the Gloo management server uses the analyzer logs and metrics in Prometheus to create insights. Insights can be accessed in the Gloo UI.

  1. Get your current installation Helm values, and save them in a file.

      helm get values gloo-mesh-core -n gloo-mesh > gloo-mesh-core-single.yaml
open gloo-mesh-core-single.yaml

  2. Delete the first line that contains USER-SUPPLIED VALUES:, and save the file.

  3. Add the following configuration to your Helm values file to enable the Istio insights engine and the logs/analyzer pipeline. The logs/analyzer pipeline is set up on the Gloo collector agent and collects analyzer results from the Gloo analyzer component. Analyzer results are written to Redis Streams.

      
glooMgmtServer:
  enabled: true
  istioController:
    enabled: true
    istioControllerImage: >-
      us-docker.pkg.dev/developers-369321/gloo-platform-dev/istio-controller:5602de42cba50fdce2c74d56185557812235c48-2023-09-29-main-c5602de
  insights:
    enabled: true
redis:
  deployment:
    enabled: true
telemetryGateway:
  enabled: false
telemetryCollector:
  enabled: true
  config:
    exporters:
      otlp:
        endpoint: gloo-telemetry-gateway.gloo-mesh:4317
telemetryCollectorCustomization:
  pipelines: 
    logs/analyzer: 
      enabled: true

  4. Upgrade your installation by using your updated values file.

      helm upgrade gloo-mesh-core gloo-platform/gloo-platform \
   --namespace gloo-mesh \
   --values gloo-mesh-core-single.yaml

  5. Verify that your settings were added to the Gloo telemetry collector configmap.

      kubectl get configmap gloo-telemetry-collector-config -n gloo-mesh -o yaml

  6. Perform a rollout restart of the telemetry collector daemon set to force your configmap changes to be applied to the telemetry collector agent pod.

      kubectl rollout restart -n gloo-mesh daemonset/gloo-telemetry-collector-agent

  7. Open the Gloo UI.

      meshctl dashboard

  8. In the navigation pane, click Insights. Note that it takes a few minutes for insights to show in the Gloo UI.

  1. Get the Helm values files for your current version.

    1. Get your current values for the management cluster.
        helm get values gloo-mesh-core -n gloo-mesh --kube-context $MGMT_CONTEXT > control-plane.yaml
open control-plane.yaml
    2. Delete the first line that contains USER-SUPPLIED VALUES:, and save the file.
    3. Get your current values for the workload clusters.
        helm get values gloo-mesh-core -n gloo-mesh --kube-context $REMOTE_CONTEXT > data-plane.yaml
open data-plane.yaml
    4. Delete the first line that contains USER-SUPPLIED VALUES:, and save the file.

  2. In the Helm chart for the management cluster, enable the Istio insights engine and the logs/redis_stream pipeline. This pipeline receives analyzer results from the Gloo analyzer in the workload clusters, and writes these results to Redis Stream.

      
glooMgmtServer:
  enabled: true
  istioController:
    enabled: true
    istioControllerImage: >-
      us-docker.pkg.dev/developers-369321/gloo-platform-dev/istio-controller:5602de42cba50fdce2c74d56185557812235c48-2023-09-29-main-c5602de
  insights:
    enabled: true
redis:
  deployment:
    enabled: true
telemetryGateway:
  enabled: true
telemetryGatewayCustomization:
  pipelines:
    logs/redis_stream:
      enabled: true

  3. In the Helm values file for the workload cluster, enable the logs/analyzer pipeline to pick up analyzer results from the Gloo analyzer. The results are sent to the Gloo telemetry gateway in the management cluster.

      
telemetryCollector:
  enabled: true
  config:
    exporters:
      otlp:
        endpoint: gloo-telemetry-gateway.gloo-mesh:4317
telemetryCollectorCustomization:
  pipelines: 
    logs/analyzer: 
      enabled: true

  4. Upgrade the Gloo Mesh Core management cluster.

      helm upgrade gloo-mesh-core gloo-platform/gloo-platform \
  --kube-context $MGMT_CONTEXT \
  --namespace gloo-mesh \
  -f control-plane.yaml \
  --version $UPGRADE_VERSION

  5. Verify that your settings are applied in the management cluster.

    1. Verify that your settings were added to the Gloo telemetry gateway configmap.

        kubectl get configmap gloo-telemetry-gateway-config -n gloo-mesh -o yaml --context $MGMT_CONTEXT

    2. Perform a rollout restart of the telemetry gateway deployment to force your configmap changes to be applied to the telemetry gateway pod.

        kubectl rollout restart -n gloo-mesh deployment/gloo-telemetry-gateway --context $MGMT_CONTEXT

  6. Upgrade the Gloo Mesh Core workload cluster.

      helm upgrade gloo-mesh-core gloo-platform/gloo-platform \
  --kube-context $REMOTE_CONTEXT \
  --namespace gloo-mesh \
  -f data-plane.yaml \
  --version $UPGRADE_VERSION

  7. Verify that your settings are applied in the workload cluster.

    1. Verify that your settings were added to the Gloo telemetry collector configmap.

        kubectl get configmap gloo-telemetry-gateway-config -n gloo-mesh -o yaml --context $MGMT_CONTEXT

    2. Perform a rollout restart of the telemetry collector daemon set to force your configmap changes to be applied to the telemetry collector agent pods.

        kubectl rollout restart -n gloo-mesh deployment/gloo-telemetry-gateway --context $MGMT_CONTEXT

  8. Open the Gloo UI.

      meshctl dashboard --kubecontext $MGMT_CONTEXT

  9. In the navigation pane, click Insights. Note that it takes a few minutes for insights to show in the Gloo UI.

For more information about how to drill into insights and to find an overview of insights that are available to you, see Insights.