Tutorial: Update DataDog integration for CloudConnexa Log Streaming⁠

DataDog configuration can be done using the Serverless setup in which an AWS Lambda function reads from the AWS S3 Bucket and writes log messages to HTTP(S) DataDog endpoints. This tutorial shows how to keep the AWS Lambda function updated.

Prerequisites⁠

You already have a Lambda function set up per Tutorial: Configure DataDog for CloudConnexa Log Streaming.

Reinstall with the latest version⁠

Reinstall the Lambda function using the latest version by following the steps below:

  1. Navigate to CloudFormation > Stacks on your AWS Console.

  2. Select the DataDog Forwarder stack you used to create the current Lambda function.

    delete stack
  3. Click Delete.

  4. Install the latest DataDog forwarder as per Tutorial: Configure DataDog for CloudConnexa Log Streaming.

Rollback to the old version⁠

To rollback to the previous version, you need to reinstall the Lambda function using the previous version by following the steps below:

  1. Navigate to CloudFormation > Stacks on your AWS Console.

  2. Select the DataDog Forwarder stack you used to create the current Lambda function.

    delete stack
  3. Click Delete.

  4. Install the latest DataDog forwarder as per Tutorial: Configure DataDog for CloudConnexa Log Streaming but by using the link corresponding to the older version from the table below:

    Version

    CloudFormation Link

    1.1.2 (latest)

    https://cloud.openvpn.com/log-streaming/cloudformation/datadog?version=1.1.2

    1.1.1

    https://cloud.openvpn.com/log-streaming/cloudformation/datadog?version=1.1.1

    1.1.0

    https://cloud.openvpn.com/log-streaming/cloudformation/datadog?version=1.1.0

    1.0.0

    https://cloud.openvpn.com/log-streaming/cloudformation/datadog?version=1.0.0

Test⁠

  1. Navigate to API & Logs > Log Streaming and click Send Test Message.

    Screenshot of Log Streaming showing the 'Send Test Message' button⁠
    Screenshot of Log Streaming showing the 'Send Test Message' button

  2. Check that a log file is written to your AWS S3 bucket in response to requesting that a test message be sent in the prior step. The log will appear as <S3Bucket>/CloudConnexa/<account id>/<hexid>-<YYYY>-<MM>-<DD>-<HH>-<MM>-<xxxx>.jsonl.gz

    Screenshot of log files in the AWS S3 bucket⁠
    Screenshot of log files in the AWS S3 bucket
  3. Events from the *.jsonl.gz files are parsed by the Lambda function and sent to DataDog. You can find it in the Logs section.

    Screenshot of a parsed event in DataDog⁠
    Screenshot of a parsed event in DataDog