Testing Your Delivery Stream Using Sample Data - Amazon Kinesis Data Firehose
PrerequisitesTest Using Amazon S3 as the DestinationTest Using Amazon Redshift as the DestinationTest Using OpenSearch Service as the DestinationTest Using Splunk as the Destination
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Testing Your Delivery Stream Using Sample Data

You can use the Amazon Web Services Management Console to ingest simulated stock ticker data. The console runs a script in your browser to put sample records in your Kinesis Data Firehose delivery stream. This enables you to test the configuration of your delivery stream without having to generate your own test data.

The following is an example from the simulated data:

{"TICKER_SYMBOL":"QXZ","SECTOR":"HEALTHCARE","CHANGE":-0.05,"PRICE":84.51}

Note that standard Amazon Kinesis Data Firehose charges apply when your delivery stream transmits the data, but there is no charge when the data is generated. To stop incurring these charges, you can stop the sample stream from the console at any time.

Prerequisites

Before you begin, create a delivery stream. For more information, see Creating an Amazon Kinesis Data Firehose Delivery Stream.

Test Using Amazon S3 as the Destination

Use the following procedure to test your delivery stream using Amazon Simple Storage Service (Amazon S3) as the destination.

To test a delivery stream using Amazon S3

  1. Open the Kinesis Data Firehose console at https://console.amazonaws.cn/firehose/.

  2. Choose the delivery stream.

  3. Under Test with demo data, choose Start sending demo data to generate sample stock ticker data.

  4. Follow the onscreen instructions to verify that data is being delivered to your S3 bucket. Note that it might take a few minutes for new objects to appear in your bucket, based on the buffering configuration of your bucket.

  5. When the test is complete, choose Stop sending demo data to stop incurring usage charges.

Test Using Amazon Redshift as the Destination

Use the following procedure to test your delivery stream using Amazon Redshift as the destination.

To test a delivery stream using Amazon Redshift

  1. Your delivery stream expects a table to be present in your Amazon Redshift cluster. Connect to Amazon Redshift through a SQL interface and run the following statement to create a table that accepts the sample data.

    create table firehose_test_table
(
	TICKER_SYMBOL varchar(4),
	SECTOR varchar(16),
	CHANGE float,
	PRICE float
);

  2. Open the Kinesis Data Firehose console at https://console.amazonaws.cn/firehose/.

  3. Choose the delivery stream.

  4. Edit the destination details for your delivery stream to point to the newly created firehose_test_table table.

  5. Under Test with demo data, choose Start sending demo data to generate sample stock ticker data.

  6. Follow the onscreen instructions to verify that data is being delivered to your table. Note that it might take a few minutes for new rows to appear in your table, based on the buffering configuration.

  7. When the test is complete, choose Stop sending demo data to stop incurring usage charges.

  8. Edit the destination details for your Kinesis Data Firehose delivery stream to point to another table.

  9. (Optional) Delete the firehose_test_table table.

Test Using OpenSearch Service as the Destination

Use the following procedure to test your delivery stream using Amazon OpenSearch Service as the destination.

To test a delivery stream using OpenSearch Service

  1. Open the Kinesis Data Firehose console at https://console.amazonaws.cn/firehose/.

  2. Choose the delivery stream.

  3. Under Test with demo data, choose Start sending demo data to generate sample stock ticker data.

  4. Follow the onscreen instructions to verify that data is being delivered to your OpenSearch Service domain. For more information, see Searching Documents in an OpenSearch Service Domain in the Amazon OpenSearch Service Developer Guide.

  5. When the test is complete, choose Stop sending demo data to stop incurring usage charges.

Test Using Splunk as the Destination

Use the following procedure to test your delivery stream using Splunk as the destination.

To test a delivery stream using Splunk

  1. Open the Kinesis Data Firehose console at https://console.amazonaws.cn/firehose/.

  2. Choose the delivery stream.

  3. Under Test with demo data, choose Start sending demo data to generate sample stock ticker data.

  4. Check whether the data is being delivered to your Splunk index. Example search terms in Splunk are sourcetype="aws:firehose:json" and index="name-of-your-splunk-index". For more information about how to search for events in Splunk, see Search Manual in the Splunk documentation.

    If the test data doesn't appear in your Splunk index, check your Amazon S3 bucket for failed events. Also see Data Not Delivered to Splunk.

  5. When you finish testing, choose Stop sending demo data to stop incurring usage charges.