Splunk® Data Stream Processor

Function Reference

Acrobat logo Download manual as PDF


DSP 1.2.0 is impacted by the CVE-2021-44228 and CVE-2021-45046 security vulnerabilities from Apache Log4j. To fix these vulnerabilities, you must upgrade to DSP 1.2.4. See Upgrade the Splunk Data Stream Processor to 1.2.4 for upgrade instructions.

On October 30, 2022, all 1.2.x versions of the Splunk Data Stream Processor will reach its end of support date. See the Splunk Software Support Policy for details.
Acrobat logo Download topic as PDF

Get data from Ingest service

Use the Ingest Service source function to get data from the Ingest service. This is a source function that filters your data to only ingest data from the Ingest service. For information on how to send data to the using the Ingest service, see Use the Ingest service to send test events to your pipeline.

Function output schema

This function outputs data pipeline events using the Event schema for events or Metrics schema for metrics.

Required arguments

connection_id
Syntax: string
Description: The ID of your Ingest service connection. Must be set to rest_api:all.
Example: "rest_api:all"

Optional arguments

initial_position
Syntax: LATEST | TRIM_HORIZON
Description: The position in the data stream where you want to start reading data. Defaults to LATEST.
  • LATEST: Start reading data from the latest position on the data stream.
  • TRIM_HORIZON: Start reading data from the very beginning of the data stream.
Example: "LATEST"

SPL2 example

When working in the SPL View, you can write the function using arguments in this exact order.

| from ingest_rest_api("rest_api:all", "TRIM_HORIZON") |... ;

Alternatively, you can use named arguments to declare arguments in any order. The following SPL2 example uses named arguments to specify the initial_position argument before the connection_id argument.

| from ingest_rest_api(initial_position: "TRIM_HORIZON", connection_id: "rest_api:all") |... ;

Limitations of the Ingest service

The maximum supported size for a record is 5MB. If any records exceed that size, the Ingest service returns an error.

Last modified on 19 February, 2021
PREVIOUS
Get data from Forwarders service
  NEXT
Get data from Amazon CloudWatch

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, 1.3.0, 1.3.1, 1.4.0, 1.4.1, 1.4.2, 1.4.3


Was this documentation topic helpful?


You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters