Splunk
A Splunk handler sends messages to a Splunk service.
To enable the Splunk handler, see "Configure a Custom Access Log". The JSON configuration file for the Splunk handler has the following format:
{
"class": "org.forgerock.audit.handlers.splunk.SplunkAuditEventHandler",
"config": {
"name": string, // Handler name, such as "splunk".
"enabled": boolean, // Is the handler enabled?
"topics": array, // LDAP: "ldap-access"; HTTP: "http-access".
"authzToken": string, // Splunk authorization token for HTTP requests.
"buffering": { // Required message buffering configuration.
"maxBatchedEvents": number, // Maximum messages in prepared statement.
"maxSize": number, // Maximum number of buffered messages.
"writeInterval": duration // Duration as described below.
},
"connection": { // (Optional) Default: Use default settings.
"host": string, // Splunk hostname. Default: "localhost".
"port": number, // Splunk port number. Default: "8088".
"useSSL": boolean // Use secure connection to Splunk? Default: false.
}
}
}
For a sample configuration, see opendj/config/audit-handlers/splunk-config.json-example
.
The writeInterval
takes a duration, which is a lapse of time expressed in English, such as 23 hours 59 minutes and 59 seconds
. Durations are not case sensitive. Negative durations are not supported. Durations use these units:
indefinite
,infinity
,undefined
,unlimited
: unlimited durationzero
,disabled
: zero-length durationdays
,day
,d
: dayshours
,hour
,h
: hoursminutes
,minute
,min
,m
: minutesseconds
,second
,sec
,s
: secondsmilliseconds
,millisecond
,millisec
,millis
,milli
,ms
: millisecondsmicroseconds
,microsecond
,microsec
,micros
,micro
,us
: microsecondsnanoseconds
,nanosecond
,nanosec
,nanos
,nano
,ns
: nanoseconds