axiomcloudwatchlambda

README

Axiom Cloudwatch Lambda

---

Table of Contents

1. Introduction
2. Usage
3. Contributing
4. License

Introduction

Axiom Cloudwatch Lambda ships logs to Axiom, right within from a lambda function.

Installation

Download the pre-compiled and archived binary manually

Binary releases are available on GitHub Releases.

Install from source

git clone https://github.com/axiomhq/axiom-cloudwatch-lambda.git
cd axiom-cloudwatch-lambda
make install

Usage

1. Upload the archive

2. Set the following environment variables to connect to Axiom Cloud:

• AXIOM_TOKEN: Personal Access or Ingest token. Can be created under Profile or Settings > Ingest Tokens. For security reasons it is advised to use an Ingest Token with minimal privileges only.
• AXIOM_ORG_ID: The organization identifier of the organization to use
• AXIOM_DATASET: Dataset to ship the logs to (must belong to the organization)

When using Axiom Selfhost:

• AXIOM_TOKEN: Personal Access or Ingest token. Can be created under Profile or Settings > Ingest Tokens. For security reasons it is advised to use an Ingest Token with minimal privileges only.
• AXIOM_URL: URL of the Axiom deployment to use
• AXIOM_DATASET: Dataset to ship the logs to (must belong to the organization)

Contributing

Feel free to submit PRs or to fill issues. Every kind of help is appreciated.

Before committing, make should run without any issues.

License

© Axiom, Inc., 2021

Distributed under MIT License (The MIT License).

See LICENSE for more information.

Documentation

Overview

Package axiomcloudwatchlambda implements a Amazon Web Services Lambda handler that pushes logs to Axiom.