FreeBSD Manual Pages
ZEEK-CLIENT(1) User Commands ZEEK-CLIENT(1) NAME zeek-client SYNOPSIS zeek-client [-h] [-c FILE] [--controller HOST:PORT] [--set SEC- TION.KEY=VAL] [--quiet | --verbose] [--version] {deploy,deploy-con- fig,get-config,get-id-value,get-instances,get-nodes,moni- tor,restart,stage-config,show-settings,test-timeout} ... DESCRIPTION A command-line client for Zeek's Management Framework. Use this client to push cluster configurations to a cluster controller, retrieve running state from the system, restart nodes, and more. For details about Zeek's Management Framework, please consult the docu- mentation at https://docs.zeek.org/en/master/frameworks/manage- ment.html. OPTIONS -c FILE, --configfile FILE Path to zeek-client config file. (Default: @ZEEK_CLIENT_CON- FIG_FILE@) --controller HOST:PORT Address and port of the controller, either of which may be omit- ted (default: 127.0.0.1:2149) --set SECTION.KEY=VAL Adjust a configuration setting. Can use repeatedly. See show-settings. --quiet, -q Suppress informational output to stderr. --verbose, -v Increase informational output to stderr. Repeat for more output (e.g. -vvv). --version Show version number and exit. COMMANDS zeek-client deploy Deploy a staged cluster configuration. usage: zeek-client deploy [-h] zeek-client deploy-config Upload a cluster configuration and deploy it. usage: zeek-client deploy-config [-h] FILE arguments: FILE Cluster configuration file, "-" for stdin zeek-client get-config Retrieve staged or deployed cluster configuration. usage: zeek-client get-config [-h] [--filename FILE] [--as-json] [--deployed | --staged] options: --filename FILE, -f FILE Output file for the configuration, default stdout --as-json Report in JSON instead of INI-style config file --deployed Return deployed configuration --staged Return staged configuration (default) zeek-client get-id-value Show the value of a given identifier in Zeek cluster nodes. usage: zeek-client get-id-value [-h] IDENTIFIER [NODES ...] arguments: IDENTIFIER Name of the Zeek script identifier to retrieve. NODES Name(s) of Zeek cluster nodes to query. When omitted, queries all nodes. zeek-client get-instances Show instances connected to the controller. usage: zeek-client get-instances [-h] zeek-client get-nodes Show active Zeek nodes at each instance. usage: zeek-client get-nodes [-h] zeek-client monitor For troubleshooting: do nothing, just report events. usage: zeek-client monitor [-h] zeek-client restart Restart cluster nodes. usage: zeek-client restart [-h] [NODES ...] arguments: NODES Name(s) of Zeek cluster nodes to restart. When omitted, restarts all nodes. zeek-client stage-config Upload a cluster configuration for later deployment. usage: zeek-client stage-config [-h] FILE arguments: FILE Cluster configuration file, "-" for stdin zeek-client show-settings Show zeek-client's own configuration. usage: zeek-client show-settings [-h] zeek-client test-timeout Send timeout test event. usage: zeek-client test-timeout [-h] [--with-state] options: --with-state Make request stateful in the controller. EXIT STATUS The client exits with 0 on success and 1 if a problem arises, such as lack of a response from the controller, unexpected response data, or the controller explicitly reporting an error in its handling of a com- mand. ENVIRONMENT zeek-client supports the following environment variables: ZEEK_CLIENT_CONFIG_FILE: Same as `--configfile` argument, but lower precedence. ZEEK_CLIENT_CONFIG_SETTINGS: Same as a space-separated series of `--set` arguments, but lower precedence. SUGGESTIONS AND BUG REPORTS The Management Framework and this client are experimental software. The Zeek team welcomes your feedback. Please file issues on Github at https://github.com/zeek/zeek-client/issues, or contact us on Discourse or Slack: https://zeek.org/community zeek-client ZEEK-CLIENT(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | EXIT STATUS | ENVIRONMENT | SUGGESTIONS AND BUG REPORTS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zeek-client&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>