Leveraging Amazon Lambda with Amazon Kinesis Streams: Real-time Event Processing

In today's data-driven landscape, real-time event processing is not just an advantage; it's a necessity. Amazon Web Services (AWS) offers powerful tools to address this need, with Amazon Lambda and Amazon Kinesis Streams leading the charge. In this comprehensive guide, we'll delve into the synergy between Amazon Lambda and Amazon Kinesis Streams. We'll explore what Amazon Kinesis Streams is, demonstrate how to enable it using AWS Serverless Application Model (SAM) and provide TypeScript examples for processing events in real time. By the end of this article, you'll have a solid understanding of how to build real-time event-driven applications using these AWS services.

What are Amazon Kinesis Streams?

Amazon Kinesis Streams is a real-time data streaming service offered by AWS. It allows you to ingest, process, and analyze large volumes of data in real time. The service is particularly well-suited for scenarios where you need to capture and react to data streams, such as clickstreams, log data, social media updates, or IoT device data.

Key Concepts:

  1. Stream: A Kinesis stream is a sequence of data records. You can think of it as a data pipeline where data producers publish records, and consumers subscribe to the stream to process those records.
  2. Shard: Streams are divided into shards, which are the basic building blocks of Kinesis Streams. Each shard can handle a specific amount of data throughput.
  3. Retention Period: Kinesis Streams allows you to specify how long records should be retained within a stream. This helps in managing storage costs and compliance requirements.

Use Cases for Kinesis Streams

Amazon Kinesis Streams enables businesses to react, analyze, and derive insights in real-time. Some of its use cases are:

  1. Real-time Analytics: Real-time analytics is a cornerstone of many businesses. Amazon Kinesis Streams allows organizations to process and analyze data the moment it's generated. This is pivotal for sectors like e-commerce, where understanding customer behaviour immediately can inform marketing strategies, inventory management, and personalized user experiences.
  2. IoT Data Streaming: In the Internet of Things (IoT) landscape, devices generate a constant stream of data. Amazon Kinesis Streams facilitates the ingestion and real-time processing of this data. For example, in smart cities, Kinesis Streams can handle the vast amount of data from sensors, cameras, and other IoT devices, enabling swift decision-making for traffic management or environmental monitoring.
  3. Log and Event Data Processing: Managing logs and events in real-time is critical for troubleshooting and security. By using Amazon Kinesis Streams, businesses can process logs and events as they occur, allowing for immediate detection of anomalies, security breaches, or system issues. This is especially valuable in industries with stringent security and compliance requirements.
  4. Clickstream Analysis: For online businesses, understanding user behaviour in real time is paramount. Amazon Kinesis Streams can process and analyze clickstream data instantly, helping businesses optimize website layouts, personalize user experiences, and implement real-time marketing strategies.
  5. Financial Data Processing: In the financial sector, timely data processing is vital. Amazon Kinesis Streams can be used to process financial transactions in real time, enabling fraud detection, risk assessment, and compliance monitoring. This real-time capability is crucial for preventing fraudulent activities and ensuring regulatory compliance.

AWS SAM for Real-time Event Processing

AWS Serverless Application Model (SAM) simplifies the deployment of serverless applications, including the setup of Amazon Kinesis Streams and Lambda.

Here's a simplified SAM template snippet:

    Type: AWS::Kinesis::Stream
      ShardCount: 1
    Type: AWS::Serverless::Function
      Handler: index.handler
      Runtime: nodejs18.x
      CodeUri: ./my-lambda-function
        StreamName: !Ref MyKinesisStream

The template defines an Amazon Kinesis stream named MyKinesisStream. In Amazon Kinesis, a stream is a sequence of data records. Each stream is made up of one or more shards, and the ShardCount property specifies the initial number of shards for the stream. In this case, there is only one shard, but you can adjust this number based on your throughput requirements. Shards are the units of capacity in a Kinesis stream, and they determine the maximum amount of data that the stream can ingest per second.

The template also defines an AWS Lambda function named MyLambdaFunction. Let's break down the properties:

  • Handler: Specifies the entry point for the Lambda function. In this case, it's index.handler, which typically means that the function is exported in a file named index.js (or .ts for TypeScript) and the handler function is named handler.
  • Runtime: Specifies the runtime for the Lambda function. Here, it's nodejs18.x, indicating that the function is written in Node.js and should use version 14.x of the Node.js runtime.
  • CodeUri: Points to the directory or S3 location where the Lambda function code is stored. In this case, it's ./my-lambda-function, indicating a local directory relative to the location of the SAM template.
  • Environment: Specifies environment variables for the Lambda function. In this case, it sets an environment variable named StreamName with the value of the reference (!Ref) to the MyKinesisStream. This allows the Lambda function to know the name of the Kinesis stream it should consume events from.

Now, let's dive into a TypeScript example that demonstrates how to process events from Amazon Kinesis Streams using AWS SDK and Lambda.

import { Kinesis } from "aws-sdk";

export const handler = async (event: any): Promise<void> => {
  const kinesis = new Kinesis();

  for (const record of event.Records) {
    // Process the Kinesis record
    const payload = JSON.parse(Buffer.from(record.kinesis.data, "base64").toString("utf-8"));
    // Your custom processing logic here
    console.log("Received record:", payload);
  • We import the AWS SDK's Kinesis module to interact with Amazon Kinesis Streams.
  • The Lambda function receives an event object containing Kinesis records.
  • We iterate through the records, extract the payload, and process it as needed.


Amazon Lambda and Amazon Kinesis Streams are a powerful combination for building real-time event-driven applications. By understanding Amazon Kinesis Streams, enabling it with AWS SAM, and processing events in real-time with TypeScript, you have the tools to build scalable and responsive applications that can react to data streams as they happen.