# 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.