Configuration tl;dr

Sample configuration
Encryption certificate
Port 5015. For help finding your region’s listener host, see Account region.
Default log locations
JSON (recommended): /var/ossec/logs/alerts/alerts.json
Plain text: /var/ossec/logs/alerts/alerts.log
Guided configuration

You’ll need: Filebeat 7 or Filebeat 6, root access

  1. Configure OSSEC for JSON alert output

    In the OSSEC configuration file (/var/ossec/etc/ossec.conf), find the <global> tag. Add the <jsonout_output> property and set to yes.


    Restart OSSEC.

    sudo /var/ossec/bin/ossec-control restart
  2. Download the certificate

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

    sudo wget -P /etc/pki/tls/certs/
  3. Add OSSEC as an input

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

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

    # ...
    - type: log
      - /var/ossec/logs/alerts/alerts.json
        logzio_codec: json
        # Your account token. You can find your token at
        token: <<SHIPPING-TOKEN>>
        type: ossec
      fields_under_root: true
      encoding: utf-8
      ignore_older: 3h

    If you’re running Filebeat 7, paste this code block. Otherwise, you can leave it out.

    # ... For Filebeat 7 only ...
    filebeat.registry.path: /var/lib/filebeat
    - rename:
        - from: "agent"
          to: "filebeat_agent"
        ignore_missing: true
    - rename:
        - from: "log.file.path"
          to: "source"
        ignore_missing: true

    If you’re running Filebeat 6, paste this code block.

    # ... For Filebeat 6 only ...
    registry_file: /var/lib/filebeat/registry
  4. Add as an output

    If is not an output, add it now.

    Replace <<LISTENER-HOST>> with your region’s listener host (for example, For more information on finding your account’s region, see Account region.

    # ...
      hosts: ["<<LISTENER-HOST>>:5015"]
        certificate_authorities: ['/etc/pki/tls/certs/COMODORSADomainValidationSecureServerCA.crt']
  5. Start Filebeat

    Start or restart Filebeat for the changes to take effect.

  6. Check for your logs

    Give your logs some time to get from your system to ours, and then open Kibana.

    If you still don’t see your logs, see log shipping troubleshooting.