Event Collector
Event Collector

Event Collector

Event Collector ingests events sent by the SDK and writes these events to S3.

Setup in AWS

Follow the steps below to use our AWS CloudFormation template to create the stack in your AWS account.

  1. Go to CloudFormation in AWS console.
  1. Click Create stack on top right and choose With new resources (standard).
  1. On the Create stack screen, choose Template is ready under Prepare template and Amazon S3 URL as Template source.

       Provide S3 URL as https://airblock-public-cf-templates.s3.amazonaws.com/airblock-kinesis-s3-data-ingestion-cf.json.

       Click Next.

  1. On the Specify stack details screen, enter a Stack name.

       In the Parameters section, edit the S3 Data bucket name as desired. Since this bucket will be created, ensure its new and unique. You may leave the other parameters to their default values.

       Click Next.

  1. On the Configure stack options screen, you may leave the options to their default values. Click Next.
  1. On the Review screen, scroll to the end and accept I acknowledge that AWS CloudFormation might create IAM resources.

       Click Submit. It will take a few seconds to create the stack.

       Once the Status becomes CREATE_COMPLETE, your event collector is ready.

  1. We'll now get the URL that we need to provide in the javascript SDK. Click on Stacks in left menu and then click on your stack name. In the right pane, go to the Resources tab. Search for "AirblockAPIGWRestAPI" and click on its Physical ID. This will open the API Gateway details page.

       Click on Stages in the left menu, then expand the prod stage and click on POST.

       Copy the Invoke URL. Use this URL as the SERVER_URL in the javascript SDK.

Test via Postman

You can use the text below as body in your POST request (select raw and JSON).

After sending the request, go to the S3 bucket. You should see a ".json" file in folders created as per time.

{
    "Data":
    {
    "api_key": "a0003cdf2255a79681aaf309796c442f",
    "events": [
        {
            "uuid": "916be96d-4b92-4391-89d4-c1288bb2acc6",
            "event_time": 1685597458665,
            "event_type": "Event 1"
        },
        {
            "uuid": "916be96d-4b92-4391-89d4-c1288bb2acc6",
            "event_time": 1685597458665,
            "event_type": "Event 2"
        },
        {
            "uuid": "916be96d-4b92-4391-89d4-c1288bb2acc6",
            "event_time": 1685597458665,
            "event_type": "Event 3"
        }
    ]
    },
    "PartitionKey": 1
}
User ID