summaryrefslogtreecommitdiffstats
path: root/source/rainerscript/functions/mo-http_request.rst
blob: a0b0f22b473d90af7284aa596b2133987e461391 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
************
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.


.. code-block:: none

   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")
   }