Nomad Autoscaler Command: agent
The agent command is used to start the Nomad Autoscaler which runs until an interrupt signal is received. The Nomad Autoscaler agent's configuration primarily comes from the config files used, but a subset of the options may also be passed directly as CLI arguments. See the Nomad Autoscaler Agent guide for more information on how to use this command and the options it has.
A subset of the available Nomad Autoscaler agent configuration can optionally be
passed in via CLI arguments. The
agent command accepts the following arguments:
-config=<path>: The path to either a single config file or a directory of config files to use for configuring the Nomad Autoscaler agent.
-log-level=<level>: Specify the verbosity level of Nomad Autoscaler's logs. Valid values include
WARN, in decreasing order of verbosity. The default is
-log-json: Output logs in a JSON format. The default is
-plugin-dir=<path>: The plugin directory is used to discover Nomad Autoscaler plugins. If not specified, the plugin directory defaults to be that of
-http-bind-address=<addr>: The HTTP address that the health server will bind to. The default is
-http-bind-port=<port>: The port that the health server will bind to. The default is
-enable-debug: Enable the agent debugging HTTP endpoints. The default is false.
-nomad-address=<addr>: The address of the Nomad server in the form of
protocol://addr:port. The default is
-nomad-region=<region>: The region of the Nomad servers to connect with.
-nomad-namespace=<namespace>: The target namespace for queries and actions bound to a namespace.
-nomad-token=<token>: The SecretID of an ACL token to use to authenticate API requests with.
-nomad-http-auth=<username:password>: The authentication information to use when connecting to a Nomad API which is using HTTP authentication.
-nomad-ca-cert=<path>: Path to a PEM encoded CA cert file to use to verify the Nomad server SSL certificate.
-nomad-ca-path=<path>: Path to a directory of PEM encoded CA cert files to verify the Nomad server SSL certificate. If both
-nomad-client-cert=<path>: Path to a PEM encoded client certificate for TLS authentication to the Nomad server. Must also specify
-nomad-client-key=<path>: Path to an unencrypted PEM encoded private key matching the client certificate from
-nomad-tls-server-name=<name>: The server name to use as the SNI host when connecting via TLS.
-nomad-skip-verify: Do not verify TLS certificates. This is strongly discouraged.
-policy-dir=<path>: The path to a directory used to load scaling policies.
-policy-default-cooldown=<dur>: The default cooldown that will be applied to all scaling policies which do not specify a cooldown period. The default is
-policy-default-evaluation-interval=<dur>: The default evaluation interval that will be applied to all scaling policies which do not specify an evaluation interval. The default is
-policy-eval-ack-timeout=<dur>: The time limit that an eval must be ACK'd before being considered NACK'd.
-policy-eval-delivery-limit=<num>: The maximum number of times a policy evaluation can be dequeued from the broker.
-policy-eval-workers=<key:value>: The number of workers to initialize for each queue, formatted as
<queue1>:<num>,<queue2>:<num>. Nomad Autoscaler supports
horizontalqueues. Nomad Autoscaler Enterprise supports additional
-policy-source-disable-file: Disable the sourcing of policies from disk.
-policy-source-disable-nomad: Disable the sourcing of policies from the Nomad API.
-telemetry-disable-hostname: Specifies whether gauge values should be prefixed with the local hostname.
-telemetry-enable-hostname-label: Enable adding hostname to metric labels.
-telemetry-collection-interval=<dur>: Specifies the time interval at which the agent collects telemetry data. The default is 1s.
-telemetry-statsite-address=<addr>: The address of the statsite aggregation server.
-telemetry-statsd-address=<addr>: The address of the statsd aggregation.
-telemetry-dogstatsd-address=<addr>: The address of the Datadog statsd server.
-telemetry-dogstatsd-tag=<tag_list>: A list of global tags that will be added to all telemetry packets sent to DogStatsD.
-telemetry-prometheus-metrics: Indicates whether the agent should make Prometheus formatted metrics available. Defaults to
-telemetry-prometheus-retention-time=<dur>: The time to retain Prometheus metrics before they are expired and untracked.
-telemetry-circonus-api-token: A valid API Token used to create/manage check. If provided, metric management is enabled.
-telemetry-circonus-api-app: The app name associated with API token. Defaults to
-telemetry-circonus-api-url: The base URL to use for contacting the Circonus API. Defaults to
-telemetry-circonus-submission-interval: The interval at which metrics are submitted to Circonus. Defaults to
-telemetry-circonus-submission-url: The check.config.submission_url field from a previously created HTTPTrap check.
-telemetry-circonus-check-id: The check id from a previously created HTTPTRAP check. The numeric portion of the check._cid field.
-telemetry-circonus-check-force-metric-activation: Force enabling metrics, as they are encountered, if the metric already exists and is NOT active. If check management is enabled, the default behavior is to add new metrics as they are encountered.
-telemetry-circonus-check-instance-id: Uniquely identify the metrics coming from this agent. Defaults to
-telemetry-circonus-check-search-tag: A special tag that helps to narrow down the search results when neither a submission URL or check ID are provided. Defaults to
-telemetry-circonus-check-tags: A comma separated list of tags to apply to the check. The value of
-telemetry-circonus-check-search-tagwill always be added to the check.
-telemetry-circonus-check-display-name: The name used for the Circonus check that will be displayed in the UI. This defaults to the value of
-telemetry-circonus-broker-id: The Circonus broker to use when creating a new check.
-telemetry-circonus-broker-select-tag: A tag which is used to select a broker ID when an explicit broker ID is not provided.
Nomad Autoscaler Command: version
version command displays build information about the running binary,
including the release version and the exact revision.
This command prints both the version number as well as the exact commit SHA used
during the build. The SHA may also have the string
+CHANGES appended to the
end, indicating that local, uncommitted changes were detected at build time.
$ nomad-autoscaler version Nomad Autoscaler v0.0.3-dev (da91fa9)