Configuration Status Field

This feature is in the Alpha stage, see Istio Feature Status. Your feedback is welcome in the Istio User Experience discussion. Currently, this feature is tested only for single, low volume clusters with a single control plane revision.

Istio 1.6 and later provides information about the propagation of configuration changes through the mesh, using the status field of the resource. Status is disabled by default, and can be enabled during install with (you must also enable config_distribution_tracking):

  1. $ istioctl install --set values.pilot.env.PILOT_ENABLE_STATUS=true --set values.global.istiod.enableAnalysis=true

The status field contains the state of a resource’s configuration with various informational messages, including:

  • The resource’s readiness.
  • How many data plane instances are associated with it.
  • Information for the output of tools, such as istioctl analyze.

View the status field

You can view the contents of the status field of a resource using kubectl get. For example, to view the status of a virtual service, use the following command:

  1. $ kubectl get virtualservice <service-name> -o yaml

In the output, the status field contains several nested fields with details about the process of propagating configuration changes through the mesh.

  1. status:
  2.   conditions:
  3.   - lastProbeTime: null
  4.     lastTransitionTime: "2019-12-26T22:06:56Z"
  5.     message: "1 Error and 1 Warning found. See validationMessages field for details"
  6.     reason: "errorsFound"
  7.     status: "False"
  8.     type: PassedAnalysis
  9.   validationMessages:
  10.   - code: IST0101
  11.     level: Error
  12.     message: 'Referenced gateway not found: "bogus-gateway"'
  13.   - code: IST0102
  14.     level: Warn
  15.     message: 'mTLS not enabled for virtual service'

The conditions field

Conditions represent possible states of the resource. The type field of a condition can have the following values:

  • PassedAnalysis

When you apply a configuration, a condition of each of these types is added to the conditions field.

The status field of the PassedAnalysis type condition will have a value of True or False depending on whether or not Istio’s background analyzers have detected a problem with your config. If False, the problem(s) will be detailed in the validationMessages field.

The PassedAnalysis condition is an informational field only. It does not block the application of an invalid configuration. It is possible for the status to indicate that validation failed, but applying the configuration was successful. This means Istio was able to set the new configuration, but the configuration was invalid, likely due to a syntax error or similar problem.

The validationMessages field

In case of a validation failure, check the validationMessages field for more information. The validationMessages field has details about the validation process, such as error messages indicating that Istio cannot apply the configuration, and warning or informational messages that did not result in an error.

If the condition of type PassedValidation has a status of False, there will be validationMessages explaining the problem. There might be messages present when PassedValidation status is True, because those are informational messages.

For validation message examples, see Configuration Analysis Messages.