Knowledge Base Community Release Notes Training Videos Request Demo

Zeek Logs

Connecting Zeek logs to your Panther Console

Overview

Panther supports ingesting Zeek logs via common Data Transport options: Amazon Web Services (AWS) S3 and SQS.

How to onboard Zeek logs to Panther

To pull these logs into Panther:

  1. In the left-hand navigation bar of your Panther Console, click Configure > Log Sources.

  2. Click Create New.

  3. Search for the log type you want to onboard, then click its tile.

  4. Select the data transport method you wish to use for this integration, then follow Panther's instructions for configuring the method:

    1. AWS SQS

    2. AWS S3 bucket

  5. Configure Zeek to push logs to the Data Transport source.

    • See Zeek's documentation for instructions on pushing logs to your selected Data Transport source.

Supported log types

Zeek.CaptureLoss

Zeek CaptureLoss logs evidence regarding the degree to which the packet capture process suffers from measurement loss.

Reference: Capture Loss

schema: Zeek.CaptureLoss
description: Zeek CaptureLoss. It logs evidence regarding the degree to which the packet capture process suffers from measurement loss
referenceURL: https://docs.zeek.org/en/master/scripts/policy/misc/capture-loss.zeek.html
fields:
  - name: acks
    required: true
    type: bigint
  - name: gaps
    required: true
    type: bigint
  - name: peer
    required: true
    type: string
  - name: percent_lost
    required: true
    type: float
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: ts_delta
    required: true
    type: float

Zeek.Conn

Reference: conn.log

schema: Zeek.Conn
description: Zeek Conn
referenceURL: https://docs.zeek.org/en/master/logs/conn.html
fields:
  - name: service
    type: string
  - name: duration
    type: float
  - name: orig_bytes
    type: bigint
  - name: resp_bytes
    type: bigint
  - name: history
    type: string
  - name: conn_state
    required: true
    type: string
  - name: id.orig_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.orig_p
    required: true
    type: bigint
  - name: id.resp_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.resp_p
    required: true
    type: bigint
  - name: local_orig
    required: true
    type: boolean
  - name: local_resp
    required: true
    type: boolean
  - name: missed_bytes
    required: true
    type: bigint
  - name: orig_ip_bytes
    required: true
    type: bigint
  - name: orig_pkts
    required: true
    type: bigint
  - name: proto
    required: true
    type: string
  - name: resp_ip_bytes
    required: true
    type: bigint
  - name: resp_pkts
    required: true
    type: bigint
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uid
    required: true
    type: string
    indicators:
      - trace_id
  - name: uid2
    type: string
    indicators:
      - trace_id

Zeek.DHCP

Reference: dhcp.log

schema: Zeek.DHCP
description: Zeek DHCP
referenceURL: https://docs.zeek.org/en/master/logs/dhcp.html
fields:
  - name: host_name
    type: string
    indicators:
      - domain
  - name: requested_addr
    type: string
    indicators:
      - ip
  - name: duration
    required: true
    type: float
  - name: mac
    required: true
    type: string
    indicators:
      - mac
  - name: msg_types
    required: true
    type: array
    element:
      type: string
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uids
    required: true
    type: array
    element:
      type: string
      indicators:
        - trace_id

Zeek.DNS

Zeek DNS activity

Reference: Zeek documentation - DNS::info 

schema: Zeek.DNS
description: Zeek DNS activity
referenceURL: https://docs.zeek.org/en/current/scripts/base/protocols/dns/main.zeek.html#type-DNS::Info
fields:
  - name: ts
    required: true
    description: The earliest time at which a DNS protocol message over the associated connection is observed.
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uid
    required: true
    description: A unique identifier of the connection over which DNS messages are being transferred.
    type: string
  - name: id.orig_h
    required: true
    description: The originator’s IP address.
    type: string
    indicators:
      - ip
  - name: id.orig_p
    required: true
    description: The originator’s port number.
    type: int
  - name: id.resp_h
    required: true
    description: The responder’s IP address.
    type: string
    indicators:
      - ip
  - name: id.resp_p
    required: true
    description: The responder’s port number.
    type: int
  - name: proto
    required: true
    description: The transport layer protocol of the connection.
    type: string
  - name: trans_id
    description: A 16-bit identifier assigned by the program that generated the DNS query. Also used in responses to match up replies to outstanding queries.
    type: int
  - name: query
    description: The domain name that is the subject of the DNS query.
    type: string
    indicators:
      - domain
  - name: qclass
    description: The QCLASS value specifying the class of the query.
    type: bigint
  - name: qclass_name
    description: A descriptive name for the class of the query.
    type: string
  - name: qtype
    description: A QTYPE value specifying the type of the query.
    type: bigint
  - name: qtype_name
    description: A descriptive name for the type of the query.
    type: string
  - name: rcode
    description: The response code value in DNS response messages.
    type: bigint
  - name: rcode_name
    description: A descriptive name for the response code value.
    type: string
  - name: AA
    description: The Authoritative Answer bit for response messages specifies that the responding name server is an authority for the domain name in the question section.
    type: boolean
  - name: TC
    description: The Truncation bit specifies that the message was truncated.
    type: boolean
  - name: RD
    description: The Recursion Desired bit in a request message indicates that the client wants recursive service for this query.
    type: boolean
  - name: RA
    description: The Recursion Available bit in a response message indicates that the name server supports recursive queries.
    type: boolean
  - name: Z
    description: A reserved field that is usually zero in queries and responses.
    type: bigint
  - name: answers
    description: The set of resource descriptions in the query answer.
    type: array
    element:
      type: string
      indicators:
        - hostname
  - name: TTLs
    description: The caching intervals (measured in seconds) of the associated RRs described by the answers field.
    type: array
    element:
      type: float
  - name: rejected
    description: The DNS query was rejected by the server.
    type: boolean

Zeek.DPD

Zeek Dynamic Protocol Detection.

Reference: dpd.log

schema: Zeek.DPD
description: Zeek Dynamic Protocol Detection
referenceURL: https://docs.zeek.org/en/master/logs/dpd.html
fields:
  - name: analyzer
    required: true
    type: string
  - name: failure_reason
    required: true
    type: string
  - name: id.orig_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.orig_p
    required: true
    type: bigint
  - name: id.resp_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.resp_p
    required: true
    type: bigint
  - name: proto
    required: true
    type: string
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uid
    required: true
    type: string
    indicators:
      - trace_id

Zeek.Files

Reference: files.log

schema: Zeek.Files
description: Zeek Files
referenceURL: https://docs.zeek.org/en/master/logs/files.html
fields:
  - name: analyzers
    required: true
    type: array
    element:
      type: string
  - name: conn_uids
    required: true
    type: array
    element:
      type: string
      indicators:
        - trace_id
  - name: depth
    required: true
    type: bigint
  - name: duration
    required: true
    type: float
  - name: fuid
    required: true
    type: string
    indicators:
      - trace_id
  - name: is_orig
    required: true
    type: boolean
  - name: local_orig
    required: true
    type: boolean
  - name: md5
    required: true
    type: string
    indicators:
      - md5
  - name: mime_type
    type: string
  - name: missing_bytes
    required: true
    type: bigint
  - name: overflow_bytes
    required: true
    type: bigint
  - name: rx_hosts
    required: true
    type: array
    element:
      type: string
      indicators:
        - ip
  - name: seen_bytes
    required: true
    type: bigint
  - name: sha1
    required: true
    type: string
    indicators:
      - sha1
  - name: source
    required: true
    type: string
  - name: timedout
    required: true
    type: boolean
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: tx_hosts
    required: true
    type: array
    element:
      type: string
      indicators:
        - ip

Zeek.HTTP

Reference: http.log

schema: Zeek.HTTP
description: Zeek HTTP activity
referenceURL: https://docs.zeek.org/en/master/scripts/base/protocols/http/main.zeek.html#type-HTTP::Info
fields:
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uid
    required: true
    type: string
    indicators:
      - trace_id
  - name: id.orig_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.orig_p
    required: true
    type: bigint
  - name: id.resp_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.resp_p
    required: true
    type: bigint
  - name: trans_depth
    required: true
    type: bigint
  - name: method
    type: string
  - name: host
    type: string
    indicators:
      - domain
  - name: uri
    type: string
  - name: referrer
    type: string
  - name: version
    type: string
  - name: user_agent
    type: string
  - name: origin
    type: string
  - name: request_body_len
    type: bigint
  - name: response_body_len
    type: bigint
  - name: status_code
    type: bigint
  - name: status_msg
    type: string
  - name: info_code
    type: bigint
  - name: info_msg
    type: string
  - name: tags
    required: true
    type: json
  - name: username
    type: string
  - name: password
    type: string
  - name: capture_password
    type: boolean
  - name: proxied
    type: array
    element:
      type: string
  - name: range_request
    type: boolean
  - name: orig_fuids
    type: array
    element:
      type: string
      indicators:
        - trace_id
  - name: orig_filenames
    type: array
    element:
      type: string
  - name: orig_mime_types
    type: array
    element:
      type: string
  - name: resp_fuids
    type: array
    element:
      type: string
      indicators:
        - trace_id
  - name: resp_filenames
    type: array
    element:
      type: string
  - name: resp_mime_types
    type: array
    element:
      type: string
  - name: current_entity
    type: json
  - name: orig_mime_depth
    type: bigint
  - name: resp_mime_depth
    type: bigint
  - name: client_header_names
    type: array
    element:
      type: string
  - name: server_header_names
    type: array
    element:
      type: string
  - name: omniture
    type: boolean
  - name: flash_version
    type: string
  - name: cookie_vars
    type: array
    element:
      type: string
  - name: uri_vars
    type: array
    element:
      type: string

Zeek.Notice

Reference: notice.log

schema: Zeek.Notice
description: Zeek Notice activities
referenceURL: https://docs.zeek.org/en/master/frameworks/notice.html
fields:
  - name: actions
    required: true
    type: array
    element:
      type: string
  - name: email_dest
    type: array
    element:
      type: string
  - name: dst
    type: string
    indicators:
      - ip
  - name: fuid
    type: string
    indicators:
      - trace_id
  - name: id.orig_h
    type: string
    indicators:
      - ip
  - name: id.orig_p
    type: bigint
  - name: id.resp_h
    type: string
    indicators:
      - ip
  - name: id.resp_p
    type: bigint
  - name: msg
    required: true
    type: string
  - name: note
    required: true
    type: string
  - name: p
    type: bigint
  - name: proto
    type: string
  - name: src
    type: string
    indicators:
      - ip
  - name: sub
    type: string
  - name: suppress_for
    required: true
    type: float
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uid
    type: string
    indicators:
      - trace_id

Zeek.NTP

Reference: ntp.log

schema: Zeek.NTP
description: Zeek Network Time Protocol activity
referenceURL: https://docs.zeek.org/en/master/logs/ntp.html
fields:
  - name: id.orig_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.orig_p
    required: true
    type: bigint
  - name: id.resp_h
    required: true
    type: string
    indicators:
      - ip
  - name: id.resp_p
    required: true
    type: bigint
  - name: mode
    required: true
    type: bigint
  - name: num_exts
    required: true
    type: bigint
  - name: org_time
    required: true
    type: float
  - name: poll
    required: true
    type: float
  - name: precision
    required: true
    type: float
  - name: rec_time
    required: true
    type: float
  - name: ref_id
    required: true
    type: string
  - name: ref_time
    required: true
    type: float
  - name: root_delay
    required: true
    type: float
  - name: root_disp
    required: true
    type: float
  - name: stratum
    required: true
    type: bigint
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true
  - name: uid
    required: true
    type: string
    indicators:
      - trace_id
  - name: version
    required: true
    type: bigint
  - name: xmt_time
    required: true
    type: float

Zeek.OCSP

Reference: ocsp.log


schema: Zeek.OCSP
description: Zeek Online Certificate Status Protocol activity
referenceURL: https://docs.zeek.org/en/v4.0.0/scripts/policy/files/x509/log-ocsp.zeek.html
fields:
  - name: certStatus
    required: true
    type: string
  - name: hashAlgorithm
    required: true
    type: string
  - name: id
    required: true
    type: string
  - name: issuerKeyHash
    required: true
    type: string
  - name: issuerNameHash
    required: true
    type: string
  - name: nextUpdate
    required: true
    type: timestamp
    timeFormats:
      - unix
  - name: serialNumber
    required: true
    type: string
  - name: revoketime
    type: timestamp
    timeFormats:
      - unix
  - name: revokereason
    type: string
  - name: thisUpdate
    required: true
    type: timestamp
    timeFormats:
      - unix
  - name: ts
    required: true
    type: timestamp
    timeFormats:
      - unix
    isEventTime: true

Zeek.Reporter

Zeek internal warnings and errors.

Reference: reporter.log

sch type: bigint
  - name: status_msg
    type: string
  - name: warning
    type: string
  - name: request_body_len
    type: bigint
  - name: response_body_len
    type: bigint
  - name: content_type
    type: string

Zeek.SIP

This schema represents Zeek SIP analysis logs.

Reference: sip.log