File: message-msgid.rst

package info (click to toggle)
rsyslog 8.2512.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 30,464 kB
  • sloc: ansic: 123,809; sh: 42,109; makefile: 5,962; javascript: 1,842; python: 1,222; lex: 607; yacc: 193; perl: 162; sql: 103; tcl: 9; ruby: 2
file content (44 lines) | stat: -rw-r--r-- 1,018 bytes parent folder | download
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
40
41
42
43
44
.. _prop-message-msgid:
.. _properties.message.msgid:

msgid
=====

.. index::
   single: properties; msgid
   single: msgid

.. summary-start

Carries the MSGID header field defined in RFC 5424 Section 6.2.7.

.. summary-end

This property belongs to the **Message Properties** group.

:Name: msgid
:Category: Message Properties
:Type: string

Description
-----------
Carries the ``MSGID`` header field defined in RFC 5424 Section 6.2.7. The
value identifies the semantic type of the event (for example an SMTP
transaction label) and RFC 5424 allows the NILVALUE (``-``) when the
sender cannot provide one. When rsyslog processes messages that lacked a
syslog header at ingestion, the property contains the configured or
inferred MSGID value rather than an on-the-wire header.

Usage
-----
.. _properties.message.msgid-usage:

.. code-block:: rsyslog

   template(name="example" type="list") {
       property(name="msgid")
   }

See also
--------
See :doc:`../../configuration/properties` for the category overview.