Process data from a universal forwarder in DSP
The Splunk universal forwarder sends unparsed data, which means that the data is sent into the in 64-kilobyte blocks. As a result, events that are too long might get truncated, and multiple events might be grouped together as one event. In addition, when DSP receives data from a universal forwarder, the timestamp used is the time when the event was ingested.
Use the Splunk universal forwarder pipeline template to process the data in the following ways:
- Split the incoming stream of data into separate lines based on the location of a timestamp in the event body.
- Merge the separated lines into events.
- Extract the timestamp from the event body and use the extracted value as the timestamp of the event itself.
Prerequisites
Before you can process universal forwarder data in DSP, you must configure the universal forwarder to send data to DSP. See Create a connection between a Splunk forwarder and the Forwarders service.
Steps
- From the Data Stream Processor home page, click Build Pipeline and then select the Splunk universal forwarder template.
This template creates a pipeline that reads data from Splunk forwarders, does the appropriate processing required by the universal forwarder data source, and sends the data to themain
index of the preconfigured Splunk Enterprise instance associated with the Data Stream Processor. - To check if your events are passing through your pipeline as expected, do the following:
- Click More Options (...) and select Validate.
- Click Start Preview.
- (Optional) Verify that your data is successfully being broken up into events by clicking through each function in the pipeline.
- Click the Apply Line Break function to verify that your events are being split and stitched back together properly. The template uses the auto setting for this function, which breaks events based on the location of timestamps in the event body, merges any additional text after the timestamp into the same event, and creates a new event when another timestamp is detected. Timestamps are detected using DSP's built-in timestamp rules.
- Click the Apply Timestamp Extraction function to verify that your timestamps are being extracted from your event's body properly. By default, the Apply Timestamp Extraction function uses the built-in timestamp rules from DSP and the
datetime.xml
file from the Splunk instance to detect and extract timestamps. These extracted timestamps are then used as thetimestamp
value.
- Once you've confirmed that your universal forwarder events are being processed in DSP as desired, click More Options (...) and select Save As.
- Give your pipeline a name and a description, and select Pipeline from the Save As drop-down list.
- (Optional) Continue adding functions to your pipeline to add further transformations to your events.
You now have a pipeline that performs the necessary transformations on universal forwarder events for DSP.
Allow DSP users to use the Forwarders service | Connecting your DSP pipeline to a Splunk index |
This documentation applies to the following versions of Splunk® Data Stream Processor: 1.2.0, 1.2.1-patch02, 1.2.1, 1.2.2-patch02, 1.2.4, 1.2.5
Feedback submitted, thanks!