The Log File RegEx Statistics attribute group contains
information that shows the statistics of the log file regular expression
search expressions. Regular expressions can be used to filter records
or to define records. This attribute group shows information about
both types. When the Result Type attribute value is INCLUDE or EXCLUDE,
the filter is used to filter records; when the value is BEGIN or END,
the filter is used to define records. The CPU measurements are approximations
based on the granularity of the data exposed by the operating system.
This can result in values of 0.00 when a regular expression takes
little time to evaluate. The CPU times should be used to determine
the relative cost of regular expressions and to optimize the behavior
of specific specific regular expressions.
- Historical group
- This attribute group is eligible
for use with Tivoli Data
Warehouse.
- Attribute descriptions
- The following list contains information about each attribute
in the Log File RegEx Statistics attribute group:
- Node attribute: This attribute is a key attribute.
- Description
- The managed system name of the agent.
- Type
- String
- Source
- The source for this attribute is the agent.
- Warehouse name
- NODE
- Timestamp attribute
- Description
- The local time at the agent when the data was collected.
- Type
- String
- Source
- The source for this attribute is the agent.
- Warehouse name
- TIMESTAMP
- Table Name attribute: This attribute is a key attribute.
- Description
- The name of the log file attribute group.
- Type
- String
- Warehouse name
- TABLE_NAME or TBLNAME
- Attrib Name attribute: This attribute is a key attribute.
- Description
- The name of the attribute to which this filter is applied.
- Type
- String
- Warehouse name
- ATTRIB_NAME or ATRNAME
- Filter Number attribute
- Description
- The sequence number, starting at zero, of the filter being used
for the attribute.
- Type
- Integer (32-bit numeric property)
- Warehouse name
- FILTER_NUMBER or FLTRNUM
- Average Processor Time attribute
- Description
- The average number of processor seconds used to process the filter
for this attribute. The average processor time is the total processor
seconds divided by the filter count.
- Type
- Real number (32-bit gauge) with two decimal places of precision
with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown
in parentheses. The following values are defined:
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- AVERAGE_PROCESSOR_TIME or CPUTAVG
- Total Processor Time attribute
- Description
- The total number of processor seconds used to process the filter
for this attribute. The processor time is cumulative and is truncated,
not rounded. This is similar to the Linux /proc/123/task/12/stat where
123 is the PID of the process and 12 is the thread id.
- Type
- Real number (64-bit counter) with enumerated values. The strings
are displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values that are shown in parentheses. The following
values are defined:
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- TOTAL_PROCESSOR_TIME or CPUTIME
- Max Processor Time attribute
- Description
- The maximum number of processor seconds used for a single filter
processing. It is possible that the maximum is zero if the filter
has never been used or if each of the filter processing took less
than one hundredth of a second.
- Type
- Real number (32-bit gauge) with two decimal places of precision
with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown
in parentheses. The following values are defined:
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- MAX_PROCESSOR_TIME or CPUTMAX
- Min Processor Time attribute
- Description
- The minimum number of processor seconds used for a single filter
processing. It is possible that the minimum is zero if one of the
filter processing took less than one hundredth of a second.
- Type
- Real number (32-bit gauge) with two decimal places of precision
with enumerated values. The strings are displayed in the Tivoli Enterprise
Portal. The warehouse and queries return the values that are shown
in parentheses. The following values are defined:
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- MIN_PROCESSOR_TIME or CPUTMIN
- Filter Count attribute
- Description
- The number of times the filter has been invoked. Used with the
total processor time to compute the average processor time.
- Type
- Integer (64-bit counter)
- Warehouse name
- FILTER_COUNT or COUNT
- Filter Count Matched attribute
- Description
- The number of times the filter has been invoked and the attribute
matched.
- Type
- Integer (64-bit counter)
- Warehouse name
- FILTER_COUNT_MATCHED or COUNTMA
- Filter Count Unmatched attribute
- Description
- The number of times the filter has been invoked and the attribute
did not match.
- Type
- Integer (64-bit counter)
- Warehouse name
- FILTER_COUNT_UNMATCHED or COUNTUN
- RegEx Pattern attribute: This attribute is a key attribute.
- Description
- The regular expression used for the match.
- Type
- String
- Warehouse name
- REGEX_PATTERN or REGXPAT
- Last Matched Time attribute
- Description
- The last time the filter was used and the result was matched.
- Type
- Timestamp with enumerated values. The strings are displayed in
the Tivoli Enterprise Portal. The warehouse and queries return the
values that are shown in parentheses. The following values are defined:
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- LAST_MATCHED_TIME or LASTMAT
- Last Unmatched Time attribute
- Description
- The last time the filter was used and the result was unmatched.
- Type
- Timestamp with enumerated values. The strings are displayed in
the Tivoli Enterprise Portal. The warehouse and queries return the
values that are shown in parentheses. The following values are defined:
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- LAST_UNMATCHED_TIME or LASTUMA
- Result Type attribute
- Description
- The filter type can be INCLUDE or EXCLUDE to accept or reject
the attribute if the filter matches, respectively; the filter type
can be BEGIN or END to specify the start or end of a record for multi-line
records.
- Type
- Integer (32-bit numeric property) with enumerated values. The
strings are displayed in the Tivoli Enterprise Portal. The warehouse
and queries return the values that are shown in parentheses. The following
values are defined:
- UNKNOWN (0)
- INCLUDE (1)
- EXCLUDE (2)
- BEGIN (3)
- END (4)
Any other value is the value that is returned by the agent in
the Tivoli Enterprise Portal.
- Warehouse name
- RESULT_TYPE or RSTTYPE