com.splunk

Class DistributedConfiguration

java.lang.Object

com.splunk.Resource

com.splunk.Entity

com.splunk.DistributedConfiguration

All Implemented Interfaces:

Map<String,Object>

public class DistributedConfiguration
extends Entity

The DistributedConfiguration class represents a Splunk distributed search configuration, providing access to Splunk's distributed search options.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields inherited from class com.splunk.Entity

content, toUpdate

Fields inherited from class com.splunk.Resource

actions, path, refreshArgs, service, title, updated

Method Summary

Modifier and Type	Method and Description
protected String	actionPath(String action) Returns the action path.
void	disable() Disable distributed search on this Splunk instance.
void	enable() Enable distributed search on this Splunk instance.
String	getBlacklistNames() Returns a list of server names that are excluded from being peers.
String	getBlacklistUrls() Returns a list of server URLs that are excluded from being peers.
int	getCheckTimedOutServersFrequency() Returns the frequency at which servers that have timed out are rechecked.
int	getConnectionTimeout() Returns the time-out period for connecting to search peers.
int	getReceiveTimeout() Returns the time-out period for trying to read and receive data from a search peer.
boolean	getRemovedTimedOutServers() Indicates whether timed-out servers are removed from the distributed configuration.
int	getSendTimeout() Returns the time-out period for trying to write or send data to a search peer.
String	getServers() Returns a list of peer servers.
boolean	getShareBundles() Indicates whether this server uses bundle replication to share search-time configuration with search peers.
int	getStatusTimeout() Returns the time-out period for gathering a search peer's basic information.
boolean	isDistSearchEnabled() Indicates whether distributed search is enabled.
void	setBlacklistNames(String names) Sets the blacklist server names that are excluded from being peers.
void	setBlacklistURLs(String names) Sets the blacklist server names or URIs that are excluded from being peers.
void	setCheckTimedOutServersFrequency(int frequency) Sets the server recheck frequency.
void	setConnectionTimeout(int seconds) Sets the time-out period for establishing a search peer connection.
void	setDisabled(boolean disabled) Sets whether the distributed configuration is enabled or disabled.
void	setReceiveTimeout(int seconds) Sets the time-out period for reading and receiving data from a search peer.
void	setRemoveTimedOutServers(boolean removeTimedOutServers) Sets whether to remove a server connection that cannot be made within the time-out period specified by connectionTimeout, sendTimeout, or receiveTimeout.
void	setSendTimeout(int seconds) Sets the time-out period for writing and sending data to a search peer.
void	setServers(String servers) Sets the initial peer server list.
void	setShareBundles(boolean shareBundles) Sets whether this server uses bundle replication to share search-time configuration with search peers.
void	setStatusTimeout(int seconds) Sets the time-out period for connecting to a search peer for getting its basic information.

Methods inherited from class com.splunk.Entity

clear, containsKey, containsValue, entrySet, get, getContent, getMetadata, isDisabled, isEmpty, isNameChangeAllowed, keySet, put, putAll, refresh, remove, remove, size, update, update, validate, values

Methods inherited from class com.splunk.Resource

getName, getPath, getService, getTitle, getUpdated, invalidate

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Method Detail

actionPath

protected String actionPath(String action)

Returns the action path.

Overrides:

actionPath in class Entity

Parameters:

action - The requested action.

Returns:

The action path.

disable

public void disable()

Disable distributed search on this Splunk instance. Requires restarting Splunk before it takes effect.

Overrides:

disable in class Entity

enable

public void enable()

Enable distributed search on this Splunk instance. Requires restarting Splunk before it takes effect.

Overrides:

enable in class Entity

getBlacklistNames

public String getBlacklistNames()

Returns a list of server names that are excluded from being peers.

Returns:

A comma-separated list of excluded servers by name, or null if not available.

getBlacklistUrls

public String getBlacklistUrls()

Returns a list of server URLs that are excluded from being peers.

Returns:

A comma-separated list of excluded servers by URL in the format "x.x.x.x:port", or null if not available.

getConnectionTimeout

public int getConnectionTimeout()

Returns the time-out period for connecting to search peers.

Returns:

The connection time-out period, in seconds, or -1 if not specified.

getCheckTimedOutServersFrequency

public int getCheckTimedOutServersFrequency()

Returns the frequency at which servers that have timed out are rechecked. If removeTimedOutServers is false, this setting has no effect.

Returns:

The frequency, in seconds, to recheck timed-out servers. If 0, servers are not rechecked. The default is 60 seconds.

getReceiveTimeout

public int getReceiveTimeout()

Returns the time-out period for trying to read and receive data from a search peer.

Returns:

The receive time-out period, in seconds, or -1 if not specified.

getRemovedTimedOutServers

public boolean getRemovedTimedOutServers()

Indicates whether timed-out servers are removed from the distributed configuration.

Returns:

true if timed-out servers are removed from the distributed configuration, false if not.

getSendTimeout

public int getSendTimeout()

Returns the time-out period for trying to write or send data to a search peer.

Returns:

The send time-out period, in seconds, or -1 if not specified.

getServers

public String getServers()

Returns a list of peer servers.

Returns:

The comma-separated list of peer servers, or null if not available.

getShareBundles

public boolean getShareBundles()

Indicates whether this server uses bundle replication to share search-time configuration with search peers.

Note: If set to false, the search head assumes that the search peers can access the correct bundles using an NFS share.

Returns:

true if this server uses bundle replication, false if not.

getStatusTimeout

public int getStatusTimeout()

Returns the time-out period for gathering a search peer's basic information.

Returns:

The time-out period, in seconds.

See Also:

ServiceInfo

isDistSearchEnabled

public boolean isDistSearchEnabled()

Indicates whether distributed search is enabled.

Returns:

true if distributed search is enabled, false if disabled.

setBlacklistNames

public void setBlacklistNames(String names)

Sets the blacklist server names that are excluded from being peers.

Parameters:

names - A comma-separated list of server names.

setBlacklistURLs

public void setBlacklistURLs(String names)

Sets the blacklist server names or URIs that are excluded from being peers. The format for a URI is "x.x.x.x:port".

Parameters:

names - A comma-separated list of server names or URIs.

setCheckTimedOutServersFrequency

public void setCheckTimedOutServersFrequency(int frequency)

Sets the server recheck frequency.

Note: This attribute is only relevant when removeTimedOutServers is set to true--otherwise, this attribute is ignored.

Parameters:

frequency - The server recheck frequency, in seconds. If set to 0, a recheck does not occur.

See Also:

getRemovedTimedOutServers()

setConnectionTimeout

public void setConnectionTimeout(int seconds)

Sets the time-out period for establishing a search peer connection.

Parameters:

seconds - The connection time-out period, in seconds.

setDisabled

public void setDisabled(boolean disabled)

Sets whether the distributed configuration is enabled or disabled.

Note: Using this method requires you to restart Splunk before this setting takes effect. To avoid restarting Splunk, use the Entity.disable and Entity.enable methods instead, which take effect immediately.

Parameters:

disabled - true to disabled to deployment client, false to enable.

See Also:

Entity.disable(), Entity.enable()

setReceiveTimeout

public void setReceiveTimeout(int seconds)

Sets the time-out period for reading and receiving data from a search peer.

Parameters:

seconds - The receive time-out period, in seconds.

setRemoveTimedOutServers

public void setRemoveTimedOutServers(boolean removeTimedOutServers)

Sets whether to remove a server connection that cannot be made within the time-out period specified by connectionTimeout, sendTimeout, or receiveTimeout. If false, every call to that server attempts to connect, which might result in a slow user interface.

Parameters:

removeTimedOutServers - true to remove timed-out server connections, false to attempt every call to the server.

See Also:

setConnectionTimeout(int), setSendTimeout(int), setReceiveTimeout(int)

setSendTimeout

public void setSendTimeout(int seconds)

Sets the time-out period for writing and sending data to a search peer.

Parameters:

seconds - The send time-out period, in seconds.

setServers

public void setServers(String servers)

Sets the initial peer server list. You don't need to set servers here if you are operating completely in autoAddServers mode (discovered servers are automatically added).

Parameters:

servers - A comma-separated list of peer servers.

setShareBundles

public void setShareBundles(boolean shareBundles)

Sets whether this server uses bundle replication to share search-time configuration with search peers. If set to false, the search head assumes that the search peers can access the correct bundles using an NFS share and have correctly configured the options for mounted_bundles and bundles_location in the distsearch.conf file.

Parameters:

shareBundles - true to share search-time configuration with peers, false if not.

setStatusTimeout

public void setStatusTimeout(int seconds)

Sets the time-out period for connecting to a search peer for getting its basic information.

Parameters:

seconds - The connection time-out period, in seconds.

See Also:

ServiceInfo