Send data from Loki Multiplexer to Axiom

This step-by-step guide provides a gateway for you to connect a direct link interface to Axiom via Loki endpoint.

Loki by Prometheus is a multi-tenant log aggregation system that’s highly scalable and capable of indexing metadata about your logs.

Loki exposes an HTTP API for pushing, querying, and tailing Axiom log data.

Axiom Loki Proxy provides a gateway for you to connect a direct link interface to Axiom via Loki endpoint.

Using the Axiom Loki Proxy, you can ship logs to Axiom via the Loki HTTP API.

Prerequisites

• Create an Axiom account.
• Create a dataset in Axiom where you send your data.
• Create an API token in Axiom with permissions to update the dataset you have created.

Installation

Install and update using Homebrew

brew tap axiomhq/tap
brew install axiom-loki-proxy
brew update
brew upgrade axiom-loki-proxy

Install using go get

go get -u github.com/axiomhq/axiom-loki-proxy/cmd/axiom-loki-proxy

Install from source

git clone https://github.com/axiomhq/axiom-loki-proxy.git
cd axiom-loki-proxy
make build

Run the Loki-Proxy Docker

docker pull axiomhq/axiom-loki-proxy:latest

Configuration

Specify the environmental variables for your Axiom deployment:

AXIOM_URL = AXIOM_DOMAIN
AXIOM_TOKEN = API_TOKEN

Replace AXIOM_DOMAIN with api.axiom.co if your organization uses the US region, and with api.eu.axiom.co if your organization uses the EU region. For more information, see Regions.

Replace API_TOKEN with the Axiom API token you have generated. For added security, store the API token in an environment variable.

Run and test

./axiom-loki-proxy

Using Docker

docker run -p8080:8080/tcp \
  -e=AXIOM_TOKEN=<API_TOKEN> \
  axiomhq/axiom-loki-proxy

Replace API_TOKEN with the Axiom API token you have generated. For added security, store the API token in an environment variable.

For more information on Axiom Loki Proxy and how you can propose bug fix, report issues and submit PRs, see the GitHub repository.