3.0 KiB
Rancher Istio
Our Istio installer wraps the istioctl binary commands in a handy helm chart, including an overlay file option to allow complex customization. It also includes:
- Kiali: Used for graphing traffic flow throughout the mesh
- Jaeger: A quick start, all-in-one installation used for tracing distributed systemm. This is not production qualified, please refer to jaeger documentation to determine which installation you may need instead.
Dependencies
Rancher Monitoring or other Prometheus installation
The Prometheus CRDs are required for installing Kiali which is enabled by default. If you do not have Prometheus installed your Istio installation will fail. If you do not plan on using Kiali, set kiali.enabled=false
to bypass this requirement.
Customization
Rancher Monitoring
The Rancher Monitoring app sets prometheus.prometheusSpec.ignoreNamespaceSelectors=false
which means all namespaces will be scraped by Prometheus by default. This ensures you can view traffic, metrics and graphs for resources deployed in other namespaces.
To limit scraping to specific namespaces, set prometheus.prometheusSpec.ignoreNamespaceSelectors=true
and add one of the following configurations to ensure you can continue to view traffic, metrics and graphs for your deployed resources.
- Add a Service Monitor or Pod Monitor in the namespace with the targets you want to scrape.
- Add an additionalScrapeConfig to your rancher-monitoring instance to scrape all targets in all namespaces.
Custom Prometheus Installation with Kiali
To use a custom Monitoring installation, set the kiali.external_services.prometheus
url in the values.yaml. This url depends on the values for nameOverride
, namespaceOverride
, and prometheus.service.port
in your rancher-monitoring or other monitoring instance:
http://{{ .Values.nameOverride }}-prometheus.{{ .Values.namespaceOverride }}.svc:{{ prometheus.service.port }}
Custom Grafana Installation with Kiali
To use a custom Grafana installation, set the kiali.external_services.grafana
url in the values.yaml. This url depends on the values for nameOverride
, namespaceOverride
, and granfa.service.port
in your rancher-monitoring or other grafana instance:
http://{{ .Values.nameOverride }}-grafana.{{ .Values.namespaceOverride }}.svc:{{ grafana.service.port }}
Custom Tracing Installation with Kiali
To use a custom Tracing installation, set the kiali.external_services.tracing
url and update the .Values.tracing.contextPath
in the rancher-istio values.yaml.
This url depends on the values for namespaceOverride
, and .Values.service.externalPort
in your rancher-tracing or other tracing instance.:
http://tracing.{{ .Values.namespaceOverride }}.svc:{{ .Values.service.externalPort }}/{{ .Values.tracing.contextPath }}
For more information on how to use the feature, refer to our docs.