ExportXMLWordPrintable

    • Type: Change Request
    • Resolution: Duplicate
    • Priority: Minor
    • None
    • Affects Version/s: 8.0.0
    • Component/s: Documentation (D)
    • None

      The Complex event processing documentation describes the Pattern match time window in just one paragraph, without explaining how the script works. The cep_get_events() function is not documented either.

      Currently, the only explanation is available in the Zabbix Summit 2026 slides, which makes it difficult for users to write their own Pattern match scripts based on the documentation alone:

      https://assets.zabbix.com/events/2026/zabbix_summit_2026/slides/d1/3_Kaspars_Mednis.pdf
      https://assets.zabbix.com/events/2026/zabbix_summit_2026/slides/d2/8_Kaspars_Mednis.pdf

      Documentation page:
      https://www.zabbix.com/documentation/current/en/manual/events/complex_event_processing

      Please add the following information:

      1. How the script works: it runs every second, checks the events currently in the time window, must return true or false and cannot modify events
      2. The cep_get_events() function and the available read-only event properties: eventid, name, clock, ns, severity, tags, is_open, is_suppressed, is_symptom and is_copied
      3. A note that host, host group and proxy information is not available to the script
      4. At least one complete example showing the script and the corresponding operations. The two Pattern match sample rules included in Zabbix 8.0 could be used
      5. An explanation that "Pattern matched" operations apply to all events in the window unless restricted by the operation filter
      6. A note that resolved events remain in the window until Duration expires, so scripts should check is_open

       

            Assignee:
            Zabbix Development Team
            Reporter:
            Michal Kudlacz
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: