BatchOptions (org.gecko.influxdb.driver)

java.lang.Object
- org.influxdb.BatchOptions

All Implemented Interfaces:

java.lang.Cloneable
```
public final class BatchOptions
extends java.lang.Object
implements java.lang.Cloneable
```
BatchOptions are used to configure batching of individual data point writes into InfluxDB. See InfluxDB.enableBatch(BatchOptions)

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_BATCH_ACTIONS_LIMIT`
`static int`	`DEFAULT_BATCH_INTERVAL_DURATION`
`static int`	`DEFAULT_BUFFER_LIMIT`
`static int`	`DEFAULT_JITTER_INTERVAL_DURATION`
`static java.util.concurrent.TimeUnit`	`DEFAULT_PRECISION`
`static BatchOptions`	`DEFAULTS` Default batch options.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BatchOptions`	`actions(int actions)`
`BatchOptions`	`bufferLimit(int bufferLimit)` The client maintains a buffer for failed writes so that the writes will be retried later on.
`BatchOptions`	`consistency(InfluxDB.ConsistencyLevel consistency)`
`BatchOptions`	`exceptionHandler(java.util.function.BiConsumer<java.lang.Iterable<Point>,java.lang.Throwable> exceptionHandler)`
`BatchOptions`	`flushDuration(int flushDuration)`
`int`	`getActions()`
`int`	`getBufferLimit()`
`InfluxDB.ConsistencyLevel`	`getConsistency()`
`java.util.function.BiConsumer<java.lang.Iterable<Point>,java.lang.Throwable>`	`getExceptionHandler()`
`int`	`getFlushDuration()`
`int`	`getJitterDuration()`
`java.util.concurrent.TimeUnit`	`getPrecision()`
`java.util.concurrent.ThreadFactory`	`getThreadFactory()`
`BatchOptions`	`jitterDuration(int jitterDuration)` Jitters the batch flush interval by a random amount.
`BatchOptions`	`precision(java.util.concurrent.TimeUnit precision)` Set the time precision to use for the whole batch.
`BatchOptions`	`threadFactory(java.util.concurrent.ThreadFactory threadFactory)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_BATCH_ACTIONS_LIMIT
```
public static final int DEFAULT_BATCH_ACTIONS_LIMIT
```
    See Also:
    
    Constant Field Values
  - DEFAULT_BATCH_INTERVAL_DURATION
```
public static final int DEFAULT_BATCH_INTERVAL_DURATION
```
    See Also:
    
    Constant Field Values
  - DEFAULT_JITTER_INTERVAL_DURATION
```
public static final int DEFAULT_JITTER_INTERVAL_DURATION
```
    See Also:
    
    Constant Field Values
  - DEFAULT_BUFFER_LIMIT
```
public static final int DEFAULT_BUFFER_LIMIT
```
    See Also:
    
    Constant Field Values
  - DEFAULT_PRECISION
```
public static final java.util.concurrent.TimeUnit DEFAULT_PRECISION
```
  - DEFAULTS
```
public static final BatchOptions DEFAULTS
```
    Default batch options. This class is immutable, each configuration is built by taking the DEFAULTS and setting specific configuration properties.
- Method Detail
  - actions
```
public BatchOptions actions(int actions)
```
    Parameters:
    
    actions - the number of actions to collect
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - flushDuration
```
public BatchOptions flushDuration(int flushDuration)
```
    Parameters:
    
    flushDuration - the time to wait at most (milliseconds).
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - jitterDuration
```
public BatchOptions jitterDuration(int jitterDuration)
```
    Jitters the batch flush interval by a random amount. This is primarily to avoid large write spikes for users running a large number of client instances. ie, a jitter of 5s and flush duration 10s means flushes will happen every 10-15s.
    
    Parameters:
    
    jitterDuration - (milliseconds)
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - bufferLimit
```
public BatchOptions bufferLimit(int bufferLimit)
```
    The client maintains a buffer for failed writes so that the writes will be retried later on. This may help to overcome temporary network problems or InfluxDB load spikes. When the buffer is full and new points are written, oldest entries in the buffer are lost. To disable this feature set buffer limit to a value smaller than getActions()
    
    Parameters:
    
    bufferLimit - maximum number of points stored in the retry buffer
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - threadFactory
```
public BatchOptions threadFactory(java.util.concurrent.ThreadFactory threadFactory)
```
    Parameters:
    
    threadFactory - a ThreadFactory instance to be used
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - exceptionHandler
```
public BatchOptions exceptionHandler(java.util.function.BiConsumer<java.lang.Iterable<Point>,java.lang.Throwable> exceptionHandler)
```
    Parameters:
    
    exceptionHandler - a consumer function to handle asynchronous errors
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - consistency
```
public BatchOptions consistency(InfluxDB.ConsistencyLevel consistency)
```
    Parameters:
    
    consistency - cluster consistency setting (how many nodes have to store data points to treat a write as a success)
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - precision
```
public BatchOptions precision(java.util.concurrent.TimeUnit precision)
```
    Set the time precision to use for the whole batch. If unspecified, will default to TimeUnit.NANOSECONDS.
    
    Parameters:
    
    precision - sets the precision to use
    
    Returns:
    
    the BatchOptions instance to be able to use it in a fluent manner.
  - getActions
```
public int getActions()
```
    Returns:
    
    actions the number of actions to collect
  - getFlushDuration
```
public int getFlushDuration()
```
    Returns:
    
    flushDuration the time to wait at most (milliseconds).
  - getJitterDuration
```
public int getJitterDuration()
```
    Returns:
    
    batch flush interval jitter value (milliseconds)
  - getBufferLimit
```
public int getBufferLimit()
```
    Returns:
    
    Maximum number of points stored in the retry buffer, see bufferLimit(int)
  - getThreadFactory
```
public java.util.concurrent.ThreadFactory getThreadFactory()
```
    Returns:
    
    a ThreadFactory instance to be used
  - getExceptionHandler
```
public java.util.function.BiConsumer<java.lang.Iterable<Point>,java.lang.Throwable> getExceptionHandler()
```
    Returns:
    
    a consumer function to handle asynchronous errors
  - getConsistency
```
public InfluxDB.ConsistencyLevel getConsistency()
```
    Returns:
    
    cluster consistency setting (how many nodes have to store data points to treat a write as a success)
  - getPrecision
```
public java.util.concurrent.TimeUnit getPrecision()
```
    Returns:
    
    the time precision

Class BatchOptions

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_BATCH_ACTIONS_LIMIT

DEFAULT_BATCH_INTERVAL_DURATION

DEFAULT_JITTER_INTERVAL_DURATION

DEFAULT_BUFFER_LIMIT

DEFAULT_PRECISION

DEFAULTS

Method Detail

actions

flushDuration

jitterDuration

bufferLimit

threadFactory

exceptionHandler

consistency

precision

getActions

getFlushDuration

getJitterDuration

getBufferLimit

getThreadFactory

getExceptionHandler

getConsistency

getPrecision