Skip to content

Latest commit

 

History

History
124 lines (76 loc) · 5.46 KB

services-cloudwatchevents-tutorial.md

File metadata and controls

124 lines (76 loc) · 5.46 KB

Tutorial: Using AWS Lambda with scheduled events

In this tutorial, you do the following:

  • Create a Lambda function using the lambda-canary blueprint. You configure the Lambda function to run every minute. Note that if the function returns an error, AWS Lambda logs error metrics to CloudWatch.
  • Configure a CloudWatch alarm on the Errors metric of your Lambda function to post a message to your Amazon SNS topic when AWS Lambda emits error metrics to CloudWatch. You subscribe to the Amazon SNS topics to get email notification. In this tutorial, you do the following to set this up:
    • Create an Amazon SNS topic.
    • Subscribe to the topic so you can get email notifications when a new message is posted to the topic.
    • In Amazon CloudWatch, set an alarm on the Errors metric of your Lambda function to publish a message to your SNS topic when errors occur.

Prerequisites

This tutorial assumes that you have some knowledge of basic Lambda operations and the Lambda console. If you haven't already, follow the instructions in Getting started with AWS Lambda to create your first Lambda function.

Create a Lambda function

  1. Sign in to the AWS Management Console and open the AWS Lambda console at https://console.aws.amazon.com/lambda/.

  2. Choose Create function.

  3. Choose Blueprints.

  4. Enter canary in the search bar. Choose the lambda-canary blueprint, and then choose Configure.

  5. Configure the following settings.

    • Name – lambda-canary.
    • Role – Create a new role from one or more templates.
    • Role name – lambda-apigateway-role.
    • Policy templates – Simple microservice permissions.
    • Rule – Create a new rule.
    • Rule name – CheckWebsiteScheduledEvent.
    • Rule description – CheckWebsiteScheduledEvent trigger.
    • Schedule expression – rate(1 minute).
    • Enabled – True (checked).
    • Environment variables

  6. Choose Create function.

CloudWatch Events emits an event every minute, based on the schedule expression. The event triggers the Lambda function, which verifies that the expected string appears in the specified page. For more information on expressions schedules, see Schedule expressions using rate or cron.

Test the Lambda function

Test the function with a sample event provided by the Lambda console.

  1. Open the Lambda console Functions page.

  2. Choose lambda-canary.

  3. Next to the Test button at the top of the page, choose Configure test events from the drop-down menu.

  4. Create a new event using the CloudWatch Events event template.

  5. Choose Create.

  6. Choose Test.

The output from the function execution is shown at the top of the page.

Create an Amazon SNS topic and subscribe to it

Create an Amazon Simple Notification Service (Amazon SNS) topic to receive notifications when the canary function returns an error.

To create a topic

  1. Open the Amazon SNS console.

  2. Choose Create topic.

  3. Create a topic with the following settings.

    • Name – lambda-canary-notifications.
    • Display name – Canary.

  4. Choose Create subscription.

  5. Create a subscription with the following settings.

    • Protocol – Email.
    • Endpoint – Your email address.

Amazon SNS sends an email from Canary <[email protected]>, reflecting the friendly name of the topic. Use the link in the email to confirm your address.

Configure an alarm

Configure an alarm in Amazon CloudWatch that monitors the Lambda function and sends a notification when it fails.

To create an alarm

  1. Open the CloudWatch console.

  2. Choose Alarms.

  3. Choose Create alarm.

  4. Choose Alarms.

  5. Create an alarm with the following settings.

    • Metrics – lambda-canary Errors.

      Search for lambda canary errors to find the metric.

    • Statistic – Sum.

      Choose the statistic from the drop-down menu above the preview graph.

    • Name – lambda-canary-alarm.

    • Description – Lambda canary alarm.

    • Threshold – **Whenever Errors is >=**1.

    • Send notification to – lambda-canary-notifications.

Test the alarm

Update the function configuration to cause the function to return an error, which triggers the alarm.

To trigger an alarm

  1. Open the Lambda console Functions page.

  2. Choose lambda-canary.

  3. Under Environment variables, choose Edit.

  4. Set expected to 404.

  5. Choose Save.

Wait a minute, and then check your email for a message from Amazon SNS.