Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/parseablehq/aws-lambda-extension
Parseable AWS Lambda Extension allows sending lambda function logs to your Parseable instance
https://github.com/parseablehq/aws-lambda-extension
aws-lambda extensions logging
Last synced: about 2 months ago
JSON representation
Parseable AWS Lambda Extension allows sending lambda function logs to your Parseable instance
- Host: GitHub
- URL: https://github.com/parseablehq/aws-lambda-extension
- Owner: parseablehq
- License: apache-2.0
- Created: 2023-01-23T03:51:53.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-24T14:05:16.000Z (over 1 year ago)
- Last Synced: 2024-06-20T00:55:15.971Z (7 months ago)
- Topics: aws-lambda, extensions, logging
- Language: Go
- Homepage: https://parseable.io
- Size: 41 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Parseable AWS Lambda extension
[](https://goreportcard.com/report/github.com/parseablehq/aws-lambda-extension)
[](https://godoc.org/github.com/parseablehq/aws-lambda-extension)
[](https://raw.githubusercontent.com/parseablehq/aws-lambda-extension/master/LICENSE)
[Parseable](https://parseable.io/) is a lightweight, cloud native log observability engine. It can use either a local drive or S3 (and compatible stores) for backend data storage. Parseable is written in Rust and uses Apache Arrow and Parquet as underlying data structures. Parseable consumes up to ~80% lower memory and ~50% lower CPU than Elastic for similar ingestion throughput.
You can deploy Parseable on AWS, GCP, Azure, and on-premises. Refer the [documentation](https://parseable.io/docs) for more details.
## Usage
To use the parseable-lambda-extension with a lambda function, it must be configured as a layer. There are two variants of the extension available: one for `x86_64` architecture and one for `arm64` architecture.
You can add the extension as a layer with the AWS CLI tool:
```sh
$ aws lambda update-code-configuration \
--function-name MyAwesomeFunction
--layers ""
```
The extension's layer version ARN follows the pattern below.
```sh
# Layer Version ARN Pattern
arn:aws:lambda::724973952305:layer:parseable-lambda-extension--:1
```
* `AWS_REGION` - This must match the region of the Lambda function to which you are adding the extension.
* `ARCH` - x86_64 or arm64.
* `VERSION` - The version of the extension you want to use. Current version is v1.0. For current latest release `v1.0`, use the value `v1-0`.
### Configuration
The extension is configurable via environment variables set for your lambda function.
* **PARSEABLE_LOG_URL** - Parseable endpoint URL. It should be set to `https:///api/v1/ingest`. Change `` to your Parseable instance URL. (required)
* **PARSEABLE_USERNAME** - Username set for your Parseable instance. (required)
* **PARSEABLE_PASSWORD** - Password set for your Parseable instance. (required)
* **PARSEABLE_LOG_STREAM** - Parseable stream name where you want to ingest logs. (default: ``Lambda Function Name``).
Refer Parseable [installation documentation](https://www.parseable.io/docs/category/installation) for more details.
## Container image lambda
In case if you deploy your lambda as container image, to inject extension as part of your function just copy it to your image:
```Dockerfile
FROM parseable/aws-lambda-extension:latest AS parseable-extension
FROM public.ecr.aws/lambda/python:3.8
# Layer code
WORKDIR /opt
COPY --from=parseable-extension /opt/ .
# Function code
WORKDIR /var/task
COPY app.py .
CMD ["app.lambda_handler"]
```
More details you can find [here](https://aws.amazon.com/blogs/compute/working-with-lambda-layers-and-extensions-in-container-images/).