Class LoggingConfigurationBuilder
- java.lang.Object
-
- com.launchdarkly.sdk.server.integrations.LoggingConfigurationBuilder
-
- All Implemented Interfaces:
LoggingConfigurationFactory
public abstract class LoggingConfigurationBuilder extends java.lang.Object implements LoggingConfigurationFactory
Contains methods for configuring the SDK's logging behavior.If you want to set non-default values for any of these properties, create a builder with
Components.logging()
, change its properties with the methods of this class, and pass it toLDConfig.Builder.logging(LoggingConfigurationFactory)
:LDConfig config = new LDConfig.Builder() .logging( Components.logging() .logDataSourceOutageAsErrorAfter(Duration.ofSeconds(120)) ) .build();
Note that this class is abstract; the actual implementation is created by calling
Components.logging()
.- Since:
- 5.0.0
-
-
Field Summary
Fields Modifier and Type Field Description static java.time.Duration
DEFAULT_LOG_DATA_SOURCE_OUTAGE_AS_ERROR_AFTER
The default value forlogDataSourceOutageAsErrorAfter(Duration)
: one minute.protected java.time.Duration
logDataSourceOutageAsErrorAfter
-
Constructor Summary
Constructors Constructor Description LoggingConfigurationBuilder()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description LoggingConfigurationBuilder
logDataSourceOutageAsErrorAfter(java.time.Duration logDataSourceOutageAsErrorAfter)
Sets the time threshold, if any, after which the SDK will log a data source outage atERROR
level instead ofWARN
level.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.launchdarkly.sdk.server.interfaces.LoggingConfigurationFactory
createLoggingConfiguration
-
-
-
-
Field Detail
-
DEFAULT_LOG_DATA_SOURCE_OUTAGE_AS_ERROR_AFTER
public static final java.time.Duration DEFAULT_LOG_DATA_SOURCE_OUTAGE_AS_ERROR_AFTER
The default value forlogDataSourceOutageAsErrorAfter(Duration)
: one minute.
-
logDataSourceOutageAsErrorAfter
protected java.time.Duration logDataSourceOutageAsErrorAfter
-
-
Method Detail
-
logDataSourceOutageAsErrorAfter
public LoggingConfigurationBuilder logDataSourceOutageAsErrorAfter(java.time.Duration logDataSourceOutageAsErrorAfter)
Sets the time threshold, if any, after which the SDK will log a data source outage atERROR
level instead ofWARN
level.A data source outage means that an error condition, such as a network interruption or an error from the LaunchDarkly service, is preventing the SDK from receiving feature flag updates. Many outages are brief and the SDK can recover from them quickly; in that case it may be undesirable to log an
ERROR
line, which might trigger an unwanted automated alert depending on your monitoring tools. So, by default, the SDK logs such errors atWARN
level. However, if the amount of time specified by this method elapses before the data source starts working again, the SDK will log an additional message atERROR
level to indicate that this is a sustained problem.The default is
DEFAULT_LOG_DATA_SOURCE_OUTAGE_AS_ERROR_AFTER
. Setting it tonull
will disable this feature, so you will only getWARN
messages.- Parameters:
logDataSourceOutageAsErrorAfter
- the error logging threshold, or null- Returns:
- the builder
-
-