Skip to main content

AWS Amplify

tip

For a much easier and more efficient way to collect and send telemetry, consider using the Logz.io telemetry collector.

Logs​

This is an AWS Lambda function that collects Amplify access logs and sends them to Logz.io in bulk over HTTP.

Configuration with a Lambda function​

Create a new Lambda function​

  1. Open the AWS Lambda Console, and click Create function.
  2. Choose Author from scratch.
  3. In Name, add the log type to the name of the function.
  4. In Runtime, choose Python 3.9.
  5. Click Create Function.

After a few moments, you'll see configuration options for your Lambda function. You'll need this page later on, so keep it open.

Zip the source files​

Clone the CloudWatch Logs Shipper - Lambda project from GitHub to your computer, and zip the Python files in the src/ folder as follows:

git clone https://github.com/logzio/logzio_aws_serverless.git \
&& cd logzio_aws_serverless/python3/amplify/ \
&& mkdir -p dist/python3/shipper; cp -r ../shipper/shipper.py dist/python3/shipper; mkdir -p dist/python3/custom_logger; cp -r ../custom_logger/custom_logger.py dist/python3/custom_logger \
&& cp src/lambda_function.py dist \
&& cd dist/ \
&& zip logzio-amplify lambda_function.py python3/shipper/* python3/custom_logger/*

Upload the zip file and set environment variables​

  1. In the Code source section, select Upload from > .zip file.
  2. Click Upload, and choose the zip file you created earlier (logzio-amplify.zip).
  3. Click Save.
  4. Navigate to Configuration > Environment variables.
  5. Click Edit.
  6. Click Add environment variable.
  7. Fill in the Key and Value fields for each variable as per the table below:
ParameterDescription
TOKEN (Required)The token of the account you want to ship to. Only Admin users have access to the token.
LISTENER_URL (Required)Determines protocol, listener host, and port. For example, https://<<LISTENER-HOST>>:8071. Replace <<LISTENER-HOST>> with your region's listener host. Use port 8070 for HTTP or 8071 for HTTPS. To find you account region, see Account region.
AMPLIFY_DOMAIN (Required)Find the Amplify domain URL in the Amplify admin dashboard > General > Production Branch URL. This URL is available after deploying your application.
TYPE (Default: logzio_amplify_access_lambda)Specify the log type for this Lambda, which can be a default parsable type or a custom log type. A new Lambda is required for each log type used.
AMPLIFY_APP_ID (Required)You can find the app ID in your Amplify admin dashboard > General under the App ARN field: arn:aws:amplify:REGION:AWS_ID:apps/APP_ID.
TIMEOUTPeriod in minutes, over which the Lambda function fetches Amplify logs.

Set the EventBridge (CloudWatch Events) trigger​

  1. Navigate to the Amazon EventBridge homepage.
  2. If you don't have a pre-defined schedule type (e.g., 1min), click Rules > Create rule.
  3. In Name, enter a name to uniquely identify your rule.
  4. In Description, provide a description for your rule. This step is optional.
  5. In Rule type, choose the schedule expression that is equal to the TIMEOUT of the environment variable (e.g., 5 minutes).

Update Permissions for Lambda Function​

  1. Go to Configuration in your Lambda function and select the Permissions tab.
  2. Click the role name shown in the example lambda-basic. It will redirect you to the IAM> Roles> lambda-basic.
  3. On the role page inside the Permissions tab, select the dropdown Add permissions and click on Create inline policy. It will redirect you to the Create Policy page.
  4. On the Create Policy page, select the JSON tab.
  5. Fill in JSON with your parameters as follows:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "amplify:GenerateAccessLogs"
            ],
            "Resource": "arn:aws:amplify:AWS_REGION:XXX66029XXXX:apps/XXXXdn0mprXXXX/accesslogs/*"
        }
    ]
}
  • Replace AWS_REGION with the AWS region of your Amplify App (e.g.,us-west-2).
  • Replace XXX66029XXXX with your AWS Account ID.
  • Replace XXXXdn0mprXXXX with the AWS Amplify App ID.

Check Logz.io for your logs​

Give your logs some time to get from your system to ours, and then open Open Search Dashboards.

If you still don't see your logs, see log shipping troubleshooting.