net.openhft.chronicle.analytics

Interface Analytics.Builder

Enclosing interface:

Analytics

public static interface Analytics.Builder

Method Summary

Modifier and Type	Method and Description
@NotNull Analytics	build() Creates and returns a new Analytics instance for this Builder.
@NotNull Analytics.Builder	putEventParameter(@NotNull String key, @NotNull String value) Associates the provided value with the provided key in this builder's event parameters.
@NotNull Analytics.Builder	putUserProperty(@NotNull String key, @NotNull String value) Associates the provided value with the provided key in this builder's user properties.
@NotNull Analytics.Builder	withClientIdFileName(@NotNull String clientIdFileName) Specifies a custom file name to use when storing a persistent client id used to identify returning users.
@NotNull Analytics.Builder	withDebugLogger(@NotNull Consumer<? super String> debugLogger) Specifies a custom logger that will receive debug messages.
@NotNull Analytics.Builder	withErrorLogger(@NotNull Consumer<? super String> errorLogger) Specifies a custom logger that will receive error messages.
@NotNull Analytics.Builder	withFrequencyLimit(int messages, long duration, @NotNull TimeUnit timeUnit) Limits the frequency by which events can be sent upstream to Google Analytics.
@NotNull Analytics.Builder	withReportDespiteJUnit() Specifies that reporting shall be made even though JUnit test classes are available to the classloader.
@NotNull Analytics.Builder	withUrl(@NotNull String url) Specifies a custom URL to use when connecting to Google Analytics.

Method Detail

putUserProperty

@NotNull
@NotNull Analytics.Builder putUserProperty(@NotNull
                                                    @NotNull String key,
                                                    @NotNull
                                                    @NotNull String value)

Associates the provided value with the provided key in this builder's user properties. If the builder previously contained an association for the key, the old value is replaced by the provided value.

The key will be used as a Google Analytics "user property" key with the associated value.

Parameters:

key - to associate

value - to associate with the key

Returns:

this builder

putEventParameter

@NotNull
@NotNull Analytics.Builder putEventParameter(@NotNull
                                                      @NotNull String key,
                                                      @NotNull
                                                      @NotNull String value)

Associates the provided value with the provided key in this builder's event parameters. If the builder previously contained an association for the key, the old value is replaced by the provided value.

The key will be used as a Google Analytics "event parameter" key with the associated value.

Parameters:

key - to associate

value - to associate with the key

Returns:

this builder

withFrequencyLimit

@NotNull
@NotNull Analytics.Builder withFrequencyLimit(int messages,
                                                       long duration,
                                                       @NotNull
                                                       @NotNull TimeUnit timeUnit)

Limits the frequency by which events can be sent upstream to Google Analytics.

Events that are posted within the provided time limit, counted from the time the last message was successfully attempted upstream, are silently dropped.

Thus, the highest rate of messages sent upstream can be calculated using the following function <p> 1.0d/timeUnit.toSeconds(duration) <p> which yields messages per second.

Parameters:

messages - max number of messages during the specified duration

duration - minimum duration between upstream messages.

timeUnit - for the provided duration.

Returns:

this builder

withErrorLogger

@NotNull
@NotNull Analytics.Builder withErrorLogger(@NotNull
                                                    @NotNull Consumer<? super String> errorLogger)

Specifies a custom logger that will receive error messages. For example, failed HTTP communications.

The default logger is System.err::println, i.e. messages will be output to the error console.

The actual messages sent to the error logger are unspecified and shall not be acted on by logic.

Parameters:

errorLogger - to use for error messages.

Returns:

this builder

withDebugLogger

@NotNull
@NotNull Analytics.Builder withDebugLogger(@NotNull
                                                    @NotNull Consumer<? super String> debugLogger)

Specifies a custom logger that will receive debug messages. For example, HTTP messages sent back and forth.

The default logger is s -> {}, i.e. messages will be discarded.

The actual messages sent to the debug logger are unspecified and shall not be acted on by logic.

Parameters:

debugLogger - to use for debug messages.

Returns:

this builder

withClientIdFileName

@NotNull
@NotNull Analytics.Builder withClientIdFileName(@NotNull
                                                         @NotNull String clientIdFileName)

Specifies a custom file name to use when storing a persistent client id used to identify returning users.

By default, a file named "chronicle.analytics.client.id" located in the user's home directory will be used.

Parameters:

clientIdFileName - used to store the persistent client id.

Returns:

this builder

withUrl

@NotNull
@NotNull Analytics.Builder withUrl(@NotNull
                                            @NotNull String url)

Specifies a custom URL to use when connecting to Google Analytics.

By default, the URL "https://www.google-analytics.com/mp/collect" will be used.

Parameters:

url - used for remote connection

Returns:

this builder

withReportDespiteJUnit

@NotNull
@NotNull Analytics.Builder withReportDespiteJUnit()

Specifies that reporting shall be made even though JUnit test classes are available to the classloader.

By default, no reporting will be done if either of the classes `org.junit.jupiter.api.Test` or `org.junit.Test` are available to the classloader.

Returns:

this builder

build

@NotNull
@NotNull Analytics build()

Creates and returns a new Analytics instance for this Builder.

Returns:

a new Analytics instance for this Builder