# AWS Lambda Check * 1\. Intro to Lambda Computing * Use Case for an AWS Lambda check. * Powerful: AWS Lambda has many runtimes available. * Other Reasons to Use the AWS Lambda check * AWS SDK for Python (Boto3) * Lambda Check Overview * 2\. Coding Lambda * Import Libraries * Define the Main Function * Scripting the Check * The finished script * Running the check * 3\. AWS Setup * Get into the AWS Lambda Service * Create New Lambda Function * Configure the Function * Permissions * Create Function * Import Your Script * Create Test Event * Deploy the AWS Changes, Test * Edit Runtime Handler * Test * 4\. Adding a JSON Event * Add an Event Field * 5\. ASM Check Creation * Step 1: Name, Description, and Tags * Step 2a: Command and location * Step 2b: Command and location * Step 3: Interval, Thresholds, & Monitor Groups * Create check * 6\. Run Result ## 1. Intro to Lambda Computing This page is a step-by-step guide to using the AWS Lambda check type. From [What is AWS Lambda?](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) Lambda is a compute service that lets you run code without provisioning or managing servers. Lambda runs your code on a high-availability compute infrastructure and performs all of the administration of the compute resources, including server and operating system maintenance, capacity provisioning and automatic scaling, code monitoring, and logging. You can run code for virtually any application or back-end service with Lambda. All you need to do is supply your code in one of the [languages that Lambda supports](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html). ### Use Case for an AWS Lambda check. #### Powerful: AWS Lambda has many runtimes available. AWS Lambda functionality adds flexibility to the [Apica Scripted Checks](https://apica-kb.atlassian.net/wiki/spaces/A2/pages/2002649089). The Scripted Check Options have a pre-selected set of Runtime languages, listed below. Select the ***Run AWS Lambda*** icon for additional languages beyond these to develop checks from language resources you already may have. | **Apica's Scripted Checks** | **Amazon Web Services Lambda Runtimes** | | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | | | With AWS Lambda, you could use any one of these services to create your new ASM check. Additionally, you can use [Lambda container images](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html) to provide your Elastic Container, the runner for this check. #### Other Reasons to Use the AWS Lambda check Example: You have a very secure Virtual Private Cloud where no traffic is allowed inside, and perhaps you don't want to use a private Apicanet agent. You can spawn your Lambda execution inside your secure VPC and take full advantage of the AWS permissions model. You could use it to give your Lambda access to additional services such as databases or an AWS secret store. #### AWS SDK for Python (Boto3) Get started quickly using AWS with [Boto3](https://github.com/boto/boto3), the AWS SDK for Python. Boto3 makes it easy to integrate your Python application, library, or script with AWS services, including Amazon S3, Amazon EC2, Amazon DynamoDB, and more. In our next section, we'll step through writing a very simple Python Lambda. And we will then add it into our ASM account and then run it and see the results. ## Lambda Check Overview 1. Establish an [AWS Lambda Account](https://aws.amazon.com/lambda/). 2. Prepare by importing the Libraries your script will need. 3. Create the AWS Lambda Function, which the ASM Check will call for execution. 1. Define the Main Functions of the script. 2. Script the check. (Note: You could use a [Scripted Check](https://apica-kb.atlassian.net/wiki/spaces/A2/pages/2002649089) here.) 3. Create a New Lambda Function. 4. Import Your Script into that Lambda Function. 4. Create the Lambda Event that ASM will display. 5. Create the AWS Lambda Check on any ASM-supported AWS Regions on the Apica Monitoring Platform. 6. Collect, compare and analyze the ASM Check Results OR send the results to integrated systems that use ASM as a data source. ## 2. Coding Lambda For this AWS Lambda example, we will use Python to create the code for our cloud function. This example will be a simple Lambda; we will not be importing any libraries other than the default Python libraries. Our goal is to create a check that returns a random value. It appears simplistic, but this is to provide an example of creating a Lambda.
StepScreenshot

Import Libraries

Import random because we need a random number.

Import time because we're going to need to know the start and end times of our check execution for our check.

import random
import time

Define the Main Function

We must keep track of the name of the main function. It needs to receive two things:

  1. An event
  2. A context.

These objects are passed from AWS Lambda when we configure it later.

def main(event, context):

Scripting the Check

This script will generate the dictionary, a list of values we will measure for further analysis.

  • Generate a random value (rand_value) between 0 and 100.
  • Create json_value that will capture all the defined return values that we want: Return Code, time

The expandable JSON result format will allow us to present a message with the generated random value, a unit of time measurement (milliseconds), and a Lambda function (set to True).

Important: if you've created a scripted check before, all you need to do is put the same thing into a Lambda.

rand_value = random.randint(0, 100)

    json_value = {
        "returncode": 0,
        "start_time": time.time (),
        "end_time": time.time(),
        "message": f'Random value: {rand_value}.',
        "unit": "ms",
        "value": rand_value,
        “lambda": True
    }

The finished script

def main(event, context):
    rand_value = random.randint(0, 100)
    json_value = {
        "returncode": 0,
        "start_time": time.time (),
        "end_time": time.time(),
        "message": f'Random value: {rand_value}.',
        "unit": "ms",
        "value": rand_value,
        “lambda": True
    }
    return json_value

if **name** == "**main**":
main('', '')

Running the check

The returned dictionary script finished here with an exit code of 0 but nothing else. But when we upload this to Lambda, we'll show you how to test it and make sure that everything is okay.

To add and use additional libraries in AWS Lambda, for example, add some additional Python packages, here's [a link that may get you started](https://aws.amazon.com/premiumsupport/knowledge-center/cloud9-deploy-lambda-external-libraries/#:~:text=Import%20the%20external%20libraries%27%20modules%20to%20your%20Lambda,pane%2C%20choose%20Environment.%20The%20Environment%20window%20opens.%204.). The AWS SDK for Python, [Boto3](https://aws.amazon.com/sdk-for-python/), is already included with your Python Lambda. And the next step is uploading our script into AWS. ## 3. AWS Setup Here, we will create the function, which will be called by our check inside the Amazon AWS UI. | **Step** | **Screenshot** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | |

Get into the AWS Lambda Service

Log into your Amazon account enter Lambda in the Search field. If you have visited Lambda earlier, there should be a shortcut.

|

| |

Create New Lambda Function

Click Create Function.

| | |

Configure the Function

| | |

Permissions

(Optional) Set your Lambda function to run with specific permissions for a specific existing (or new) role that has the rights that it needs to run correctly.

|

For example, if the function needs to access a relational database or other Amazon services, this is where you would set that.

| |

Create Function

Click Create Function.

Here's our DemoFunction with an AWS-created default/placeholder function called lambda handler.

| | |

Import Your Script

Paste the Script Code into the DefaultFunction section

Note: if you press test now, you'll get an error because we are not ready.

| | |

Create Test Event

In the main definition, you have event and context. We have not defined a test event yet, so if you click Test, AWS will throw an error prompting you to define the event, opening an event template.

| | |

Deploy the AWS Changes, Test

|

| |

Edit Runtime Handler

Find Runtime settings beneath the test results and note the Handler shows as named lambda\_handler

Click Edit to change this to our name of main

Click Save

|

| |

Test

Click Test to repeat the test, now with the handler name updated to main.

We can see that the test Status shows Succeeded

What we see is going to be our check response.

| | So the above is how you create the Lambda function in Amazon, and it's ready for use. But first, let's add a JSON Event to our check before we set up the check in ASM. ## 4. Adding a JSON Event To demonstrate some of the power of Lambda, we'll be editing our code directly in AWS Lambda. We will be adding just one additional field to our results because it's essential to show the power of our expandable JSON results. | **Step** | **Screenshot** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | |

Add an Event Field

In AWS Lambda, we're going to add a field called event. And it will be the event that's passed in; i.e., the event is data from the check itself. So when we add it in this section, we can show that happening.

Click Deploy

Click Test to do a quick test, and we'll see that the event has our test event that we created earlier. We'll see how this works when we run the ASM function.

Note the test Status now shows Succeeded.

| | Next, we'll be creating our check in the ASM UI. And we'll be running this and retrieving a result from it. ## 5. ASM Check Creation We're going to create our check in ASM. | **Step** | **Screenshot** | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | |

Navigate to ASM, New Check+. Under the Scripted Check banner, click the Run AWS Lambda icon.

The check wizard will open. So let's create a new check.

| | |

Step 1: Name, Description, and Tags

Provide a name for your check. In this example, we will call it New Lambda Check. Add any Description and Tags to help organize this check.

Click Next

| | |

Step 2a: Command and location

AWS Region: This is the AWS region that your Lambda resides in. It may not default to your location, which you'll find that in the upper right-hand corner of your Amazon screen, or your Amazon UI.

In this example, it says Frankfurt, but up in the browser URL, you will see eu-central-1.console.aws.ams:on.com/lambda/hometregion-=eu-central-14

So, select eu-central-1 for this example or whatever matches your AWS Region in the dropdown choices.

Function Name: Our example function name is simply DemoFunction, which we will type in, and find in our AWS UI, indicated to the right.

| | |

Step 2b: Command and location

AWS access key & AWS secret key. It would be best if you had this from AWS. You may need to ask your Operations team to get you an AWS Access Key and AWS Secret Key to execute this function. Enter these here.

Base64 Encoded JSON Payload. This JSON payload is the event that is passed here. For this field, create a JSON object; Base64 encode it and paste it in here.

You can use a Base64 encoding website . In this example, we'll create a very simple JSON by entering 'hello world,' and then we will encode it; this is our encoded JSON, and then we will paste that in the field.

For other fields, such as AWS Session Token, AWS Role ARN, and Role Session Name: if/when you provide these inputs, the script that runs your Lambda will assume a role before running the Lambda.

You may have a security scheme that uses that, but, in this case, we don't. So we're going to leave these empty.

Location. Select for this example Montreal and then press Next.

|

| |

Step 3: Interval, Thresholds, & Monitor Groups

Set this check to run manually, and check the Monitor Group(s) to organize the check under. In this screenshot, It was put under the Driver Monitor Group. Click Next.

| | |

Create check

After Acknowledging the confirmation page, press Create.

For Testing:

We've created our ASM check.

| | And in our next section, we will run the check and examine our results. ## 6. Run Result We've created and configured our AWS Lambda check. We are ready to run it in ASM and view the results. Note: the base 64 encoded JSON payload field that we provided is *entirely optional*. If you don't want to use it, you can leave it empty, and there won't be any additional information passed to your Lambda. But we'll keep it for this example. | **Step** | **Screenshot** | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | |

Check details page and manually run the check.

We see the result value/response time of 47 milliseconds.

If you click into this data point, in the Result section, you can see the Lambda: true event as well as the hello: "world" object that we encoded in Base64 and put inside our check configuration.

| | You can provide almost any kind of data in this check type. As long as you have an Amazon account, the possibilities with this check are endless. As mentioned before, you can use many different types of runtimes. If you're a Ruby person and cannot have an Apica Private Agent inside your firewall, you can use Lambda. Using **AWS Identity and Access Management**, you can set very fine-grained permissions. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.apica.io/platform-docs/synthetic-monitoring-overview/explore-the-platform/check-types/aws-lambda-check.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.