Amazon Kinesis Service Actions

Using Site24x7's IT automation framework, you can create an action profile to stop or start your analytics application. You can set up to automatically trigger the automation by mapping it with a threshold or an alert event type (Up, Down and Trouble), or you can call the APIs directly by manually invoking the action from the Site24x7 console.

Required Permissions

Please make sure the IAM role assumed by Site24x7 or the IAM user created for Site24x7 has the following partial write actions in the attached policy document to perform the actions.

• kinesisanalytics:StopApplication
• kinesisanalytics:StartApplication

Constraints

• For you to start an application, the application must be monitored by Site24x7 and the status must be READY.
• Also, you can stop an application only if it is in the running state.

Create an action profile

• Login to the Site24x7 web console, select Admin > IT Automation
• Click on Add Automation and select Start/Stop Kinesis Analytics Application as the type by clicking on the drop down.
• Type in an unique name in the Display Name field
• Click on the drop down and select the action to be performed (Viz. Start or stop)
• Next, select the analytics application(s) where you want the action to be performed. (If you choose the option $LOCALHOST the operation would be performed on all those analytics applications where the automation profile is mapped)
• Max Allowed Action Execution Time: The maximum number of seconds Site24x7 has to wait before the request times out. The execution time is set at 15 seconds, by default. You can define an execution time between 1-90 seconds.
• Send the Automation Result via Email: You can choose to receive an email regarding the automation result, by setting the toggle button to Yes
• Save the profile.

Simulate the Automation

Before mapping the action profile, you can test it's functionality by invoking the action manually within the Site24x7 console or by using our REST APIs. Once you've created the profile, navigate back to the IT Automation summary page (Admin > IT Automation) and click on the  to execute a test run.

Map the Action Profile

To execute the automation, map the action profile to an desired alert event. You can either map the profile to a predefined monitor level event type (Up/Down/trouble) or to an custom attribute level event type(Number of records read drops below 10).

Monitor level mapping

Navigate to the Edit monitor page of the monitored analytics application (“Kinesis Analytics monitor list page" > Application > > Edit) , and map the action profile with any of the following monitor status changes.

• Execute on Down
• Execute on Up
• Execute on Trouble
• Execute on any Status Change

Attribute level mapping

You can also associate the action profile to a related performance metric like bytes read/records read or to the metric data points of kinesis data stream or firehose delivery stream. Navigate to the Edit threshold profile page of the monitored analytics application (Navigate to the Edit Monitor page of the resource > click on the Pencil icon adjacent to the Threshold and Availability field) and map the profile to any desired attribute by clicking on the  "Select Automation to Execute" field.

Use case

For an analytics application you are charged hourly based on the average number of consumed Kinesis Processing Units (KPUs). To keep you costs in check you can create a mapping in such a way that, whenever the number of outgoing records on your source stream drops below a certain value an automated action to stop your application is triggered.