Integrate and extend your AirVantage platform
This overview describes what you can do with the AirVantage Firehose Cloud Connector via a simple use case: Connecting your system to AWS Kinesis Firehose and accessing the raw data directly in the data store you specified (S3, redshift, Elasticsearch Service, etc.).
This section explains when and why to use this cloud connector, what it is, and the available options. To learn more about Kinesis Firehose see the AWS documentation web site .
The Kinesis Firehose Cloud Connector provides the follow capabilities:
When you connect AirVantage to Kinesis Firehose Streams, you have to define the type of notifications you want: operations, data, alerts, or usages.
This section explains how to configure your client to be robust, reliable, and secure. Please read this section carefully and provide the correct information to enable the end point on the AirVantage side.
Set up an Amazon Web Services account here .
The role describes the rights (called policies) allowed for an AWS account on a specific object (here, a Kinesis Firehose).
In the schema on the right, we created an airvantageKinesisProducer role applied to an AirVantage AWS account for a given company defined by the company
uid in the SecretKey.
Allowed policies are those which allow push messages in the stream and the last parameter defines the Kinesis Firehose to use.
Step 1. Create a Kinesis Firehose in the customer’s AWS account, into which AirVantage will publish.
The source must be set to Direct Put to allow AirVantage to push data directly in a Firehose.
Be careful! There is a charge for using Kinesis Firehose resources. So before creating your stream, calculate the number of shards you need according to the quantity of data you handle and estimate your corresponding bill.
When creating a Firehose, AWS creates a role called
firehose_delivery_rolefor you. Don’t use it with any external account:
firehose_delivery_rolegives access to Redshift, S3, or ElasticSearch.
Step 2. Create a Role in the customer’s AWS account:
Inline policies: The role’s Policy should only allow Sierra to write into the Firehose (firehose:PutRecord, firehose:PutRecordBatch).
Step 3. Supply the following information using the CRM
You can check that the data received from AirVantage shows up in the stream monitoring provided by Amazon. Use the Put Record Requests graph to verify that your Firehose is connected to AirVantage. If no data is shown, you need to check your configuration.
To get the data, refer to the AWS documentation corresponding to the destination storage you have selected: