HTTP input plugin
---

Status : core plugin, unit tested and maintained.

This plugin is used on log server to receive logs from an HTTP/HTTPS stream. This is useful
in case the agent can only output logs through an HTTP/HTTPS channel.

Example 1:
Config using url: ``input://http://localhost:8080``

Config using logstash format:
```
input {
  http {
    host => 127.0.0.1
    port => 8080
  }
}
```

Example Output:
```
{
  "message": "{\"username\":\"xyz\",\"password\":\"xyz\"}",
  "host": "127.0.0.1",
  "http_port": "8080",
  "path": "/api/login",
  "@timestamp": "2017-08-27T11:15:37.526Z",
  "@version": "1"
}
```

Parameters:

* ``host``: listen address for the HTTP server : can be 0.0.0.0, 127.0.0.1 ...
* ``port``: port for the HTTP server.
* ``type``: to specify the log type, to faciliate crawling in kibana. Example: ``type=http``. No default value.
* ``unserializer``: more doc at [unserializers](unserializers.md). Default value to ``json_logstash``.
* ``ssl``: enable SSL mode. More doc at [ssl](../ssl.md). Default : false
* ``path``: strict path mapping for the HTTP server. Example: ```/api```. Default: false.