This documentation does not apply to the most recent version of Splunk® Enterprise. Click here for the latest version.Download topic as PDF
The following are the spec and example files for
# Version 9.0.3 # # This file contains descriptions of the settings that you can use to # configure event types and their properties. # # Each stanza controls different settings. # # There is an eventtypes.conf file in the $SPLUNK_HOME/etc/system/default/ directory. # Never change or copy the configuration files in the default directory. # The files in the default directory must remain intact and in their original # location. # # To set custom configurations, create a new file with the name eventtypes.conf in # the $SPLUNK_HOME/etc/system/local/ directory. Then add the specific settings # that you want to customize to the local configuration file. # For examples, see eventtypes.conf.example. # # Any event types that you create through Splunk Web are automatically added to # the user's $SPLUNK_HOME/etc/users/$user/$app/local/eventtypes.conf file. # # To learn more about configuration files (including precedence) please see # the documentation located at # http://docs.splunk.com/Documentation/Splunk/latest/Admin/Aboutconfigurationfiles
# Use the [default] stanza to define any global settings. # * You can also define global settings outside of any stanza, at the top # of the file. # * Each conf file should have at most one default stanza. If there are # multiple default stanzas, attributes are combined. In the case of # multiple definitions of the same attribute, the last definition in the # file wins. # * If an attribute is defined at both the global level and in a specific # stanza, the value in the specific stanza takes precedence.
* Header for the event type * $EVENTTYPE is the name of your event type. * You can have any number of event types, each represented by a stanza and any number of the following attribute/value pairs. * NOTE: If the name of the event type includes field names surrounded by the percent character (for example "%$FIELD%") then the value of $FIELD is substituted into the event type name for that event. For example, an event type with the header [cisco-%code%] that has "code=432" becomes labeled "cisco-432". disabled = [1|0] * Toggle event type on or off. * Set to 1 to disable. search = <string> * Search terms for this event type. * For example: error OR warn. * NOTE: You cannot base an event type on: * A search that includes a pipe operator (a "|" character). * A subsearch (a search pipeline enclosed in square brackets). * A search referencing a report. This is a best practice. Any report that is referenced by an event type can later be updated in a way that makes it invalid as an event type. For example, a report that is updated to include transforming commands cannot be used as the definition for an event type. You have more control over your event type if you define it with the same search string as the report. priority = <integer, 1 through 10> * Value used to determine the order in which the matching eventtypes of an event are displayed. * 1 is the highest priority and 10 is the lowest priority. description = <string> * Optional human-readable description of this saved search. tags = <string> * DEPRECATED - see tags.conf.spec color = <string> * color for this event type. * Supported colors: none, et_blue, et_green, et_magenta, et_orange, et_purple, et_red, et_sky, et_teal, et_yellow
# Version 9.0.3 # # This file contains an example eventtypes.conf. Use this file to configure custom eventtypes. # # To use one or more of these configurations, copy the configuration block into eventtypes.conf # in $SPLUNK_HOME/etc/system/local/. You must restart Splunk to enable configurations. # # To learn more about configuration files (including precedence) please see the documentation # located at http://docs.splunk.com/Documentation/Splunk/latest/Admin/Aboutconfigurationfiles # # The following example makes an eventtype called "error" based on the search "error OR fatal." [error] search = error OR fatal # The following example makes an eventtype template because it includes a field name # surrounded by the percent character (in this case "%code%"). # The value of "%code%" is substituted into the event type name for that event. # For example, if the following example event type is instantiated on an event that has a # "code=432," it becomes "cisco-432". [cisco-%code%] search = cisco
Last modified on 09 December, 2022
This documentation applies to the following versions of Splunk® Enterprise: 9.0.3
Feedback submitted, thanks!