Standard sheets
Some predefined sheets focusing on different set of events are provided in the analyzer/config/report/sheet/monitoring directory of your Jeyzer installation. Those can be referenced in your report.xml.
The ones prefixed with -graph.xml are configured to generate graph pictures.
Refer to the below sections for any customization, especially if you have adapted/instantiated the Jeyzer monitoring rules to match your needs.
Configuration
Specific sheet attributes :type : must be set to monitoring_events critical_tab_color : defines the tabulation color in case the sheets contains critical events. Defines also the color of the items count cell – for the current sheet entry – in the navigation sheet. Disabled by default.
The Monitoring events sheet contains the following configurable parts :
- Monitoring rules
- Formatting
- Function and contention graph generation
Monitoring rules
The monitoring rules and related stickers determine the list of events to display.
See the rules and stickers sections for the configuration details.
<rules><rule_sets files="repo://base/@@base-shared-deps@@"/><rule_set file="${JEYZER_DEMO_MASTER_PROFILES_DIR}/${JEYZER_TARGET_PROFILE}/monitor/rules/standard_rules.xml"/><all_applicative_rules/><dynamic_rule_sets declared_repository_only="true"/></rules><stickers> <sticker_set file="${JEYZER_DEMO_MASTER_PROFILES_DIR}/${JEYZER_TARGET_PROFILE}/monitor/stickers/demo_stickers.xml"/> <dynamic_sticker_sets declared_repository_only="true"/> </stickers>
Formatting
The following display options are available :
data_format : event date format Java date format syntax
The event date fields are formatted as Excel date cells, which follows the regional settings syntax and display rules. The above date_format applies to text dates like the ones in the event additional information field.
grouping : indicates if consecutive similar events must be grouped. If activate, a collapsed section is created under the first event of the serie. The collapsed section contains the other events. Disabled by default.
group_sorting : events are ordered by date in standard. If the group sorting is active, the events will be grouped first by level (Critical, Warning, Info) and then ordered by date in each one. Disabled by default.
clean_duplicate_events : remove any duplicate event. False by default.
If enabled, it means that several rules of same nature have been defined and are generating therefore duplicate events. It would be preferable to review the rules, which is not always possible when handling various rule sets
links : defines the list of Task Sequence and Monitoring Sequence sheets which can be referenced/linked from this sheet. This is a comma separated list of link acronyms. The acronyms must match the ones defined in those target sheets (see their link_type). Use the key word “all” to include all the possible target sheets.
ranking : defines the event level highlights (usually centralized for consistency).
<display date_format="yyyy/MM/dd HH:mm:ss" grouping="true" group_sorting="false" clean_duplicate_events="false">
<links sequence_sheets="all"/>
<ranking>
<highlights file="${JEYZER_ANALYZER_CONFIG_DIR}/report/highlights/monitoring-event-ranks.xml"/>
</ranking>
</display>
Function and contention graph generation
The configuration of the graph picture generation and Excel inclusion is centralized. The core parts are defined in the default_setup.xml of your Jeyzer installation.
The Excel inclusion configuration is available inside the standard function_graph.xml and contention_graph.xml files (as below). It defines for example the maximum number of pictures (10 by default) which can be generated to limit the footprint.
Pictures are generated thanks to the graph player (which will replay the graph evolution and capture from it the pictures at the right event time). The graph player configuration is available in the function_graph_player.xml and contention_graph_player.xml files (paths are defined in the below files).
See the contention and function graph sections for more details on the picture generation.
<function_graph file="${JEYZER_ANALYZER_CONFIG_DIR}/report/graph/global/function_graph.xml"/>
<contention_graph file="${JEYZER_ANALYZER_CONFIG_DIR}/report/graph/global/contention_graph.xml"/>