http

HTTPPoller allows you to intermittently poll remote HTTP URL, decode the output into an event

Synopsys

http {
    # URL
    url=> "http://google.fr"

}

Available settings

Setting Type Info Default value
codec codec "plain"
interval string ""
method string "GET"
headers hash {}
body location ""
url string required ""
target string "output"
ignore_failure bool true
var hash {}

Common Options

Details

codec

  • Value type is codec
  • Default value is "plain"
  • The codec used for input data. Input codecs are a convenient method for decoding your data before it enters the input, without needing a separate filter in your bitfan pipeline

    interval

  • Value type is string
  • Default value is ""
  • Use CRON or BITFAN notation

    method

  • Value type is string
  • Default value is "GET"
  • Http Method

    headers

  • Value type is hash
  • Default value is {}
  • Define headers for the request.

    body

  • Value type is location
  • Default value is ""
  • The request body (e.g. for an HTTP POST request). No default body is specified

    url

  • This is a required setting
  • Value type is string
  • Default value is ""
  • URL

    target

  • Value type is string
  • Default value is "output"
  • When data is an array it stores the resulting data into the given target field. When target is “” or “.” it try to store retreived values at the root level of produced event (usefull with json content -> codec)

    ignore_failure

  • Value type is bool
  • Default value is true
  • When true, unsuccessful HTTP requests, like unreachable connections, will not raise an event, but a log message. When false an event is generated with a tag _http_request_failure

    var

  • Value type is hash
  • Default value is {}
  • You can set variable to be used in Body by using ${var}. each reference will be replaced by the value of the variable found in Body’s content The replacement is case-sensitive.

    Full configuration blueprint

    Expand me...