Class LoggingHandler (3.5.3)

A logging handler that outputs logs generated with java.util.logging.Logger to Cloud Logging.

Java logging levels (see java.util.logging.Level) are mapped to the following Google Cloud Logging severities:

Original Java logging levels are added as labels (with levelName and levelValue keys, respectively) to the corresponding Cloud Logging LogEntry. You can read entry labels using LogEntry#getLabels(). To use logging levels that correspond to Cloud Logging severities you can use LoggingLevel.

Configuration: By default each LoggingHandler is initialized using the following LogManager configuration properties (that you can set in the logging.properties file). If properties are not defined (or have invalid values) then the specified default values are used.

• com.google.cloud.logging.LoggingHandler.log the log name (defaults to java.log).
• com.google.cloud.logging.LoggingHandler.level specifies the default level for the handler (defaults to Level.INFO).
• com.google.cloud.logging.LoggingHandler.filter specifies the name of a Filter class to use (defaults to no filter).
• com.google.cloud.logging.LoggingHandler.formatter specifies the name of a Formatter class to use (defaults to SimpleFormatter).
• com.google.cloud.logging.LoggingHandler.flushLevel specifies the flush log level. When a log with this level is published, logs are transmitted to the Cloud Logging service (defaults to LoggingLevel#ERROR).
• com.google.cloud.logging.LoggingHandler.enhancers specifies a comma separated list of LoggingEnhancer classes. This handler will call each enhancer list whenever it builds a LogEntry instance (defaults to empty list).
• com.google.cloud.logging.LoggingHandler.resourceType the type name to use when creating the default MonitoredResource (defaults to auto-detected resource type, else "global").
• com.google.cloud.logging.Synchronicity the synchronicity of the write method to use to write logs to the Cloud Logging service (defaults to Synchronicity#ASYNC).

To add a LoggingHandler to an existing Logger and be sure to avoid infinite recursion when logging, use the #addHandler(Logger, LoggingHandler) method. Alternatively you can add the handler via logging.properties. For example using the following line:

 com.example.mypackage.handlers=com.google.cloud.logging.LoggingHandler
 

Creates an handler that publishes messages to Cloud Logging.

Creates a handler that publishes messages to Cloud Logging.

Creates a handler that publishes messages to Cloud Logging.

Creates a handler that publishes messages to Cloud Logging.

Creates a handler that publishes messages to Cloud Logging.

Creates a handler that publishes messages to Cloud Logging.

Adds the provided LoggingHandler to logger. Use this method to register Cloud Logging handlers instead of Logger#addHandler(Handler) to avoid infinite recursion when logging.

Closes the handler and the associated Logging object.

Get the flush log level.

Get the flush log level.

Sets minimum logging level to log immediately and flush any pending writes.

Sets synchronicity of logging writes. By default, writes are asynchronous.