docker-syslog-forwarder/README.md
2023-07-07 17:44:45 +02:00

58 lines
1.4 KiB
Markdown

# docker-syslog-forwarder
[![Build Status](https://drone.asperti.com/api/badges/paspo/docker-syslog-forwarder/status.svg)](https://drone.asperti.com/paspo/docker-syslog-forwarder)
This container accepts syslog streams on port `514/tcp` and `514/udp` and forwards everything to a remote syslog server in RFC5424 format.
No encryption support at the moment.
## build
```bash
docker build . -t docker.asperti.com/paspo/syslog-forwarder
```
## environment
Variable | Default | Description
--------------|-----------|----------------------------------------------------
TARGET_HOST | 127.0.0.1 | target server IP/hostname
TARGET_PROTO | tcp | `tcp` or `udp`
TARGET_PORT | 514 | target server syslog port
DEBUG | 0 | if != 0, every received log line is shown on stdout
## run
```bash
docker run -d --name syslog-forwarder \
-p 514:514/tcp -p 514:514/udp \
-e "TARGET_HOST=192.168.1.33" \
docker.asperti.com/paspo/syslog-forwarder
```
## docker-compose
```yaml
version: "3"
services:
syslog-forwarder:
image: docker.asperti.com/paspo/syslog-forwarder
restart: always
ports:
- "514:514/tcp"
- "514:514/udp"
environment:
- TARGET_HOST=192.168.1.33
- TARGET_PROTO=tcp
- TARGET_PORT=1514
```
## testing
If you need a log source for testing, you can use the `logger` command:
```bash
logger --server my.logserver.com --tcp --rfc3164 --priority 3 --port 514 "ciao"
```