You configure logging in a member’s
gemfire.properties or at startup with
Before you begin, make sure you understand Basic Configuration and Programming.
Configure member logging in each member’s
gemfire.properties as needed:
# Default gemfire.properties log file settings
Note: You can also specify logging parameters when you start up members (either locators or servers) using the
gfsh command-line utility. In addition, you can modify log file properties and log-level settings while a member is already running by using the alter runtime command.
log-level. Log levels are not case-sensitive. Options are:
fatal (log messages with the highest level of importance)
The more detailed levels (lower in this list) also include messages from all levels above them. For example, a
warning log level shows
severe messages. For general troubleshooting, we recommend setting the log level at
config or higher on this list. The most detailed, lower levels in this list (
fine) can quickly consume disk space and negatively impact system performance. Use these more detailed levels only when necessary.
Specify the log file name in
log-file. This can be relative or absolute. If this property is not specified, the defaults are:
For servers, the default log file location is:
By default, when starting a server through
gfsh, the working -directory corresponds to the directory (named after itself) that the cache server creates upon startup. Alternatively, you can specify a different working directory path when you start the cache server. The server-name corresponds to the name of the cache server provided upon startup.
For a standalone locator, the default log file location is:
By default, when starting a locator through
gfsh, the working -directory corresponds to the directory (named after itself) created when the locator starts up. Alternatively, you can specify a different working directory path when you start a locator. The locator-name corresponds to the name of the locator provided upon startup. If you are using a colocated or embedded locator, the locator logs will be part of the member’s log file.
For the easiest logs examination and troubleshooting, send your logs to files instead of standard out. Note: Make sure each member logs to its own files. This makes the logs easier to decipher.
Set the maximum size of a single log file in
log-file-size-limit. If not set, the single, main log file is used. If set, the metadata file, the main log, and rolled child logs are used.
log-disk-space-limit. If non-zero, this limits the combined size of all inactive log files, deleting oldest files first to stay under the limit. A zero setting indicates no limit.
If you are using the
gfsh command-line interface,
gfsh can create its own log file in the directory where you run the
gfsh.bat script. By default, gfsh does not generate log files for itself. To enable gfsh logs, set the following system property to the desired log level before starting gfsh:
gfsh log files are named