This documentation does not apply to the most recent version of Splunk. Click here for the latest version.
The following are the spec and example files for transactiontypes.conf.
# Copyright (C) 2005-2011 Splunk Inc. All Rights Reserved. Version 4.2 # # This file contains all possible attributes and value pairs for a transactiontypes.conf # file. Use this file to configure transaction searches and their properties. # # There is a transactiontypes.conf in $SPLUNK_HOME/etc/system/default/. To set custom configurations, # place a transactiontypes.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://www.splunk.com/base/Documentation/latest/Admin/Aboutconfigurationfiles [<TRANSACTIONTYPE>] * Create any number of transaction types, each represented by a stanza name and any number of the following attribute/value pairs. * Use the stanza name, [<TRANSACTIONTYPE>], to search for the transaction in Splunk Web. * If you do not specify an entry for each of the following attributes, Splunk uses the default value. maxspan = [<integer> s|m|h|d] * Set the maximum time span for the transaction. * Can be in seconds, minutes, hours or days, -1 for unlimited * For example: 5s, 6m, 12h or 30d. * Defaults to: maxspan=-1 maxpause = [<integer> s|m|h|d] * Set the maximum pause between the events in a transaction. * Can be in seconds, minutes, hours or days, -1 for unlimited. * For example: 5s, 6m, 12h or 30d. * Defaults to: maxpause=-1 maxevents = <integer> * The maximum number of events in a transaction. If the value is a negative integer then this constraint is disabled. * Defaults to: maxevents=1000 fields = <comma-separated list of fields> * If set, each event must have the same field(s) to be considered part of the same transaction. * For example: fields=host,cookie * Defaults to: "" startswith=<transam-filter-string> * A search or eval filtering expression which if satisfied by an event marks the beginning of a new transaction * For example: * startswith="login" * startswith=(username=foobar) * startswith=eval(speed_field < max_speed_field) * startswith=eval(speed_field < max_speed_field/12) * Defaults to: "" endswith=<transam-filter-string> * A search or eval filtering expression which if satisfied by an event marks the end of a transaction * For example: * endswith="logout" * endswith=(username=foobar) * endswith=eval(speed_field > max_speed_field) * endswith=eval(speed_field > max_speed_field/12) * Defaults to: "" * For startswith/endswith <transam-filter-string> is defined as * syntax: "<search-expression>" | (<quoted-search-expression>) | eval(<eval-expression>) * description = Where: * <search-expression> is a valid search expression that does not contain quotes * <quoted-search-expression> is a valid search expression that contains quotes * <eval-expression> is a valid eval expression that evaluates to a boolean * Examples * search expression: (name="foo bar") * search expression: "user=mildred" * search expression: ("search literal") * eval bool expression: eval(distance/time < max_speed) * connected=<bool> * Relevant iff fields is not empty. Controls whether an event that is not inconsistent and not consistent * with the fields of a transaction, opens a new transaction (connected=t) or is added to the transaction. * An event can be not inconsistent and not consistent if it contains fields required by the transaction * but none of these fields has been instantiated in the transaction (by a previous event addition). * Defaults to: connected=t ### memory constraint options ### maxopentxn=<int> * Specifies the maximum number of not yet closed transactions to keep in the open pool before starting * to evict transactions, using LRU policy. * Defautls to: the default value of this field is read from the transactions stanza in limits.conf maxopenevents=<int> * Specifies the maximum number of events (which are) part of open transactions before transaction * eviction starts happening, using LRU policy. * Defaults to: the default value of this field is read from the transactions stanza in limits.conf keepevicted=<bool> * Whether to output evicted transactions. Evicted transactions can be distinguished from non-evicted * transactions by checking the value of the 'evicted' field, which is set to '1' for evicted transactions * Defaults to: keepevicted=false ### multivalue rendering options ### mvlist=<bool>|<field-list> * Field controlling whether the multivalued fields of the transaction are (1) a list of the original * events ordered in arrival order or (2) a set of unique field values ordered lexigraphically. If a * comma/space delimited list of fields is provided only those fields are rendered as lists * Defaults to: mvlist=f delim=<string> * A string used to delimit the original event values in the transaction event fields. * Defaults to: delim=" " nullstr=<string> * The string value to use when rendering missing field values as part of mv fields in a transactions. * This option applies only to fields that are rendered as lists. * Defaults to: nullstr=NULL ### values only used by the searchtxn search command ### search=<string> * A search string used to more efficiently seed transactions of this type. * The value should be as specific as possible, to limit the number of * events that must be retrieved to find transactions. * Example: sourcetype="sendmaill_sendmail" * Defaults to "*" (all events)
# Copyright (C) 2005-2011 Splunk Inc. All Rights Reserved. Version 4.2 # # This is an example transactiontypes.conf. Use this file as a template to configure transactions types. # # To use one or more of these configurations, copy the configuration block into transactiontypes.conf # in $SPLUNK_HOME/etc/system/local/. # # To learn more about configuration files (including precedence) please see the documentation # located at http://www.splunk.com/base/Documentation/latest/Admin/Aboutconfigurationfiles [default] maxspan = 5m maxpause = 2s match = closest [purchase] maxspan = 10m maxpause = 5m fields = userid