Use AWS Lambda@Edge to forward data to the Log visit endpoint.

AWS Lambda@Edge allows you to run JavaScript (Node.js) code at AWS CloudFront edge locations, intercepting and modifying requests before they reach your origin server. Read the official documentation for more details.

​
Setup

  1. Create a Lambda function in the us-east-1 region (required for Lambda@Edge).
  2. Deploy the function to CloudFront as a viewer request or origin request trigger.
  3. Set up the HALL_API_KEY environment variable with your Hall API key.

​
Example

The example below demonstrates how to forward data from incoming requests using AWS Lambda@Edge.

index.js
exports.handler = async (event) => {
    const request = event.Records[0].cf.request;
    const headers = request.headers;
    
    const requestPath = request.uri + (request.querystring ? '?' + request.querystring : '');
    const requestMethod = request.method;
    const requestIp = headers['cloudfront-viewer-address'] 
        ? headers['cloudfront-viewer-address'][0].value.split(':')[0] 
        : '127.0.0.1';
    
    const requestHeaders = {
        'User-Agent': headers['user-agent'] ? headers['user-agent'][0].value : '',
        'Host': headers['host'] ? headers['host'][0].value : '',
        'Referer': headers['referer'] ? headers['referer'][0].value : '',
    };

    fetch('https://analytics.usehall.com/visit', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${process.env.HALL_API_KEY}`,
        },
        body: JSON.stringify({
            request_path: requestPath,
            request_method: requestMethod,
            request_ip: requestIp,
            request_headers: requestHeaders,
            request_timestamp: Date.now(),
        }),
    });

    return request;
};

​
Deployment

To deploy this function to Lambda@Edge, follow the AWS Lambda@Edge deployment guide in the AWS documentation.