blob: 79ee5088da1a7c62a8621e90668cb1ce433fc59f [file] [log] [blame]
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"></meta><title>QuerySplunkIndexingStatus</title><link rel="stylesheet" href="../../../../../css/component-usage.css" type="text/css"></link></head><script type="text/javascript">window.onload = function(){if(self==top) { document.getElementById('nameHeader').style.display = "inherit"; } }</script><body><h1 id="nameHeader" style="display: none;">QuerySplunkIndexingStatus</h1><h2>Description: </h2><p>Queries Splunk server in order to acquire the status of indexing acknowledgement.</p><p><a href="additionalDetails.html">Additional Details...</a></p><h3>Tags: </h3><p>splunk, logs, http, acknowledgement</p><h3>Properties: </h3><p>In the list below, the names of required properties appear in <strong>bold</strong>. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the <a href="../../../../../html/expression-language-guide.html">NiFi Expression Language</a>.</p><table id="properties"><tr><th>Display Name</th><th>API Name</th><th>Default Value</th><th>Allowable Values</th><th>Description</th></tr><tr><td id="name"><strong>Scheme</strong></td><td>Scheme</td><td id="default-value">https</td><td id="allowable-values"><ul><li>https</li><li>http</li></ul></td><td id="description">The scheme for connecting to Splunk.</td></tr><tr><td id="name"><strong>Hostname</strong></td><td>Hostname</td><td id="default-value">localhost</td><td id="allowable-values"></td><td id="description">The ip address or hostname of the Splunk server.<br/><strong>Supports Expression Language: true (will be evaluated using variable registry only)</strong></td></tr><tr><td id="name"><strong>HTTP Event Collector Port</strong></td><td>Port</td><td id="default-value">8088</td><td id="allowable-values"></td><td id="description">The HTTP Event Collector HTTP Port Number.<br/><strong>Supports Expression Language: true (will be evaluated using variable registry only)</strong></td></tr><tr><td id="name">Security Protocol</td><td>Security Protocol</td><td id="default-value">TLSv1_2</td><td id="allowable-values"><ul><li>TLSv1_2</li><li>TLSv1_1</li><li>TLSv1</li><li>SSLv3</li></ul></td><td id="description">The security protocol to use for communicating with Splunk.</td></tr><tr><td id="name">Owner</td><td>Owner</td><td></td><td id="allowable-values"></td><td id="description">The owner to pass to Splunk.<br/><strong>Supports Expression Language: true (will be evaluated using variable registry only)</strong></td></tr><tr><td id="name">HTTP Event Collector Token</td><td>Token</td><td></td><td id="allowable-values"></td><td id="description">HTTP Event Collector token starting with the string Splunk. For example 'Splunk 1234578-abcd-1234-abcd-1234abcd'<br/><strong>Supports Expression Language: true (will be evaluated using variable registry only)</strong></td></tr><tr><td id="name">Username</td><td>Username</td><td></td><td id="allowable-values"></td><td id="description">The username to authenticate to Splunk.<br/><strong>Supports Expression Language: true (will be evaluated using variable registry only)</strong></td></tr><tr><td id="name">Password</td><td>Password</td><td></td><td id="allowable-values"></td><td id="description">The password to authenticate to Splunk.<br/><strong>Sensitive Property: true</strong></td></tr><tr><td id="name"><strong>Splunk Request Channel</strong></td><td>request-channel</td><td></td><td id="allowable-values"></td><td id="description">Identifier of the used request channel.<br/><strong>Supports Expression Language: true (will be evaluated using variable registry only)</strong></td></tr><tr><td id="name"><strong>Maximum Waiting Time</strong></td><td>ttl</td><td id="default-value">1 hour</td><td id="allowable-values"></td><td id="description">The maximum time the processor tries to acquire acknowledgement confirmation for an index, from the point of registration. After the given amount of time, the processor considers the index as not acknowledged and transfers the FlowFile to the "unacknowledged" relationship.</td></tr><tr><td id="name"><strong>Maximum Query Size</strong></td><td>max-query-size</td><td id="default-value">10000</td><td id="allowable-values"></td><td id="description">The maximum number of acknowledgement identifiers the outgoing query contains in one batch. It is recommended not to set it too low in order to reduce network communication.</td></tr></table><h3>Relationships: </h3><table id="relationships"><tr><th>Name</th><th>Description</th></tr><tr><td>success</td><td>A FlowFile is transferred to this relationship when the acknowledgement was successful.</td></tr><tr><td>unacknowledged</td><td>A FlowFile is transferred to this relationship when the acknowledgement was not successful. This can happen when the acknowledgement did not happened within the time period set for Maximum Waiting Time. FlowFiles with acknowledgement id unknown for the Splunk server will be transferred to this relationship after the Maximum Waiting Time is reached.</td></tr><tr><td>undetermined</td><td>A FlowFile is transferred to this relationship when the acknowledgement state is not determined. FlowFiles transferred to this relationship might be penalized. This happens when Splunk returns with HTTP 200 but with false response for the acknowledgement id in the flow file attribute.</td></tr><tr><td>failure</td><td>A FlowFile is transferred to this relationship when the acknowledgement was not successful due to errors during the communication. FlowFiles are timing out or unknown by the Splunk server will transferred to "undetermined" relationship.</td></tr></table><h3>Reads Attributes: </h3><table id="reads-attributes"><tr><th>Name</th><th>Description</th></tr><tr><td>splunk.acknowledgement.id</td><td>The indexing acknowledgement id provided by Splunk.</td></tr><tr><td>splunk.responded.at</td><td>The time of the response of put request for Splunk.</td></tr></table><h3>Writes Attributes: </h3>None specified.<h3>State management: </h3>This component does not store state.<h3>Restricted: </h3>This component is not restricted.<h3>Input requirement: </h3>This component requires an incoming relationship.<h3>System Resource Considerations:</h3>None specified.<h3>See Also:</h3><p><a href="../org.apache.nifi.processors.splunk.PutSplunkHTTP/index.html">PutSplunkHTTP</a></p></body></html>