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