labels
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.
Options
label
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.
Attributes:
key |
The title that will describe the information of the label. |
|
Allowed value |
Any string that does not start with an underscore ( _ ) |
|
hidden |
For labels that are hidden by default. |
|
Default value |
no |
|
Allowed value |
yes,no |
|
Note
In internal_options.conf, hidden labels can be set to be displayed in alerts.
Note
Keys starting with an underscore character are reserved for the system labels. These labels are invisible and contain internal information of the agents.
Example of configuration
<labels>
<label key="aws.instance-id">i-052a1838c</label>
<label key="aws.sec-group">sg-1103</label>
<label key="network.ip">172.17.0.0</label>
<label key="network.mac">02:42:ac:11:00:02</label>
<label key="installation" hidden="yes">January 1st, 2017</label>
</labels>