Enterprise Configuration

Sensu Enterprise service scripts make use of certain environment variable values to configure the Java runtime environment. These settings take effect prior to Sensu Enterprise loading configuration files from disk as described in Sensu Configuration reference documentation.

Values for the environment variables described in this document should be set by editing /etc/default/sensu-enterprise. After changing values in this file, the sensu-enterprise service must be restarted before the new values can take effect.

Sensu Enterprise environment variables

Sensu Enterprise honors the following environment variables. For configuration honored by both Sensu Enterprise and Sensu Core, see the Sensu configuration reference documentation.

CMS_OCCUPANCY_FRACTION
description Configures the Initiating Occupancy Fraction threshold for the Java Concurrent Mark Sweep (CMS) garbage collector used by Sensu Enterprise.
type String
required false
default 75
example
CMS_OCCUPANCY_FRACTION="50"
HEAP_SIZE
description Java initial heap size (Xms) and maximum heap size (Xmx). Increasing heap size is a common solution to out of memory (java.lang.OutOfMemoryError) errors.
type String
required false
default 2048m
example
HEAP_SIZE=4096m
HEAP_DUMP_PATH
description This value determines the file system path where Sensu Enterprise will write the contents of Java’s memory heap in case of a crash. Because the size of each heap dump file is determined by the JVM heap size, it’s possible to fill the underlying disk after repeated crashes.
type String
required false
default /var/cache/sensu-enterprise
example
HEAP_DUMP_PATH=/var/space/sensu-enterprise
JAVA_OPTS
description This value is used to configure JVM runtime parameters when running Sensu Enterprise. Flags allowed here are determined by your system’s Java Runtime Environment.
type String
required false
example
JAVA_OPTS="-Djava.net.preferIPv4Stack=true"
MAX_OPEN_FILES
description This value is passed to ulimit for configuring the upper limit on open file descriptors.
type Integer
required false
default 16384
example
MAX_OPEN_FILES=32768

Sensu Enterprise command line interfaces and arguments

The following command line options are unique to Sensu Enterprise. For command line options shared with sensu-server, sensu-api, and sensu-client, visit the Sensu Core configuration reference docs.

-a (--api_only)
description Run only the Sensu Enterprise API. You can use API-only mode to deploy Sensu Enterprise API instances that don’t process events from transport queues.
example
$ /opt/sensu/bin/sensu-enterprise -a