# HTTP-Request

## Purpose

http_request(str)

Performs a http request to target and returns the result of said request.

Note

this function is very slow and therefore we suggest using it only seldomly to insure adequate performance.

## Example

The following example performs a http request and writes the returned value to a file.

    module(load="../plugins/imtcp/.libs/imtcp")
    module(load="../plugins/fmhttp/.libs/fmhttp")
    input(type="imtcp" port="13514")

    template(name="outfmt" type="string" string="%$!%\n")

    if $msg contains "msgnum:" then {
         set $.url = "http://www.rsyslog.com/testbench/echo-get.php?content=" & ltrim($msg);
         set $!reply = http_request($.url);
         action(type="omfile" file="rsyslog.out.log" template="outfmt")
    }

See also

Help with configuring/using `Rsyslog`:

- Mailing list - best route for general questions

- GitHub: rsyslog source project - detailed questions, reporting issues that are believed to be bugs with `Rsyslog`

- Stack Exchange (View, Ask) - experimental support from rsyslog community

See also

Contributing to `Rsyslog`:

- Source project: rsyslog project README.

- Documentation: rsyslog-doc project README

Copyright 2008-2020 Rainer Gerhards (Großrinderfeld), and Others.