IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Filter and enhance data with processors
editFilter and enhance data with processors
editYou can define processors in your configuration to process events before they are sent to the configured output. The libbeat library provides processors for:
- reducing the number of exported fields
- enhancing events with additional metadata
- performing additional processing and decoding
Each processor receives an event, applies a defined action to the event, and returns the event. If you define a list of processors, they are executed in the order they are defined in the Packetbeat configuration file.
event -> processor 1 -> event1 -> processor 2 -> event2 ...
For example, the following configuration includes a subset of the Packetbeat DNS fields so that only the requests and their response codes are reported:
processors: - include_fields: fields: - client.bytes - server.bytes - client.ip - server.ip - dns.question.name - dns.question.etld_plus_one - dns.response_code
The filtered event would look something like this:
{ "@timestamp": "2019-01-19T03:41:11.798Z", "client": { "bytes": 28, "ip": "10.100.6.82" }, "server": { "bytes": 271, "ip": "10.100.4.1" }, "dns": { "question": { "name": "www.elastic.co", "etld_plus_one": "elastic.co" }, "response_code": "NOERROR" }, "type": "dns" }
If you would like to drop all the successful transactions, you can use the following configuration:
processors: - drop_event: when: equals: http.response.status_code: 200
If you don’t want to export raw data for the successful transactions:
processors: - drop_fields: when: equals: http.response.status_code: 200 fields: ["request", "response"]