docker-elk/extensions/filebeat
Antoine Cotten 5da1badcf9
feat(ext/filebeat): ingest ES logs via elasticsearch module
Ensures that Elasticsearch log entries are processed through dedicated
ingestion pipelines, so that their fields can be automatically
extracted.
2024-02-14 20:46:37 +01:00
..
config feat(ext/filebeat): ingest ES logs via elasticsearch module 2024-02-14 20:46:37 +01:00
.dockerignore Automate management of required roles and user passwords (#671) 2022-02-21 11:19:43 +01:00
Dockerfile chore: Rename ELK_VERSION to ELASTIC_VERSION 2022-02-28 09:10:30 +01:00
README.md feat(ext/beats): Use unprivileged publish users 2022-11-22 11:37:50 +01:00
filebeat-compose.yml feat(ext/beats): Use unprivileged publish users 2022-11-22 11:37:50 +01:00

README.md

Filebeat

Filebeat is a lightweight shipper for forwarding and centralizing log data. Installed as an agent on your servers, Filebeat monitors the log files or locations that you specify, collects log events, and forwards them either to Elasticsearch or Logstash for indexing.

Usage

This extension requires the filebeat_internal and beats_system users to be created and initialized with a password. In case you haven't done that during the initial startup of the stack, please refer to How to re-execute the setup to run the setup container again and initialize these users.

To include Filebeat in the stack, run Docker Compose from the root of the repository with an additional command line argument referencing the filebeat-compose.yml file:

$ docker-compose -f docker-compose.yml -f extensions/filebeat/filebeat-compose.yml up

Configuring Filebeat

The Filebeat configuration is stored in config/filebeat.yml. You can modify this file with the help of the Configuration reference.

Any change to the Filebeat configuration requires a restart of the Filebeat container:

$ docker-compose -f docker-compose.yml -f extensions/filebeat/filebeat-compose.yml restart filebeat

Please refer to the following documentation page for more details about how to configure Filebeat inside a Docker container: Run Filebeat on Docker.

See also

Filebeat documentation