Server State

admin.v2alpha.ServerInfo

[admin.v2alpha.ServerInfo proto]

Proto representation of the value returned by /server_info, containing server version/server status information.

{
  "version": "...",
  "state": "...",
  "uptime_current_epoch": "{...}",
  "uptime_all_epochs": "{...}",
  "hot_restart_version": "...",
  "command_line_options": "{...}"
}
version

(string) Server version.

state

(admin.v2alpha.ServerInfo.State) State of the server.

uptime_current_epoch

(Duration) Uptime since current epoch was started.

uptime_all_epochs

(Duration) Uptime since the start of the first epoch.

hot_restart_version

(string) Hot restart version.

command_line_options

(admin.v2alpha.CommandLineOptions) Command line options the server is currently running with.

Enum admin.v2alpha.ServerInfo.State

[admin.v2alpha.ServerInfo.State proto]

LIVE

(DEFAULT) ⁣Server is live and serving traffic.

DRAINING

⁣Server is draining listeners in response to external health checks failing.

PRE_INITIALIZING

⁣Server has not yet completed cluster manager initialization.

INITIALIZING

⁣Server is running the cluster manager initialization callbacks (e.g., RDS).

admin.v2alpha.CommandLineOptions

[admin.v2alpha.CommandLineOptions proto]

{
  "base_id": "...",
  "concurrency": "...",
  "config_path": "...",
  "config_yaml": "...",
  "allow_unknown_static_fields": "...",
  "reject_unknown_dynamic_fields": "...",
  "admin_address_path": "...",
  "local_address_ip_version": "...",
  "log_level": "...",
  "component_log_level": "...",
  "log_format": "...",
  "log_format_escaped": "...",
  "log_path": "...",
  "service_cluster": "...",
  "service_node": "...",
  "service_zone": "...",
  "file_flush_interval": "{...}",
  "drain_time": "{...}",
  "parent_shutdown_time": "{...}",
  "mode": "...",
  "max_stats": "...",
  "max_obj_name_len": "...",
  "disable_hot_restart": "...",
  "enable_mutex_tracing": "...",
  "restart_epoch": "...",
  "cpuset_threads": "..."
}
base_id

(uint64) See --base-id for details.

concurrency

(uint32) See --concurrency for details.

config_path

(string) See --config-path for details.

config_yaml

(string) See --config-yaml for details.

allow_unknown_static_fields

(bool) See --allow-unknown-static-fields for details.

reject_unknown_dynamic_fields

(bool) See --reject-unknown-dynamic-fields for details.

admin_address_path

(string) See --admin-address-path for details.

local_address_ip_version

(admin.v2alpha.CommandLineOptions.IpVersion) See --local-address-ip-version for details.

log_level

(string) See --log-level for details.

component_log_level

(string) See --component-log-level for details.

log_format

(string) See --log-format for details.

log_format_escaped

(bool) See --log-format-escaped for details.

log_path

(string) See --log-path for details.

service_cluster

(string) See --service-cluster for details.

service_node

(string) See --service-node for details.

service_zone

(string) See --service-zone for details.

file_flush_interval

(Duration) See --file-flush-interval-msec for details.

drain_time

(Duration) See --drain-time-s for details.

parent_shutdown_time

(Duration) See --parent-shutdown-time-s for details.

mode

(admin.v2alpha.CommandLineOptions.Mode) See --mode for details.

max_stats

(uint64) max_stats and max_obj_name_len are now unused and have no effect.

max_obj_name_len

(uint64)

disable_hot_restart

(bool) See --disable-hot-restart for details.

enable_mutex_tracing

(bool) See --enable-mutex-tracing for details.

restart_epoch

(uint32) See --restart-epoch for details.

cpuset_threads

(bool) See --cpuset-threads for details.

Enum admin.v2alpha.CommandLineOptions.IpVersion

[admin.v2alpha.CommandLineOptions.IpVersion proto]

v4

(DEFAULT)

v6

Enum admin.v2alpha.CommandLineOptions.Mode

[admin.v2alpha.CommandLineOptions.Mode proto]

Serve

(DEFAULT) ⁣Validate configs and then serve traffic normally.

Validate

⁣Validate configs and exit.

InitOnly

⁣Completely load and initialize the config, and then exit without running the listener loop.