Splunk Enterprise version 8.0 is no longer supported as of October 22, 2021. See the Splunk Software Support Policy for details. For information about upgrading to a supported version, see How to upgrade Splunk Enterprise.
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 8.0.1 This file contains all possible attributes and value pairs for an eventtypes.conf file. Use this file to configure event types and their properties. You can also pipe any search to the "typelearner" command to create event types. Event types created this way will be written to $SPLUNK_HOME/etc/system/local/eventtypes.conf. There is an eventtypes.conf in $SPLUNK_HOME/etc/system/default/. To set custom configurations, place an eventtypes.conf in $SPLUNK_HOME/etc/system/local/. For examples, see eventtypes.conf.example. 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
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 8.0.1 # # 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 13 December, 2019
This documentation applies to the following versions of Splunk® Enterprise: 8.0.1
Feedback submitted, thanks!