mirror of
https://github.com/VictoriaMetrics/VictoriaMetrics.git
synced 2024-12-24 19:30:06 +01:00
6adb3f0dc2
### Describe Your Changes
Marked fluentd in victorialogs roadmap
Added fluentd syslog example setup
### Checklist
The following checks are **mandatory**:
- [ ] My change adheres [VictoriaMetrics contributing
guidelines](https://docs.victoriametrics.com/contributing/).
(cherry picked from commit 05a64a8c14)
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
# Docker compose Logstash integration with VictoriaLogs
|
|
|
|
The folder contains examples of [Logstash](https://www.elastic.co/logstash) integration with VictoriaLogs using protocols:
|
|
|
|
* [loki](./loki)
|
|
* [jsonline single node](./jsonline)
|
|
* [jsonline HA setup](./jsonline-ha)
|
|
* [elasticsearch](./elasticsearch)
|
|
|
|
All required plugins, that should be installed in order to support protocols listed above can be found in a [Dockerfile](./Dockerfile)
|
|
|
|
To spin-up environment `cd` to any of listed above directories run the following command:
|
|
```
|
|
docker compose up -d
|
|
```
|
|
|
|
To shut down the docker-compose environment run the following command:
|
|
```
|
|
docker compose down
|
|
docker compose rm -f
|
|
```
|
|
|
|
The docker compose file contains the following components:
|
|
|
|
* logstash - logs collection agent configured to collect and write data to `victorialogs`
|
|
* victorialogs - logs database, receives data from `logstash` agent
|
|
* victoriametrics - metrics database, which collects metrics from `victorialogs` and `logstash` for observability purposes
|
|
|
|
Querying the data
|
|
|
|
* [vmui](https://docs.victoriametrics.com/victorialogs/querying/#vmui) - a web UI is accessible by `http://localhost:9428/select/vmui`
|
|
* for querying the data via command-line please check [these docs](https://docs.victoriametrics.com/victorialogs/querying/#command-line)
|
|
|
|
Logstash configuration example can be found below:
|
|
* [loki](./loki/pipeline.conf)
|
|
* [jsonline single node](./jsonline/pipeline.conf)
|
|
* [jsonline HA setup](./jsonline-ha/pipeline.conf)
|
|
* [elasticsearch](./elasticsearch/pipeline.conf)
|
|
|
|
Please, note that `_stream_fields` parameter must follow recommended [best practices](https://docs.victoriametrics.com/victorialogs/keyconcepts/#stream-fields) to achieve better performance.
|