salt.engines.http_logstash¶

HTTP Logstash engine¶

An engine that reads messages from the salt event bus and pushes them onto a logstash endpoint via HTTP requests.

Changed in version 2018.3.0.

Note

By default, this engine take everything from the Salt bus and exports into Logstash. For a better selection of the events that you want to publish, you can use the tags and funs options.

configuration

Example configuration

engines:
  - http_logstash:
      url: http://blabla.com/salt-stuff
      tags:
          - salt/job/*/new
          - salt/job/*/ret/*
      funs:
          - probes.results
          - bgp.config

salt.engines.http_logstash.start(url, funs=None, tags=None)¶

Listen to salt events and forward them to logstash.

url: The Logstash endpoint.
funs: None: A list of functions to be compared against, looking into the fun field from the event data. This option helps to select the events generated by one or more functions. If an event does not have the fun field in the data section, it will be published. For a better selection, consider using the tags option. By default, this option accepts any event to be submitted to Logstash.
tags: None: A list of pattern to compare the event tag against. By default, this option accepts any event to be submitted to Logstash.