Administration Interface

Quilkin exposes an HTTP interface to query different aspects of the server.

It is assumed that the administration interface will only ever be able to be accessible on localhost.

By default, the administration interface is bound to [::]:9091, but it can be configured by the command line flag --admin-address or through the proxy configuration file, like so:

admin:
  address: [::]:9095

Endpoints

The admin interface provides the following endpoints:

/live

This provides a liveness probe endpoint, most commonly used in Kubernetes based systems.

Will return an HTTP status of 200 when all health checks pass.

/ready

This provides a readiness probe endpoint, most commonly used in Kubernetes based systems.

Depending on whether Quilkin is run in Proxy mode i.e. quilkin run, vs an xDS provider mode, such as quilkin manage agones, will dictate how readiness is calculated:

Proxy Mode

Will return an HTTP status of 200 when there is at least one endpoint to send data to. This is primarily to ensure that new proxies that have yet to get configuration information from an xDS server aren't send data until they are fully populated.

xDS Provider Mode

Will return an HTTP status of 200 when all health checks pass.

/metrics

Outputs Prometheus formatted metrics for this instance.

See the Proxy Metrics documentation for what proxy metrics are available.

See the xDS Metrics documentation for what xDS metrics are available.

/config

Returns a JSON representation of the cluster and filterchain configuration that the instance is running with at the time of invocation.