Send data to Amazon Kinesis Data Streams
Use the Send to Amazon Kinesis Data Streams sink function to send data to Amazon Kinesis Data Streams.
Optionally, you can specify the Kinesis partition key for each record. If you do not provide a partition key, a hash of the payload determines the partition key.
Before you can use this function, you must create a connection. See Create a connection to Amazon Kinesis Data Streams in the Connect to Data Sources and Destinations with the manual. When configuring this sink function, set the
connection_id argument to the ID of that connection.
Function input schema
Accepts records with any specific schema, but the event body or payload of the incoming records must be serialized as bytes.
- Syntax: string
- Description: The ID of the Amazon Kinesis Data Streams connection you must create before using this function.
- Example in Canvas View: "conx-2b39464e-0924"
- Syntax: string
- Description: The name of the Kinesis stream to send data to.
- Example in Canvas View: "my-stream-123"
- Syntax: expression<bytes>
- Description: The field containing the event body or payload to send to Kinesis. You can specify the name of a field that's serialized as bytes or provide an expression that converts a field into bytes.
- Example in Canvas View: to_bytes(cast(body, "string"))
- Syntax: expression<string>
- Description: Your Kinesis partition key. See the AWS documentation about partition keys. Defaults to null.
- Example in Canvas View: "my-partition-key"
When working in the SPL View, you can write the function by providing the arguments in this exact order.
...| into kinesis("879837b0-cabf-4bc2-8589-fcc4dad753e7", "my-stream-123", to_bytes(cast(body, "string")));
Alternatively, you can use named arguments to declare the arguments in any order and leave out optional arguments you don't want to declare. All unprovided arguments use their default values. The following example provides the arguments in an arbitrary order.
...| into kinesis(stream_name: "my-stream-123", connection_id: "879837b0-cabf-4bc2-8589-fcc4dad753e7", body: to_bytes(cast(body, "string")));
If you want to use a mix of unnamed and named arguments in your functions, you need to list all unnamed arguments in the correct order before providing the named arguments.
Send data to a Splunk index (Default for Environment)
Send data to Amazon S3
This documentation applies to the following versions of Splunk® Data Stream Processor: 1.2.0, 1.2.1