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.
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.
