Back to Beats

Zeek (Bro) module

x-pack/filebeat/module/zeek/README-developer.md

9.4.01.4 KB
Original Source

Zeek (Bro) module

Install and Configure Zeek/Bro

Install Zeek/Bro (for MacOS with Brew)

brew install bro
  • Configure it to process network traffic and generate logs.
  • Edit /usr/local/etc/node.cfg to use the proper network interfaces.
  • Edit /usr/local/etc/networks.cfg to specify local networks accordingly.
  • Set redef LogAscii::use_json=T; in /usr/local/share/bro/site/local.bro to use JSON output.

Install Zeek/Bro (for Ubuntu Linux)

apt install bro
apt install broctl
  • Configure it to process network traffic and generate logs.
  • Edit /etc/bro/node.cfg to use the proper network interfaces.
  • Edit /etc/bro/networks.cfg to specify local networks accordingly.
  • Set redef LogAscii::use_json=T; in /usr/share/bro/site/local.bro to use JSON output.

Start Zeek/Bro

sudo broctl deploy

How to try the module from source

Clone and build Filebeat

git clone [email protected]:elastic/beats.git
cd beats/x-pack/filebeat
make mage
mage clean update
mage build

Configure Filebeat module and run

Update filebeat.yml to point to Elasticsearch and Kibana. Setup Filebeat.

./filebeat setup --modules zeek -e -E 'setup.dashboards.directory=build/kibana'

Enable the Filebeat zeek module

./filebeat modules enable zeek

Start Filebeat

./filebeat -e

Now, you should see the Zeek logs and dashboards in Kibana.