Kubernetes z-pages [page]deterministic

Kubernetes core components can expose a suite of _z-endpoints_ to make it easier for users to debug their cluster and its components. These endpoints are strictly to be used for human inspection to gain real time debugging information of a component binary. In Kubernetes these are beta features.

## z-pages

Kubernetes v allows you to enable _z-pages_ to help you troubleshoot problems with its core control plane components. These special debugging endpoints provide internal information about running components. For Kubernetes , components serve the following endpoints (when enabled):

• [z-pages](#z-pages) - [statusz](#statusz) - [statusz (structured)](#statusz-structured) - [flagz](#flagz) - [flagz (structured)](#flagz-structured)

### statusz

Enabled using the `ComponentStatusz` [feature gate](/docs/reference/command-line-tools-reference/feature-gates#ComponentStatusz), the `/statusz` endpoint displays high level information about the component such as its Kubernetes version, emulation version, start time and more.

The `/statusz` plain text response from the API server is similar to:

``` kube-apiserver statusz Warning: This endpoint is not meant to be machine parseable, has no formatting compatibility guarantees and is for debugging purposes only.

Started: Wed Oct 16 21:03:43 UTC 2024 Up: 0 hr 00 min 16 sec Go version: go1.23.2 Binary version: 1.32.0-alpha.0.1484+5eeac4f21a491b-dirty Emulation version: 1.32.0-alpha.0.1484 Paths: /healthz /livez /metrics /readyz /statusz /version ```

#### statusz (structured)

Starting with Kubernetes v1.35, the `/statusz` endpoint supports a structured, versioned response format when requested with the appropriate `Accept` header. Without an `Accept` header, the endpoint returns the plain text response format by default.

To request the structured response, use: ``` Accept: application/json;v=v1beta1;g=config.k8s.io;as=Statusz ```

> Note: If you request `application/json` without specifying all required parameters (`g`, `v`, and `as`), the server will respond with `406 Not Acceptable`.

Example structured response: ```json { "kind": "Statusz", "apiVersion": "config.k8s.io/v1beta1", "metadata": { "name": "kube-apiserver" }, "startTime": "2025-10-29T00:30:01Z", "uptimeSeconds": 856, "goVersion": "go1.23.2", "binaryVersion": "1.35.0", "emulationVersion": "1.35", "paths": [ "/healthz", "/livez", "/metrics", "/readyz", "/statusz", "/version" ] } ```

The `config.k8s.io/v1beta1` schema for the structured `/statusz` response is as follows:

```go // Statusz is the config.k8s.io/v1beta1 schema for the /statusz endpoint. type Statusz struct { // Kind is "Statusz". Kind string `json:"kind"` // APIVersion is the version of the object, e.g., "config.k8s.io/v1beta1". APIVersion string `json:"apiVersion"` // Standard object's metadata. // +optional Metadata metav1.ObjectMeta `json:"metadata,omitempty"` // StartTime is the time the component process was initiated. StartTime metav1.Time `json:"startTime"` // UptimeSeconds is the duration in seconds for which the component has been running continuously. UptimeSeconds int64 `json:"uptimeSeconds"` // GoVersion is the version of the Go programming language used to build the binary. // The format is not guaranteed to be consistent across different Go builds. // +optional GoVersion string `json:"goVersion,omitempty"` // BinaryVersion is the version of the component's binary. // The format is not guaranteed to be semantic versioning and may be an arbitrary string. BinaryVersion string `json:"binaryVersion"` // EmulationVersion is the Kubernetes API version which this component is emulating. // if present, formatted as "<major>.<minor>" // +optional EmulationVersion string `json:"emulationVersion,omitempty"` // MinimumCompatibilityVersion is the minimum Kubernetes API version with which the component is designed to work. // if present, formatted as "<major>. …(trimmed)