com.launchdarkly.client.integrations

Class EventProcessorBuilder

java.lang.Object

com.launchdarkly.client.integrations.EventProcessorBuilder

All Implemented Interfaces:

EventProcessorFactory

public abstract class EventProcessorBuilder
extends java.lang.Object
implements EventProcessorFactory

Contains methods for configuring delivery of analytics events.

The SDK normally buffers analytics events and sends them to LaunchDarkly at intervals. If you want to customize this behavior, create a builder with Components.sendEvents(), change its properties with the methods of this class, and pass it to LDConfig.Builder.events(EventProcessorFactory):

     LDConfig config = new LDConfig.Builder()
         .events(Components.sendEvents().capacity(5000).flushIntervalSeconds(2))
         .build();
 

These properties will override any equivalent deprecated properties that were set with LDConfig.Builder, such as LDConfig.Builder.capacity(int).

Note that this class is abstract; the actual implementation is created by calling Components.sendEvents().

Since:

4.12.0

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allAttributesPrivate
protected java.net.URI	baseURI
protected int	capacity
static int	DEFAULT_CAPACITY The default value for capacity(int).
static int	DEFAULT_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS The default value for diagnosticRecordingIntervalSeconds(int).
static int	DEFAULT_FLUSH_INTERVAL_SECONDS The default value for flushIntervalSeconds(int).
static int	DEFAULT_USER_KEYS_CAPACITY The default value for userKeysCapacity(int).
static int	DEFAULT_USER_KEYS_FLUSH_INTERVAL_SECONDS The default value for userKeysFlushIntervalSeconds(int).
protected int	diagnosticRecordingIntervalSeconds
protected EventSenderFactory	eventSenderFactory
protected int	flushIntervalSeconds
protected boolean	inlineUsersInEvents
static int	MIN_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS The minimum value for diagnosticRecordingIntervalSeconds(int).
protected java.util.Set<java.lang.String>	privateAttrNames
protected int	userKeysCapacity
protected int	userKeysFlushIntervalSeconds

Constructor Summary

Constructors

Constructor and Description
EventProcessorBuilder()

Method Summary

Modifier and Type	Method and Description
EventProcessorBuilder	allAttributesPrivate(boolean allAttributesPrivate) Sets whether or not all optional user attributes should be hidden from LaunchDarkly.
EventProcessorBuilder	baseURI(java.net.URI baseURI) Sets a custom base URI for the events service.
EventProcessorBuilder	capacity(int capacity) Set the capacity of the events buffer.
EventProcessorBuilder	diagnosticRecordingIntervalSeconds(int diagnosticRecordingIntervalSeconds) Sets the interval at which periodic diagnostic data is sent.
EventProcessorBuilder	eventSender(EventSenderFactory eventSenderFactory) Specifies a custom implementation for event delivery.
EventProcessorBuilder	flushIntervalSeconds(int flushIntervalSeconds) Sets the interval between flushes of the event buffer.
EventProcessorBuilder	inlineUsersInEvents(boolean inlineUsersInEvents) Sets whether to include full user details in every analytics event.
EventProcessorBuilder	privateAttributeNames(java.lang.String... attributeNames) Marks a set of attribute names as private.
EventProcessorBuilder	userKeysCapacity(int userKeysCapacity) Sets the number of user keys that the event processor can remember at any one time.
EventProcessorBuilder	userKeysFlushIntervalSeconds(int userKeysFlushIntervalSeconds) Sets the interval at which the event processor will reset its cache of known user keys.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.launchdarkly.client.EventProcessorFactory

createEventProcessor

Field Detail

DEFAULT_CAPACITY

public static final int DEFAULT_CAPACITY

The default value for capacity(int).

See Also:

Constant Field Values

DEFAULT_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS

public static final int DEFAULT_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS

The default value for diagnosticRecordingIntervalSeconds(int).

See Also:

Constant Field Values

DEFAULT_FLUSH_INTERVAL_SECONDS

public static final int DEFAULT_FLUSH_INTERVAL_SECONDS

The default value for flushIntervalSeconds(int).

See Also:

Constant Field Values

DEFAULT_USER_KEYS_CAPACITY

public static final int DEFAULT_USER_KEYS_CAPACITY

The default value for userKeysCapacity(int).

See Also:

Constant Field Values

DEFAULT_USER_KEYS_FLUSH_INTERVAL_SECONDS

public static final int DEFAULT_USER_KEYS_FLUSH_INTERVAL_SECONDS

The default value for userKeysFlushIntervalSeconds(int).

See Also:

Constant Field Values

MIN_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS

public static final int MIN_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS

The minimum value for diagnosticRecordingIntervalSeconds(int).

See Also:

Constant Field Values

allAttributesPrivate

protected boolean allAttributesPrivate

baseURI

protected java.net.URI baseURI

capacity

protected int capacity

diagnosticRecordingIntervalSeconds

protected int diagnosticRecordingIntervalSeconds

flushIntervalSeconds

protected int flushIntervalSeconds

inlineUsersInEvents

protected boolean inlineUsersInEvents

privateAttrNames

protected java.util.Set<java.lang.String> privateAttrNames

userKeysCapacity

protected int userKeysCapacity

userKeysFlushIntervalSeconds

protected int userKeysFlushIntervalSeconds

eventSenderFactory

protected EventSenderFactory eventSenderFactory

Constructor Detail

EventProcessorBuilder

public EventProcessorBuilder()

Method Detail

allAttributesPrivate

public EventProcessorBuilder allAttributesPrivate(boolean allAttributesPrivate)

Sets whether or not all optional user attributes should be hidden from LaunchDarkly.

If this is true, all user attribute values (other than the key) will be private, not just the attributes specified in privateAttributeNames(String...) or on a per-user basis with LDUser.Builder methods. By default, it is false.

Parameters:

allAttributesPrivate - true if all user attributes should be private

Returns:

the builder

See Also:

privateAttributeNames(String...), LDUser.Builder

baseURI

public EventProcessorBuilder baseURI(java.net.URI baseURI)

Sets a custom base URI for the events service.

You will only need to change this value in the following cases:

• You are using the Relay Proxy with event forwarding enabled. Set streamUri to the base URI of the Relay Proxy instance.
• You are connecting to a test server or a nonstandard endpoint for the LaunchDarkly service.

Parameters:

baseURI - the base URI of the events service; null to use the default

Returns:

the builder

capacity

public EventProcessorBuilder capacity(int capacity)

Set the capacity of the events buffer.

The client buffers up to this many events in memory before flushing. If the capacity is exceeded before the buffer is flushed (see flushIntervalSeconds(int), events will be discarded. Increasing the capacity means that events are less likely to be discarded, at the cost of consuming more memory.

The default value is DEFAULT_CAPACITY.

Parameters:

capacity - the capacity of the event buffer

Returns:

the builder

diagnosticRecordingIntervalSeconds

public EventProcessorBuilder diagnosticRecordingIntervalSeconds(int diagnosticRecordingIntervalSeconds)

Sets the interval at which periodic diagnostic data is sent.

The default value is DEFAULT_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS; the minimum value is MIN_DIAGNOSTIC_RECORDING_INTERVAL_SECONDS. This property is ignored if LDConfig.Builder.diagnosticOptOut(boolean) is set to true.

Parameters:

diagnosticRecordingIntervalSeconds - the diagnostics interval in seconds

Returns:

the builder

See Also:

LDConfig.Builder.diagnosticOptOut(boolean)

eventSender

public EventProcessorBuilder eventSender(EventSenderFactory eventSenderFactory)

Specifies a custom implementation for event delivery.

The standard event delivery implementation sends event data via HTTP/HTTPS to the LaunchDarkly events service endpoint (or any other endpoint specified with baseURI(URI). Providing a custom implementation may be useful in tests, or if the event data needs to be stored and forwarded.

Parameters:

eventSenderFactory - a factory for an EventSender implementation

Returns:

the builder

flushIntervalSeconds

public EventProcessorBuilder flushIntervalSeconds(int flushIntervalSeconds)

Sets the interval between flushes of the event buffer.

Decreasing the flush interval means that the event buffer is less likely to reach capacity.

The default value is DEFAULT_FLUSH_INTERVAL_SECONDS.

Parameters:

flushIntervalSeconds - the flush interval in seconds

Returns:

the builder

inlineUsersInEvents

public EventProcessorBuilder inlineUsersInEvents(boolean inlineUsersInEvents)

Sets whether to include full user details in every analytics event.

The default is false: events will only include the user key, except for one "index" event that provides the full details for the user).

Parameters:

inlineUsersInEvents - true if you want full user details in each event

Returns:

the builder

privateAttributeNames

public EventProcessorBuilder privateAttributeNames(java.lang.String... attributeNames)

Marks a set of attribute names as private.

Any users sent to LaunchDarkly with this configuration active will have attributes with these names removed. This is in addition to any attributes that were marked as private for an individual user with LDUser.Builder methods.

Parameters:

attributeNames - a set of names that will be removed from user data set to LaunchDarkly

Returns:

the builder

See Also:

allAttributesPrivate(boolean), LDUser.Builder

userKeysCapacity

public EventProcessorBuilder userKeysCapacity(int userKeysCapacity)

Sets the number of user keys that the event processor can remember at any one time.

To avoid sending duplicate user details in analytics events, the SDK maintains a cache of recently seen user keys, expiring at an interval set by userKeysFlushIntervalSeconds(int).

The default value is DEFAULT_USER_KEYS_CAPACITY.

Parameters:

userKeysCapacity - the maximum number of user keys to remember

Returns:

the builder

userKeysFlushIntervalSeconds

public EventProcessorBuilder userKeysFlushIntervalSeconds(int userKeysFlushIntervalSeconds)

Sets the interval at which the event processor will reset its cache of known user keys.

The default value is DEFAULT_USER_KEYS_FLUSH_INTERVAL_SECONDS.

Parameters:

userKeysFlushIntervalSeconds - the flush interval in seconds

Returns:

the builder