State Tracker configuration

Plug-in configuration Copied

The following parameters can be configured for this plug-in:

columns Copied

This is used to configure optional column headings for the sampler. The columns setting on a tracker group takes precedence over this setting.

If you have one or more trackers collecting the same type of information it can be useful to change the default names for the captured event parameters.

Mandatory: No

columns > renameTrackerColumn Copied

Setting this option renames the first column of the dataview to the name you define here. By default the column is named “tracker” as it contains the name of the state tracker.

This can be useful if you have a view of dynamic trackers all tracking the same kind of thing. If you are tracking line statuses for example and your tracker uniquely identifies the line then you may wish to rename the column “line”.

Note

The corresponding setting on a tracker group takes precedence over this setting.

Mandatory: No

columns > column Copied

A column name to replace the default one. Column names replace the default names parameter1…parametern in the order in which they are defined.

Note

The corresponding setting on a tracker group takes precedence over this setting.

Mandatory: No

performance Copied

Optional settings for high volume environments. The performance settings on a tracker group takes precedence over these settings.

Mandatory: No

performance > skipMidSampleUpdates Copied

By default all state changes are reported to the gateway as they are detected. That way for example if a tracker changes state three times the view will update three times so that rules can act upon the change.

Under certain circumstances intermediate state changes may not be of interest with just the final result being of interest. Turning on this setting will reduce network traffic and speed up processing. However important updates may be missed.

Note

The corresponding setting on a tracker group takes precedence over this setting.

Mandatory: No

performance > maxMessagesPerSample Copied

With a very large number of trackers it is possible that the sample cannot be completed within the allotted timeframe. This setting sets a maximum number of messages that the sampler can process in a given sample.

Mandatory: No

performance > minimumReservedRowspace Copied

With a very large number of trackers it is possible to improve the time table to publish the dataview if we have an idea up front how many rows the dataview is likely to contain.

This setting is useful for dataviews with several thousand rows and should be set to the number of expected rows or greater.

Note

The corresponding setting on a tracker group takes precedence over this setting.

Mandatory: No

templateOptions Copied

A place to configure global template options for dynamic trackers.

Mandatory: No

templateOptions > hideTrackerIDs Copied

When using dynamic trackers the ID is reported as the name of the tracker in the first column of the dataview. As the ID is also a capturing group of the regular expression it is also reported on the row as an event parameter.

To suppress this, set this parameter to true and tracker IDs will not be reported in the dataview.

Mandatory: No

Default: false

behavioural Copied

These are settings that affect general behaviour of the sampler.

behavioural > fileTruncateResetsTrackers Copied

When a file reduces in size because the data has been truncated (some scenarios truncate the file at end of day) the usual behaviour is to remember the current states and continue tracking from there.

Note

When a file is truncated and we then lose read access to it the trackers are reset if this setting is enabled, e.g., the Netprobe user no longer has read permissions to a file that has been rolled over.

Enabling this option will force all trackers associated with the file to reset to their default state. All dynamically created trackers are removed.

Mandatory: No

Default: false

trackerGroup Copied

This is a grouping of related trackers to be displayed in the same dataview.

Mandatory: No

trackerGroup > name Copied

The name of the group of trackers. This should be unique among tracker groups and will be used to name the view in which the trackers are displayed.

Mandatory: Yes

trackerGroup > columns Copied

This is used to configure optional column headings for the sampler. The columns setting on a tracker group takes precedence over the global setting.

If you have one or more trackers collecting the same type of information it can be useful to change the default names for the captured event parameters.

Mandatory: No

trackerGroup > columns > renameTrackerColumn Copied

Setting this option renames the first column of the dataview to the name you define here. By default the column is named “tracker” as it contains the name of the state tracker.

This can be useful if you have a view of dynamic trackers all tracking the same kind of thing. If you are tracking line statuses for example and your tracker uniquely identifies the line then you may wish to rename the column “line”.

Note

This takes precedence over the global setting.

Mandatory: No

trackerGroup > columns > column Copied

A column name to replace the default one. Column names replace the default names parameter1…parametern in the order in which they are defined.

Note

This takes precedence over the global setting.

Mandatory: No

trackerGroup > performance Copied

Optional settings for high volume environments. The performance settings on a tracker group takes precedence over the global settings.

Mandatory: No

trackerGroup > performance > skipMidSampleUpdates Copied

By default all state changes are reported to the gateway as they are detected. That way for example if a tracker changes state three times the view will update three times so that rules can act upon the change.

Under certain circumstances intermediate state changes may not be of interest with just the final result being of interest. Turning on this setting will reduce network traffic and speed up processing. However important updates may be missed.

Note

This takes precedence over the global setting.

Mandatory: No

trackerGroup > performance > minimumReservedRowspace Copied

With a very large number of trackers it is possible to improve the time table to publish the dataview if we have an idea up front how many rows the dataview is likely to contain.

This setting is useful for dataviews with several thousand rows and should be set to the number of expected rows or greater.

Note

This takes precedence over the global setting.

Mandatory: No

trackerGroup > trackers Copied

The set of trackers which are members of the group

Mandatory: Yes

trackerGroup > trackers > tracker Copied

A tracker monitors a file for events signifying a logical state change.

One or more trackers may be defined to track / monitor different events. It is possible to have more than one tracker per file.

Mandatory: Yes

trackerGroup > trackers > tracker > name Copied

A unique name used to identity the tracker.

Note

Beginning Geneos 5.14.x, you can use variable for the tracker name. Make sure to update your configuration since the old Name field has been deprecated. The previous <tracker name=""> has been replaced with <tracker><name><data></data></name>.

Mandatory: Yes

trackerGroup > trackers > tracker > filename Copied

A path specifying the file to be monitored. The filename may contain wildcards and standard Geneos dates-stamping within filenames.

Mandatory: No

Default: a filename or stream must be configured

trackerGroup > trackers > tracker > stream Copied

The name of the Geneos stream which this tracker will subscribe to. A stream can optionally be configured instead of a log file to customise data input.

Mandatory: No

Default: a filename or stream must be configured

Wildcard expressions Copied

This configuration supports wildcard expressions for streams coming from other plugins. Supported wildcard characters are * and ?.

A stream matched by a wildcarded tracker will appear in the dataview as a new row with the following name format:

<stream name>.<tracker name>

You can use wildcarded trackers alongside non-wildcarded trackers. The function of non-wildcarded trackers remain independent of the wildcarded trackers.

Dynamic trackers Copied

If a tracker template is enabled, then a stream matched by a wildcarded tracker will appear in the dataview as a new row with the following name format:

<stream name>.<tracker name>.<id>

For more information, see Dynamic Tracking with Templates.

Precedence for wildcarded trackers Copied

Multiple wild-carded trackers can track the same streams within the same tracker group.

Between tracker groups with wildcarded trackers, a stream matching a wildcard expression will fall under the first tracker group whose wildcarded trackers match the stream, and will not appear in other tracker group dataviews. The tracker groups follow a top-down order in the GSE.

State Tracker in Dynamic Entities Copied

State Tracker samplers running under Dynamic Entities follow these behaviours:

For more information, see Dynamic Entities.

trackerGroup > trackers > tracker > rewind Copied

If the Rewind flag is set, the Tracker will monitor the file from the beginning. The default behaviour is to monitor the file as it grows for new events.

If using a Geneos stream for input, this flag is ignored.

Mandatory: Yes

Default: false

trackerGroup > trackers > tracker > filters Copied

Filters are a means of filtering out messages before they are processed.

Mandatory: No

trackerGroup > trackers> tracker > filters > filter Copied

The filter is a regular expression that if matched will stop the message from being processed. For example if the log contains a number of debug messages indicated by DEBUG at the start of the line a filter can simply contain:

^DEBUG

This will filter out all messages beginning with DEBUG before processing.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Mandatory: Yes

trackerGroup > trackers > tracker > messageTimestamp Copied

It is usual for a log file to contain a timestamp. If one exists this provides a place to identify and interpret the timestamp within a message.

Mandatory: No

trackerGroup > trackers > tracker > messageTimestamp > identifyingPattern Copied

This is a regular expression that identifies a timestamp within a message. For example timestamp in of the form:

[2008-12-25-06-00-00] Rest of message here…

Could be picked out with the regular expression:

^\[(\d+-\d+-\d+-\d+-\d+-\d+)\]

This is enough to identify the date within the square brackets at the start of the message.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Mandatory: Yes

trackerGroup > trackers > tracker > messageTimestamp > datePatternGroup Copied

Where a regular expression has a capturing subgroup (a bracketed expression) each one has a number as they appear from left to right starting at 1. Group 0 (zero) is the complete match.

Using the identifying pattern example again:

^\[(\d+-\d+-\d+-\d+-\d+-\d+)]

This regular expression has a capturing subgroup to identify the date within the brackets. So here the datePatternGroup is 1. The default is to use the complete match which would still work in this instance.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Mandatory: Yes

Default: 0

trackerGroup > trackers > tracker > messageTimestamp > dateFormat Copied

This defines the format of the timestamp that has been extracted from the message. The Date codes used define how the adapter processes the timestamp.

To interpret the date from “11:32:22.983 2008-11-21” a format of “%H:%M:%S%f %Y-%m-%d” should be used.

Specifier Replaced by
%a Abbreviated weekday name (i.e. Thu)
%A Full weekday name (i.e. Thursday).
%b Abbreviated month name (i.e. Aug)
%B Full month name (i.e. August)
%c Date and time representation (local dependant)
%d Day of the month (01-31)
%f Milliseconds. (Reads between 0 and 3 digits). The period is part of this code, to read seconds and milliseconds use %S%f. If you do not want the period included in the code please use %Of which reads just the digits.
%g Supports and read micro-second resolution timestamps.
%H Hour in 24h format (00-23)
%I Hour in 12h format (01-12)
%j Day of the year (001-366)
%m Month as a decimal number (01-12)
%M Minute (00-59)
%p AM or PM designation
%S Second (00-61)
%U Week number with the first Sunday as the first day of week one (00-53)
%w Weekday as a decimal number with Sunday as 0 (0-6)
%W Week number with the first Monday as the first day of week one (00-53)
%x Date representation (local dependant)
%X Time representation (local dependant)
%y Year, last two digits (00-99)
%Y Year, last all digits (i.e. 2008)
%Z Timezone name or abbreviation (i.e. CDT)
%% A % sign

On Unix systems some conversion specifications can be modified by preceding the conversion specifier character by the E or O modifier to indicate that an alternative format should be used. If the alternative format or specification does not exist for the current locale, the behaviour will be as if the unmodified conversion specification were used. (SU) The Single Unix Specification mentions %Ec, %EC, %Ex, %EX, %Ey, %EY, %Od, %Oe, %OH, %OI, %Om, %OM, %OS, %Ou, %OU, %OV, %Ow, %OW, %Oy, where the effect of the O modifier is to use alternative numeric symbols (say, roman numerals), and that of the E modifier is to use a locale-dependent alternative representation.

Using the identifying pattern example again:

^\[(\d+-\d+-\d+-\d+-\d+-\d+)]

and this time format:

%Y-%m-%d-%H-%M-%S

It is possible to interpret the timestamp on the message.

Mandatory: Yes

trackerGroup > trackers > tracker > template Copied

If true marks the tracker as a template. When a key is matched a tracker will be created based on this template. The tracker will need to be able to extract an id from the key.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > transitionStates Copied

The logical states for a tracker are defined here.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState Copied

The initial state for the tracker.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > name Copied

A name for the state.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > keys Copied

A collection of regular expressions that would trigger change to this state.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > keys > key Copied

A regular expression that if matched indicates a state change to this state.

Where a regular expression has a capturing subgroup (a bracketed expression) each one has a number as they appear from left to right starting at 1. Group 0 (zero) is the complete match.

Where a capturing subgroup is found it is considered a parameter of the event that triggered the change and will be extracted for the view.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Note

Keys that are part of a template (see tracker > template) must have a named capturing group called “id” (or a series of groups “id1”, “id2”, … “idN”) within the pattern.

The syntax for this is:

(?<id>…)

The name is case sensitive and if your pattern does not contain this an error will be logged and the key ignored.

This is necessary to mark the text that will uniquely identify the item being tracked.

If your pattern contains “id1”, it can also contain “id2”, “id3”, and so on; as long as there are no gaps in the sequence, all such groups will be used to identify the tracked item.

See Dynamic Tracking with Templates for more details.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > DefaultState > keys > key > templateOptions > keyAppliestoAllTemplateInstances Copied

If true the key is processed by all existing instances of the template. The key does not need to contain an ID if this is set.

This can be used to where a single messages indicates completeness for a number of processes for example.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout Copied

A state may optionally timeout at a given time or after a period of time; this is configured by adding a timeout to the state.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > relative Copied

Defines a relative timeout. i.e. 10 minutes or 1 hour.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > relative > interval Copied

A number specifying the length of the relative timeout.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > relative > units Copied

This gives context to the interval.

Possible values:

Mandatory: Yes

Setting Description
seconds The interval is for a number of seconds
minutes The interval is for a number of minutes
hours The interval is for a number of hours

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > absolute Copied

The state times out at an absolute time specified using the 24 hour clock in the format HH:MM[:SS] (the brackets indicate that seconds are optional.) If the state is re-entered after that time, it times out immediately.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > atTimeOfDay Copied

The state times out at a specified time of day specified using the 24 hour clock in the format HH:MM[:SS] (the brackets indicate that seconds are optional.) If the state is entered after the specified time, it will not time out until the same time occurs the following day.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > state Copied

This is a reference to an existing defined state. When a timeout occurs the tracker will change to this state.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > timeout > inlineState Copied

The state to change to on timeout can also be defined inline rather than referencing an existing state.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > defaultState > templateOptions Copied

These options apply only to templates.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > templateOptions > removeTracker Copied

This option removes the tracker when this state is entered. This only applies to trackers created via templates.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > transitionStates > defaultState > allowTransitionToStates Copied

This setting allows transitions to only to the set of states following. If no states are defined then transitions are allowed to any state with a matching event.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > allowTransitionToStates > states > state Copied

A reference to a state defined within the tracker. Transitions are allowed to this state.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > allowTransitionToStates > states > inlineState Copied

This is an inline state definition for a state that you can transition to from this state. This state is one of the allowed transitions.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > allowTransitionToStates > onException > state Copied

A reference to a state defined within the tracker. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > defaultState > allowTransitionToStates > onException > inlineState Copied

This is an inline state definition for a state that you can transition to from this state. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state Copied

Defines an individual logical state for a tracker.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > name Copied

A name for the state.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > keys Copied

A collection of regular expressions that would trigger change to this state.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > keys > key Copied

A regular expression that if matched indicates a state change to this state.

Where a regular expression has a capturing subgroup (a bracketed expression) each one has a number as they appear from left to right starting at

  1. Group 0 (zero) is the complete match.

Where a capturing subgroup is found it is consider a parameter of the event that triggered the change and will be extracted for the view.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Note

Keys that are part of a template (see tracker template must have a named capturing group called “id” (or a series of groups “id1”, “id2”, … “idN”) within the pattern.

The syntax for this is:

(?<id>…)

The name is case sensitive and if your pattern does not contain this an error will be logged and the key ignored.

This is necessary to mark the text that will uniquely identify the item being tracked.

If your pattern contains “id1”, it can also contain “id2”, “id3”, and so on; as long as there are no gaps in the sequence, all such groups will be used to identify the tracked item.

See Dynamic Tracking with Templates for more details.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > keys > key > templateOptions Copied

This contains options applicable to templates associated with the key.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > keys > key > templateOptions > keyAppliestoAllTemplateInstances Copied

If true the key is processed by all existing instances of the template. The key does not need to contain an ID if this is set.

This can be used to where a single messages indicates completeness for a number of processes for example.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > transitionStates > state > timeout Copied

A state may optionally timeout at a given time or after a period of time. Timeout’s make it possible to trigger a state change based on this.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > timeout > relative Copied

Defines a relative timeout. i.e. 10 minutes or 1 hour.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > timeout > relative > interval Copied

A number specifying the length of the relative timeout.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > timeout > relative > units Copied

This gives context to the interval.

Possible values:

Mandatory: Yes

Setting Description
seconds The interval is for a number of seconds
minutes The interval is for a number of minutes
hours The interval is for a number of hours

trackerGroup > trackers > tracker > transitionStates > state > timeout > absolute Copied

The state times out at an absolute time specified using the 24 hour clock in the format HH:MM[:SS] (the brackets indicate that seconds are optional.) If the state is re-entered after that time, it times out immediately.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > timeout > atTimeOfDay Copied

The state times out at an absolute time specified using the 24 hour clock in the format HH:MM[:SS] (the brackets indicate that seconds are optional.) If the state is entered after the specified time, it will not time out until the same time occurs the following day.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > timeout > state Copied

This is a reference to an existing defined state. When a timeout occurs the tracker will change to this state.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > timeout > inlineState Copied

The state to change to on timeout can also be defined inline rather than referencing an existing state.

Mandatory: Yes

trackerGroup > trackers > tracker > transitionStates > state > templateOptions Copied

These options apply only to templates.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > templateOptions > removeTracker Copied

This option removes the tracker when this state is entered. This only applies to trackers created via templates.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > transitionStates > state > allowTransitionToStates Copied

This setting allows transitions to only to the set of states following. If no states are defined then transitions are allowed to any state with a matching event.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > allowTransitionToStates > states > state Copied

A reference to a state defined within the tracker. Transitions are allowed to this state.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > allowTransitionToStates > states > inlineState Copied

This is an inline state definition for a state that you can transition to from this state. This state is one of the allowed transitions.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > allowTransitionToStates > onException > state Copied

A reference to a state defined within the tracker. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > transitionStates > state > allowTransitionToStates > onException > inlineState Copied

This is an inline state definition for a state that you can transition to from this state. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > states Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

The logical states for a tracker are defined here.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

The initial state for the tracker.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > name Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A name for the state.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > keys Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A collection of regular expressions that would trigger change to this state.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > keys > key Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A regular expression that if matched indicates a state change to this state.

Where a regular expression has a capturing subgroup (a bracketed expression) each one has a number as they appear from left to right starting at 1. Group 0 (zero) is the complete match.

Where a capturing subgroup is found it is considered a parameter of the event that triggered the change and will be extracted for the view.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Note

Keys that are part of a template (see tracker template have a named capturing group called “id” within the pattern. Multiple named capture groups (, , etc) are not supported for trackers defined using deprecated syntax.

The syntax for this is:

(?<id>…)

The name is case sensitive and if your pattern does not contain this an error will be logged and the key ignored.

This is necessary to mark the text that will uniquely identify the item being tracked.

See Dynamic Tracking with Templates for more details.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > timeout Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A state may optionally timeout at a given time or after a period of time. Timeout’s make it possible to trigger a state change based on this.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > timeout > relative Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Defines a relative timeout. i.e. 10 minutes or 1 hour.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > timeout > relative > interval Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A number specifying the length of the relative timeout.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > timeout > relative > units Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This gives context to the interval.

Possible values:

Mandatory: Yes

Setting Description
seconds The interval is for a number of seconds
minutes The interval is for a number of minutes
hours The interval is for a number of hours

trackerGroup > trackers > tracker > states > defaultState > timeout > absolute Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > timeout > atTimeOfDay Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > timeout > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This is a reference to an existing defined state. When a timeout occurs the tracker will change to this state.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > timeout > inlineState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

The state to change to on timeout can also be defined inline rather than referencing an existing state.

Mandatory: Yes

trackerGroup > trackers > tracker > states > defaultState > templateOptions Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

These options apply only to templates.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > templateOptions > removeTracker Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This option removes the tracker when this state is entered. This only applies to trackers created via templates.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > states > defaultState > allowTransitionToStates Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This setting allows transitions to only to the set of states following. If no states are defined then transitions are allowed to any state with a matching event.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > allowTransitionToStates > states > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A reference to a state defined within the tracker. Transitions are allowed to this state.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > allowTransitionToStates > states > inlineState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This is an inline state definition for a state that you can transition to from this state. This state is one of the allowed transitions.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > allowTransitionToStates > onException > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A reference to a state defined within the tracker. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > states > defaultState > allowTransitionToStates > onException > inlineState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This is an inline state definition for a state that you can transition to from this state. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > states > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Defines an individual logical state for a tracker.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > name Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A name for the state.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > keys Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A collection of regular expressions that would trigger change to this state.

Mandatory: No

trackerGroup > trackers > tracker > states > state > keys > key Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A regular expression that if matched indicates a state change to this state.

Where a regular expression has a capturing subgroup (a bracketed expression) each one has a number as they appear from left to right starting at 1. Group 0 (zero) is the complete match.

Where a capturing subgroup is found it is consider a parameter of the event that triggered the change and will be extracted for the view.

Perl compatible regular expressions are supported, please see http://www.perl.com/doc/manual/html/pod/perlre.html for reference.

Note

Keys that are part of a template (see tracker > template must have a named capturing group called “id” within the pattern. Multiple named capture groups (, , etc) are not supported for trackers defined using deprecated syntax.

The syntax for this is:

(?<id>…)

The name is case sensitive and if your pattern does not contain this an error will be logged and the key ignored.

This is necessary to mark the text that will uniquely identify the item being tracked.

See Dynamic Tracking with Templates for more details.

Mandatory: No

trackerGroup > trackers > tracker > states > state > timeout Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A state may optionally timeout at a given time or after a period of time. Timeout’s make it possible to trigger a state change based on this.

Mandatory: No

trackerGroup > trackers > tracker > states > state > timeout > relative Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Defines a relative timeout. i.e. 10 minutes or 1 hour.

Mandatory: No

trackerGroup > trackers > tracker > states > state > timeout > relative > interval Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A number specifying the length of the relative timeout.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > timeout > relative > units Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This gives context to the interval.

Possible values:

Mandatory: Yes

Setting Description
seconds The interval is for a number of seconds
minutes The interval is for a number of minutes
hours The interval is for a number of hours

trackerGroup > trackers > tracker > states > state > timeout > absolute Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > timeout > atTimeOfDay Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > timeout > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This is a reference to an existing defined state. When a timeout occurs the tracker will change to this state.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > timeout > inlineState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

The state to change to on timeout can also be defined inline rather than referencing an existing state.

Mandatory: Yes

trackerGroup > trackers > tracker > states > state > templateOptions Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

These options apply only to templates.

Mandatory: No

trackerGroup > trackers > tracker > states > state > templateOptions > removeTracker Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This option removes the tracker when this state is entered. This only applies to trackers created via templates.

Mandatory: No

Default: false

trackerGroup > trackers > tracker > states > state > allowTransitionToStates Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This setting allows transitions to only to the set of states following. If no states are defined then transitions are allowed to any state with a matching event.

Mandatory: No

trackerGroup > trackers > tracker > states > state > allowTransitionToStates > states > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A reference to a state defined within the tracker. Transitions are allowed to this state.

Mandatory: No

trackerGroup > trackers > tracker > states > state > allowTransitionToStates > states > inlineState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This is an inline state definition for a state that you can transition to from this state. This state is one of the allowed transitions.

Mandatory: No

trackerGroup > trackers > tracker > states > state > allowTransitionToStates > onException > state Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

A reference to a state defined within the tracker. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

trackerGroup > trackers > tracker > states > state > allowTransitionToStates > onException > inlineState Copied

Deprecated. See trackerGroup > trackers > tracker > transitionStates.

This is an inline state definition for a state that you can transition to from this state. This state is transitioned to if an event is found that would lead to a transition to a state not in the allowed list.

If this is not set a state change does not occur. This setting has no effect if the list of allowed states is empty.

Mandatory: No

[1] The d isn't really necessary but it's sometimes useful to put it in for people used to POSIX character classes who might not expect a "word" to match digits.
["Geneos"] ["Geneos > Netprobe"] ["User Guide", "Configuration"]

Was this topic helpful?