Ingest via Honeycomb

Axiom Honeycomb Proxy ships logs to Axiom and Honeycomb simultaneously.

Installation

You can Download the Binary releases available on GitHub Releases.

Install using Homebrew

brew tap axiomhq/tap
brew install axiom-honeycomb-proxy

Install using go get

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

Install from source

git clone https://github.com/axiomhq/axiom-honeycomb-proxy.git
cd axiom-honeycomb-proxy
make install

Pull and Run the Docker image

docker pull axiomhq/axiom-honeycomb-proxy:latest

Configuration

  • Set the following environment variables:
  • 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.

When using Axiom Selfhost:

  • AXIOM_URL: URL of the Axiom deployment to use.
  • Run it: ./axiom-honeycomb-proxy or using Docker:

Using Docker

docker run -p8080:8080/tcp \
-e=AXIOM_TOKEN=<YOUR_AXIOM_TOKEN> \
axiomhq/axiom-honeycomb-proxy
  • Point all Honeycomb related tools at the proxy deployment.

Request format

Single event requests

curl http://localhost:3111/honeycomb/v1/events/<DATASET> -X POST \
-H "X-Honeycomb-Team: <YOUR-HONEYCOMB-KEY>" \
-H "X-Honeycomb-Event-Time: 2018-02-09T02:01:23.115Z" \
-d '{"method":"GET","endpoint":"/foo","shard":"users","dur_ms":32}'

Event batch requests

curl http://localhost:3111/honeycomb/v1/batch/<DATASET> -X POST \
-H "X-Honeycomb-Team: <YOUR-HONEYCOMB-KEY>" \
-d '[
{
"time":"2018-02-09T02:01:23.115Z",
"data":{"key1":"val1","key2":"val2"}
},
{
"data":{"key3":"val3"}
}
]'

For more information on Axiom-honeycomb-proxy and how you can propose bug fix, report issues and submit PRs, kindly visit our repository on Github.