From 649d70929263e19413c1bf8f1133edfb1c06bfb9 Mon Sep 17 00:00:00 2001 From: rebortg Date: Mon, 12 Jun 2023 21:26:19 +0200 Subject: backport new eventhandler feature --- docs/configuration/system/eventhandler.rst | 51 ------------------------------ docs/configuration/system/index.rst | 1 - 2 files changed, 52 deletions(-) delete mode 100644 docs/configuration/system/eventhandler.rst (limited to 'docs/configuration/system') diff --git a/docs/configuration/system/eventhandler.rst b/docs/configuration/system/eventhandler.rst deleted file mode 100644 index 3eab4e2c..00000000 --- a/docs/configuration/system/eventhandler.rst +++ /dev/null @@ -1,51 +0,0 @@ -.. _event-handler: - -Event Handler -------------- - -Event handler allows you to execute scripts when a string that matches a regex -appears in a text stream (e.g. log file). - -It uses "feeds" (output of commands, or a named pipes) and "policies" that -define what to execute if a regex is matched. - -.. code-block:: none - - system - event-handler - feed - description - policy - source - preset - syslog # Use the syslog logs for feed - custom - command # E.g. "tail -f /var/log/somelogfile" - named-pipe - policy - description - event - description - pattern - run - -In this small example a script runs every time a login failed and an interface -goes down - -.. code-block:: none - - vyos@vyos# show system event-handler - feed Syslog { - policy MyPolicy - source { - preset syslog - } - } - policy MyPolicy { - description "Test policy" - event BadThingsHappened { - pattern "authentication failure" - pattern "interface \.* index \d+ .* DOWN.*" - run /config/scripts/email-to-admin - } - } \ No newline at end of file diff --git a/docs/configuration/system/index.rst b/docs/configuration/system/index.rst index 9791ddb1..5bf781af 100644 --- a/docs/configuration/system/index.rst +++ b/docs/configuration/system/index.rst @@ -30,4 +30,3 @@ System :includehidden: default-route - eventhandler -- cgit v1.2.3