Scheduling reports with AWS Lambda

You can use AWS Lambda with the Reporting CLI tool to specify an AWS Lambda function to trigger the report generation.

This requires that you use an AMD64 system and Docker.

Prerequisites

To use the Reporting CLI with AWS Lambda, you need to do the following preliminary steps.

Step 1: Create a container image with a Dockerfile

You need to assemble the container image by running a Dockerfile. When you run the Dockerfile, it downloads the OpenSearch artifact required to use the Reporting CLI. To learn more about Dockerfiles, see Dockerfile reference.

Copy the following sample configurations into a Dockerfile:

  1. # Define function directory
  2. ARG FUNCTION_DIR="/function"
  3. # Base image of the docker container
  4. FROM node:lts-slim as build-image
  5. # Include global arg in this stage of the build
  6. ARG FUNCTION_DIR
  7. # AWS Lambda runtime dependencies
  8. RUN apt-get update && \
  9. apt-get install -y \
  10. g++ \
  11. make \
  12. unzip \
  13. libcurl4-openssl-dev \
  14. autoconf \
  15. automake \
  16. libtool \
  17. cmake \
  18. python3 \
  19. libkrb5-dev \
  20. curl
  21. # Copy function code
  22. WORKDIR ${FUNCTION_DIR}
  23. RUN curl -LJO https://artifacts.opensearch.org/reporting-cli/opensearch-reporting-cli-1.0.0.tgz
  24. RUN tar -xzf opensearch-reporting-cli-1.0.0.tgz
  25. RUN mv package/* .
  26. RUN npm install && npm install aws-lambda-ric
  27. # Build Stage 2: Copy Build Stage 1 files in to Stage 2. Install chrome, then remove chrome to keep the dependencies.
  28. FROM node:lts-slim
  29. # Include global arg in this stage of the build
  30. ARG FUNCTION_DIR
  31. # Set working directory to function root directory
  32. WORKDIR ${FUNCTION_DIR}
  33. # Copy in the build image dependencies
  34. COPY --from=build-image ${FUNCTION_DIR} ${FUNCTION_DIR}
  35. # Install latest chrome dev package and fonts to support major char sets (Chinese, Japanese, Arabic, Hebrew, Thai and a few others)
  36. # Note: this installs the necessary libs to make the bundled version of Chromium that Puppeteer installs, work.
  37. RUN apt-get update \
  38. && apt-get install -y wget gnupg \
  39. && wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add - \
  40. && sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list' \
  41. && apt-get update \
  42. && apt-get install -y google-chrome-stable fonts-ipafont-gothic fonts-wqy-zenhei fonts-thai-tlwg fonts-kacst fonts-freefont-ttf libxss1 \
  43. --no-install-recommends \
  44. && apt-get remove -y google-chrome-stable \
  45. && rm -rf /var/lib/apt/lists/*
  46. ENTRYPOINT ["/usr/local/bin/npx", "aws-lambda-ric"]
  47. ENV HOME="/tmp"
  48. CMD [ "/function/src/index.handler" ]

Next, run the following build command within the same directory that contains the Dockerfile:

  1. docker build -t opensearch-reporting-cli .

Step 2: Create a private repository with Amazon ECR

You need to follow the instructions to create an image repository, see Getting started with Amazon ECR using the AWS Management Console.

Give your repository the name opensearch-reporting-cli.

In addition to the Amazon ECR instructions, you need to make several adjustments for the Reporting CLI to function properly as described in the following steps in this procedure.

Step 3: Push the image to the private repository

You need to get several commands from the AWS ECR Console to run within the Dockerfile directory.

  1. After you create your repository, select it from Private repositories.
  2. Choose view push commands.
  3. Copy and run each command shown in Push commands for opensearch-reporting-cli sequentially in the Dockerfile directory.

For more details about Docker push commands, see Pushing a Docker image in the Amazon ECR user guide.

Step 4: Create a Lambda function with the container image

Now that you have a container image created for the Reporting CLI, you need to create a function defined as the container image.

  1. Open the AWS Lambda console and choose Functions.
  2. Choose Create function, then choose Container image and fill in a name for the function.
  3. In Container image URI, choose Browse images and select opensearch-reporting-cli for the image repository.
  4. In Images select the image, and choose Select image.
  5. In Architecture, choose x86_64.
  6. Choose Create function.
  7. Go to Lambda > functions and choose the function you created.
  8. Choose Configuration > General configuration > Edit timeout and set the timeout in lambda to 5 minutes to allow the Reporting CLI to generate the report.
  9. Change the Ephemeral storage setting to at least 1024MB. The default setting is not a sufficient storage amount to support report generation.

  10. Next, test the function either by providing values JSON format or by providing AWS Lambda environment variables.

  • If the function contains fixed values, such as email address you do not need a JSON file. You can specify an environment variable in AWS Lambda.
  • If the function takes a variable key-value pair, then you need to specify the values in the JSON with the same naming convention as command options, for example the --credentials option requires the username and password.

The following example shows fixed values provided for the sender and recipient email addresses:

  1. {
  2. "url": "https://playground.opensearch.org/app/dashboards#/view/084aed50-6f48-11ed-a3d5-1ddbf0afc873",
  3. "transport": "ses",
  4. "from": "sender@amazon.com",
  5. "to": "recipient@amazon.com",
  6. "subject": "Test lambda docker image"
  7. }

To learn more about AWS Lambda functions, see Deploying Lambda functions as container images in the AWS Lambda documentation.

Step 5: Add the trigger to start the AWS Lambda function

Set the trigger to start running the report. AWS Lambda can use any AWS service as a trigger, such as SNS, S3, or an AWS CloudWatch EventBridge.

  1. In the Triggers section, choose Add trigger.
  2. Select a trigger from the list. For example, you can set an AWS CloudWatch Event. To learn more about Amazon ECR events you can schedule, see Sample events from Amazon ECR.
  3. Choose Test to initiate the function.

(Optional) Step 6: Add the role permission for Amazon SES

If you want to use Amazon SES for the email transport, you need to set up permissions.

  1. Select Configuration and choose Execution role.
  2. In Summary, choose Permissions.
  3. Select {}JSON to open the JSON policy editor.
  4. Add the permissions for the Amazon SES resource that you want to use.

The following example provides the resource ARN for the send email action:

  1. {
  2. "Effect": "Allow",
  3. "Action": [
  4. "ses:SendEmail",
  5. "ses:SendRawEmail"
  6. ],
  7. "Resource": "arn:aws:ses:us-west-2:555555511111:identity/username@amazon.com"
  8. }

To learn more about setting role permissions, see Permissions in the AWS Lambda user guide.