Skip to main content

Zeek

Zeek is a free and open-source software network analysis framework. This integration allows you to send Zeek logs to your Logz.io SIEM account.

Before you begin, you'll need:

Configure Zeek to output JSON logs

The configuration filepath changes depending on your version of Zeek or Bro. For this reason, see your installation's documentation if you need help finding the file.

If you're running Bro (Zeek's predecessor), the configuration filename will be ascii.bro. Otherwise, the filename is ascii.zeek.

In the configuration file, find the line that begins const use_json. Set the value to T (true):

const use_json = T &redef;

Download the Logz.io public certificate

For HTTPS shipping, download the Logz.io public certificate to your certificate authority folder.

sudo curl https://raw.githubusercontent.com/logzio/public-certificates/master/AAACertificateServices.crt --create-dirs -o /etc/pki/tls/certs/COMODORSADomainValidationSecureServerCA.crt

Add Zeek as an input

In the Filebeat configuration file (/etc/filebeat/filebeat.yml), add Zeek to the filebeat.inputs section.

Replace <<LOG-SHIPPING-TOKEN>> with the token of the account you want to ship to.

note

Filebeat requires a file extension specified for the log input.

# ...
filebeat.inputs:
- type: filestream

# The path to your logs can change depending on your version and configuration.
# To find it, run zeekctl config
# sudo ./zeekctl config | grep logdir
paths:
- /var/log/bro/current/conn.log
- /var/log/bro/current/ssh.log
- /var/log/bro/current/rdp.log
- /var/log/bro/current/ssl.log
- /var/log/bro/current/smb.log
- /var/log/bro/current/dpd.log
- /var/log/bro/current/dns.log
- /var/log/bro/current/http.log

fields:
logzio_codec: json

# Your Logz.io account token. You can find your token at
# https://app.logz.io/#/dashboard/settings/manage-accounts
token: <<LOG-SHIPPING-TOKEN>>
type: zeek
fields_under_root: true
encoding: utf-8
ignore_older: 3h

- type: filestream
paths:
- /var/log/bro/current/notice.log
fields:
logzio_codec: json
# Your Logz.io account token. You can find your token at
# https://app.logz.io/#/dashboard/settings/manage-accounts
token: <<LOG-SHIPPING-TOKEN>>
type: zeek_alert
fields_under_root: true
encoding: utf-8
ignore_older: 3h

If you're running Filebeat 7 to 8.1, paste the code block below instead:

# ...
filebeat.inputs:
- type: log

# The path to your logs can change depending on your version and configuration.
# To find it, run zeekctl config
# sudo ./zeekctl config | grep logdir
paths:
- /var/log/bro/current/conn.log
- /var/log/bro/current/ssh.log
- /var/log/bro/current/rdp.log
- /var/log/bro/current/ssl.log
- /var/log/bro/current/smb.log
- /var/log/bro/current/dpd.log
- /var/log/bro/current/dns.log
- /var/log/bro/current/http.log

fields:
logzio_codec: json

# Your Logz.io account token. You can find your token at
# https://app.logz.io/#/dashboard/settings/manage-accounts
token: <<LOG-SHIPPING-TOKEN>>
type: zeek
fields_under_root: true
encoding: utf-8
ignore_older: 3h

- type: log
paths:
- /var/log/bro/current/notice.log
fields:
logzio_codec: json
# Your Logz.io account token. You can find your token at
# https://app.logz.io/#/dashboard/settings/manage-accounts
token: <<LOG-SHIPPING-TOKEN>>
type: zeek_alert
fields_under_root: true
encoding: utf-8
ignore_older: 3h

Set Logz.io as the output

If Logz.io is not an output, add it now. Remove all other outputs.

Replace <<LISTENER-HOST>> with the host for your region.

# ...
output.logstash:
hosts: ["<<LISTENER-HOST>>:5015"]
ssl:
certificate_authorities: ['/etc/pki/tls/certs/COMODORSADomainValidationSecureServerCA.crt']

Start Filebeat

Start or restart Filebeat for the changes to take effect.

Check Logz.io for your logs

Give your logs some time to get from your system to ours, and then open Open Search Dashboards.

If you still don't see your logs, see Filebeat troubleshooting.