@CheckReturnValue

Package com.google.common.flogger

Flogger is a fluent API for writing log messages.

This package is a part of the open-source Flogger library.

Interface Summary

Interface	Description
FluentLogger2.Api	The non-wildcard, fully specified, logging API for this logger.
LazyArg<T>	Functional interface for allowing lazily evaluated arguments to be supplied to Flogger.
LoggingApi<API extends LoggingApi<API>>	The basic logging API.
LoggingScopeProvider	Provides a scope to a log statement via the LogContext.per(LoggingScopeProvider) method.
LogSiteKey	A tagging interface to mark implementations that are suitable for use as a key for looking up per log site persistent state.
MetadataKey.KeyValueHandler	Callback interface to handle additional contextual Metadata in log statements.

Class Summary

Class	Description
AbstractLogger<API extends LoggingApi<API>>	Base class for the fluent logger API.
FluentLogger2	The default implementation of AbstractLogger which returns the basic LoggingApi and uses the default parser and system configured backend.
LazyArgs	Static utility methods for lazy argument evaluation in Flogger.
LogContext<LOGGER extends AbstractLogger<API>,API extends LoggingApi<API>>	The base context for a logging statement, which implements the base logging API.
LogContext.Key	The predefined metadata keys used by the default logging API.
LoggingApi.NoOp<API extends LoggingApi<API>>	An implementation of LoggingApi which does nothing and discards all parameters.
LoggingScope	An opaque scope marker which can be attached to log sites to provide "per scope" behaviour for stateful logging operations (e.g.
LogPerBucketingStrategy<T>	Provides a strategy for "bucketing" a potentially unbounded set of log aggregation keys used by the LoggingApi#per(T, LogPerBucketingStrategy) method.
LogSite	A value type which representing the location of a single log statement.
LogSiteMap<V>	Provides per log site state for stateful fluent logging operations (e.g.
LogSites	Helper class to generate log sites for the current line of code.
MetadataKey<T>	Key for logging semi-structured metadata values.
RateLimitStatus	Status for rate limiting operations, usable by rate limiters and available to subclasses of LogContext to handle rate limiting consistently.

Enum Summary

Enum	Description
StackSize	Enum values to be passed into GoogleLoggingApi#withStackTrace to control the maximum number of stack trace elements created.

Exception Summary

Exception	Description
LogSiteStackTrace	A synthetic exception which can be attached to log statements when additional stack trace information is required in log files or via tools such as ECatcher.