Warning

The v2 xDS API is not supported in Envoy v1.18.0 and above.

ConfigDump¶

admin.v2alpha.ConfigDump¶

The /config_dump admin endpoint uses this wrapper message to maintain and serve arbitrary configuration information from any component in Envoy.

{
  "configs": []
}

configs

(repeated Any) This list is serialized and dumped in its entirety at the /config_dump endpoint.

The following configurations are currently supported and will be dumped in the order given below:

bootstrap: BootstrapConfigDump
clusters: ClustersConfigDump
listeners: ListenersConfigDump
routes: RoutesConfigDump

You can filter output with the resource and mask query parameters. See /config_dump?resource={}, /config_dump?mask={}, or /config_dump?resource={},mask={} for more information.

admin.v2alpha.UpdateFailureState¶

[admin.v2alpha.UpdateFailureState proto]

{
  "failed_configuration": "{...}",
  "last_update_attempt": "{...}",
  "details": "..."
}

failed_configuration: (Any) What the component configuration would have been if the update had succeeded.

last_update_attempt: (Timestamp) Time of the latest failed update attempt.

details: (string) Details about the last failed update attempt.

admin.v2alpha.BootstrapConfigDump¶

[admin.v2alpha.BootstrapConfigDump proto]

This message describes the bootstrap configuration that Envoy was started with. This includes any CLI overrides that were merged. Bootstrap configuration information can be used to recreate the static portions of an Envoy configuration by reusing the output as the bootstrap configuration for another Envoy.

{
  "bootstrap": "{...}",
  "last_updated": "{...}"
}

bootstrap: (config.bootstrap.v2.Bootstrap)

last_updated: (Timestamp) The timestamp when the BootstrapConfig was last updated.

admin.v2alpha.ListenersConfigDump¶

[admin.v2alpha.ListenersConfigDump proto]

Envoy’s listener manager fills this message with all currently known listeners. Listener configuration information can be used to recreate an Envoy configuration by populating all listeners as static listeners or by returning them in a LDS response.

{
  "version_info": "...",
  "static_listeners": [],
  "dynamic_listeners": []
}

version_info: (string) This is the version_info in the last processed LDS discovery response. If there are only static bootstrap listeners, this field will be “”.

static_listeners: (repeated admin.v2alpha.ListenersConfigDump.StaticListener) The statically loaded listener configs.

dynamic_listeners: (repeated admin.v2alpha.ListenersConfigDump.DynamicListener) State for any warming, active, or draining listeners.

admin.v2alpha.ListenersConfigDump.StaticListener¶

[admin.v2alpha.ListenersConfigDump.StaticListener proto]

Describes a statically loaded listener.

{
  "listener": "{...}",
  "last_updated": "{...}"
}

listener: (Any) The listener config.

last_updated: (Timestamp) The timestamp when the Listener was last successfully updated.

admin.v2alpha.ListenersConfigDump.DynamicListenerState¶

[admin.v2alpha.ListenersConfigDump.DynamicListenerState proto]

{
  "version_info": "...",
  "listener": "{...}",
  "last_updated": "{...}"
}

version_info: (string) This is the per-resource version information. This version is currently taken from the version_info field at the time that the listener was loaded. In the future, discrete per-listener versions may be supported by the API.

listener: (Any) The listener config.

last_updated: (Timestamp) The timestamp when the Listener was last successfully updated.

admin.v2alpha.ListenersConfigDump.DynamicListener¶

[admin.v2alpha.ListenersConfigDump.DynamicListener proto]

Describes a dynamically loaded listener via the LDS API.

{
  "name": "...",
  "active_state": "{...}",
  "warming_state": "{...}",
  "draining_state": "{...}",
  "error_state": "{...}"
}

name: (string) The name or unique id of this listener, pulled from the DynamicListenerState config.

active_state: (admin.v2alpha.ListenersConfigDump.DynamicListenerState) The listener state for any active listener by this name. These are listeners that are available to service data plane traffic.

warming_state: (admin.v2alpha.ListenersConfigDump.DynamicListenerState) The listener state for any warming listener by this name. These are listeners that are currently undergoing warming in preparation to service data plane traffic. Note that if attempting to recreate an Envoy configuration from a configuration dump, the warming listeners should generally be discarded.

draining_state: (admin.v2alpha.ListenersConfigDump.DynamicListenerState) The listener state for any draining listener by this name. These are listeners that are currently undergoing draining in preparation to stop servicing data plane traffic. Note that if attempting to recreate an Envoy configuration from a configuration dump, the draining listeners should generally be discarded.

error_state: (admin.v2alpha.UpdateFailureState) Set if the last update failed, cleared after the next successful update.

admin.v2alpha.ClustersConfigDump¶

[admin.v2alpha.ClustersConfigDump proto]

Envoy’s cluster manager fills this message with all currently known clusters. Cluster configuration information can be used to recreate an Envoy configuration by populating all clusters as static clusters or by returning them in a CDS response.

{
  "version_info": "...",
  "static_clusters": [],
  "dynamic_active_clusters": [],
  "dynamic_warming_clusters": []
}

version_info: (string) This is the version_info in the last processed CDS discovery response. If there are only static bootstrap clusters, this field will be “”.

static_clusters: (repeated admin.v2alpha.ClustersConfigDump.StaticCluster) The statically loaded cluster configs.

dynamic_active_clusters: (repeated admin.v2alpha.ClustersConfigDump.DynamicCluster) The dynamically loaded active clusters. These are clusters that are available to service data plane traffic.

dynamic_warming_clusters: (repeated admin.v2alpha.ClustersConfigDump.DynamicCluster) The dynamically loaded warming clusters. These are clusters that are currently undergoing warming in preparation to service data plane traffic. Note that if attempting to recreate an Envoy configuration from a configuration dump, the warming clusters should generally be discarded.

admin.v2alpha.ClustersConfigDump.StaticCluster¶

[admin.v2alpha.ClustersConfigDump.StaticCluster proto]

Describes a statically loaded cluster.

{
  "cluster": "{...}",
  "last_updated": "{...}"
}

cluster: (Any) The cluster config.

last_updated: (Timestamp) The timestamp when the Cluster was last updated.

admin.v2alpha.ClustersConfigDump.DynamicCluster¶

[admin.v2alpha.ClustersConfigDump.DynamicCluster proto]

Describes a dynamically loaded cluster via the CDS API.

{
  "version_info": "...",
  "cluster": "{...}",
  "last_updated": "{...}"
}

version_info: (string) This is the per-resource version information. This version is currently taken from the version_info field at the time that the cluster was loaded. In the future, discrete per-cluster versions may be supported by the API.

cluster: (Any) The cluster config.

last_updated: (Timestamp) The timestamp when the Cluster was last updated.

admin.v2alpha.RoutesConfigDump¶

[admin.v2alpha.RoutesConfigDump proto]

Envoy’s RDS implementation fills this message with all currently loaded routes, as described by their RouteConfiguration objects. Static routes that are either defined in the bootstrap configuration or defined inline while configuring listeners are separated from those configured dynamically via RDS. Route configuration information can be used to recreate an Envoy configuration by populating all routes as static routes or by returning them in RDS responses.

{
  "static_route_configs": [],
  "dynamic_route_configs": []
}

static_route_configs: (repeated admin.v2alpha.RoutesConfigDump.StaticRouteConfig) The statically loaded route configs.

dynamic_route_configs: (repeated admin.v2alpha.RoutesConfigDump.DynamicRouteConfig) The dynamically loaded route configs.

admin.v2alpha.RoutesConfigDump.StaticRouteConfig¶

[admin.v2alpha.RoutesConfigDump.StaticRouteConfig proto]

{
  "route_config": "{...}",
  "last_updated": "{...}"
}

route_config: (Any) The route config.

last_updated: (Timestamp) The timestamp when the Route was last updated.

admin.v2alpha.RoutesConfigDump.DynamicRouteConfig¶

[admin.v2alpha.RoutesConfigDump.DynamicRouteConfig proto]

{
  "version_info": "...",
  "route_config": "{...}",
  "last_updated": "{...}"
}

version_info: (string) This is the per-resource version information. This version is currently taken from the version_info field at the time that the route configuration was loaded.

route_config: (Any) The route config.

last_updated: (Timestamp) The timestamp when the Route was last updated.

admin.v2alpha.ScopedRoutesConfigDump¶

[admin.v2alpha.ScopedRoutesConfigDump proto]

Envoy’s scoped RDS implementation fills this message with all currently loaded route configuration scopes (defined via ScopedRouteConfigurationsSet protos). This message lists both the scopes defined inline with the higher order object (i.e., the HttpConnectionManager) and the dynamically obtained scopes via the SRDS API.

{
  "inline_scoped_route_configs": [],
  "dynamic_scoped_route_configs": []
}

inline_scoped_route_configs: (repeated admin.v2alpha.ScopedRoutesConfigDump.InlineScopedRouteConfigs) The statically loaded scoped route configs.

dynamic_scoped_route_configs: (repeated admin.v2alpha.ScopedRoutesConfigDump.DynamicScopedRouteConfigs) The dynamically loaded scoped route configs.

admin.v2alpha.ScopedRoutesConfigDump.InlineScopedRouteConfigs¶

[admin.v2alpha.ScopedRoutesConfigDump.InlineScopedRouteConfigs proto]

{
  "name": "...",
  "scoped_route_configs": [],
  "last_updated": "{...}"
}

name: (string) The name assigned to the scoped route configurations.

scoped_route_configs: (repeated Any) The scoped route configurations.

last_updated: (Timestamp) The timestamp when the scoped route config set was last updated.

admin.v2alpha.ScopedRoutesConfigDump.DynamicScopedRouteConfigs¶

[admin.v2alpha.ScopedRoutesConfigDump.DynamicScopedRouteConfigs proto]

{
  "name": "...",
  "version_info": "...",
  "scoped_route_configs": [],
  "last_updated": "{...}"
}

name: (string) The name assigned to the scoped route configurations.

version_info: (string) This is the per-resource version information. This version is currently taken from the version_info field at the time that the scoped routes configuration was loaded.

scoped_route_configs: (repeated Any) The scoped route configurations.

last_updated: (Timestamp) The timestamp when the scoped route config set was last updated.

admin.v2alpha.SecretsConfigDump¶

[admin.v2alpha.SecretsConfigDump proto]

Envoys SDS implementation fills this message with all secrets fetched dynamically via SDS.

{
  "static_secrets": [],
  "dynamic_active_secrets": [],
  "dynamic_warming_secrets": []
}

static_secrets: (repeated admin.v2alpha.SecretsConfigDump.StaticSecret) The statically loaded secrets.

dynamic_active_secrets: (repeated admin.v2alpha.SecretsConfigDump.DynamicSecret) The dynamically loaded active secrets. These are secrets that are available to service clusters or listeners.

dynamic_warming_secrets: (repeated admin.v2alpha.SecretsConfigDump.DynamicSecret) The dynamically loaded warming secrets. These are secrets that are currently undergoing warming in preparation to service clusters or listeners.

admin.v2alpha.SecretsConfigDump.DynamicSecret¶

[admin.v2alpha.SecretsConfigDump.DynamicSecret proto]

DynamicSecret contains secret information fetched via SDS.

{
  "name": "...",
  "version_info": "...",
  "last_updated": "{...}",
  "secret": "{...}"
}

name: (string) The name assigned to the secret.

version_info: (string) This is the per-resource version information.

last_updated: (Timestamp) The timestamp when the secret was last updated.

secret: (Any) The actual secret information. Security sensitive information is redacted (replaced with “[redacted]”) for private keys and passwords in TLS certificates.

admin.v2alpha.SecretsConfigDump.StaticSecret¶

[admin.v2alpha.SecretsConfigDump.StaticSecret proto]

StaticSecret specifies statically loaded secret in bootstrap.

{
  "name": "...",
  "last_updated": "{...}",
  "secret": "{...}"
}

name: (string) The name assigned to the secret.

last_updated: (Timestamp) The timestamp when the secret was last updated.

secret: (Any) The actual secret information. Security sensitive information is redacted (replaced with “[redacted]”) for private keys and passwords in TLS certificates.