Cluster discovery service

The cluster discovery service (CDS) is an optional API that Envoy will call to dynamically fetch cluster manager members. Envoy will reconcile the API response and add, modify, or remove known clusters depending on what is required.

Note

Any clusters that are statically defined within the Envoy configuration cannot be modified or removed via the CDS API.

Statistics

CDS has a statistics tree rooted at cluster_manager.cds. with the following statistics:

NameTypeDescription
config_reloadCounterTotal API fetches that resulted in a config reload due to a different config
update_attemptCounterTotal API fetches attempted
update_successCounterTotal API fetches completed successfully
update_failureCounterTotal API fetches that failed because of network errors
update_rejectedCounterTotal API fetches that failed because of schema/validation errors
versionGaugeHash of the contents from the last successful API fetch
control_plane.connected_stateGaugeA boolan (1 for connected and 0 for disconnected) that indicates the current connection state with management server