Ingest using Syslog
Logs are generated on all Network devices, Axiom Syslog Proxy ships logs to Axiom, acting as a Syslog server.
With Syslog logging system, you can monitor events on your devices and send them directly into Axiom, this also helps you retain your data logs.
The udp log messages is sent on UDP
port 514
to the syslog server.
The tcp log messages is sent on TCP
port 601
to the syslog server.
Installation
You can Download the Binary releases available on GitHub Releases.
Install using Homebrew
brew tap axiomhq/tapbrew install axiom-syslog-proxy
Install using go get
go get -u github.com/axiomhq/axiom-syslog-proxy/cmd/axiom-syslog-proxy
Install from source
git clone https://github.com/axiomhq/axiom-syslog-proxy.gitcd axiom-syslog-proxymake build
Pull and Run the Docker image
docker pull axiomhq/axiom-syslog-proxy:latest
Configuration
- Specify the environmental variables for your Axiom deployment
When using Axiom Selfhost:
AXIOM_URL: URL of the Axiom Deployment to use.
AXIOM_TOKEN: Personal Access or API token. Your personal access or API token can be created under Profile
or Settings > API Tokens.
AXIOM_INGEST_DATASET: Dataset to ingest into
Run it:
./axiom-syslog-proxy
Using Docker
docker run -p601:601/tcp -p514:514/udp \-e=AXIOM_TOKEN=<YOUR_AXIOM_TOKEN> \-e=AXIOM_DATASET=<YOUR_AXIOM_DATASET> \axiomhq/axiom-syslog-proxy
- Test it:
echo -n "tcp message" | nc -w1 localhost 601echo -n "udp message" | nc -u -w1 localhost 514
For more information on Axiom-loki-proxy and how you can propose bug fix, report issues and submit PRs, kindly visit our repository on Github.