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.
Get data from Forwarders service | 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, 1.4.4, 1.4.5
Feedback submitted, thanks!