XML section name


The labels section of ossec.conf allows additional user-defined information about agents to be included in alerts. When email notifications are enabled, this additional data is also contained in the email alerts without any further configuration.



This option specifies the additional information that will appear in alerts. Labels can be nested in JSON formatted alerts by separating the “key” terms by a period.


key The title that will describe the information of the label.
Allowed value Any string
hidden For labels that are hidden by default.
Default value no
Allowed value yes,no


In internal_options.conf, hidden labels can be set to be displayed in alerts.

Example of configuration

  <label key="aws.instance-id">i-052a1838c</label>
  <label key="aws.sec-group">sg-1103</label>
  <label key="network.ip"></label>
  <label key="network.mac">02:42:ac:11:00:02</label>
  <label key="installation" hidden="yes">January 1st, 2017</label>