Tree structure displays all the metrics in an organized manner. The metrics are displayed within the hierarchy of Group and other components, such as Topology, Metrics, Subjects, and Attributes. It covers the following features
Metrics Tree
This section describes the tree view in Dashboard. The tree structure displays all the metrics available in the current session. The metrics are displayed within the hierarchy of Group i.e. Metric Group, Subject, Attribute Group, and other components, such as Tier, Server, and Instance. You can also search a Group /Metric/Component using the search feature.
Tree Hierarchy
Metrics are arranged in a hierarchical model based on components of topology in a tree. In the first stage i.e. topology, components are grouped under three nodes i.e Metric Groups, Subjects, and Attributes. Further hierarchy (i.e Tier, Server & instance) comes under Subject. Each component of topology i.e. Tier, Server, Instance have nodes like Metric Groups, Subjects, and Attributes in repeated blocks.
At the leaf level of each component, Metric Groups have metrics like system stats, application, network stats, process stats, etc. This hierarchy starts from Application and ends with Metric groups and Metrics. Purpose of keeping the metric group end is to keep the application in the beginning because customers are more aware of the application. If there are no children under the type node, then that node is not visible.
- Topology: Topology is a root Node. This is configurable as it can be Applications etc.
- Metric Groups: Under this node, all metric groups are displayed under that hierarchy component, such as: SystemLinux Extended, Business Transaction, MemoryStats etc. (Vuser Info, SSL Stats, HTTP Requests, Page Dump, Session, Transaction).
- Subjects: Subject means further hierarchy nodes under the particular/specific node.
- Attribute Groups: If Tier has an attribute, then It defines the parameter of the Tier. Parameters of particular nodes are displayed under the attribute group.
- Type Node: Metadata of hierarchy such as: tier, server, and instance are defined as type node.
- Value Node: Value of a type such as: the name of tier, server or instance are termed as value node.
- Metric Group: Under the metric groups node, all metrics are displayed.
- Metric Name: It is displayed under a metric group and it is the last node.
View Metric in Tree
- On click of the Metric icon in the tree, the metrics are displayed in a tree-like structure with only first level nodes, such as Metrics Groups and Subject.
- You can expand the tree, to the bottom level using the expanding button.
- Clicking on the expandable node, you can dig the tier hierarchy.
- If there is only one child node existing under a node then it expands that node to two levels E.g. if you expand a “Subjects” node and it has only one Tier, then the tier also gets expanded. Or a better example could be when there is one Metric Group associated at one metadata level (e.g. server level), then on expanding the metadata level value node, the single Metric Group node also gets expanded and all the metrics are displayed.
- To search for metrics, use the Filter button (
) by using text, part of expression, and regular expressions.
6. To reset the metric tree view, click the Refresh button (
).
Search use cases
You can perform below search operations in Metric Tree.
- Search a metric group name in the tree. For example: Business Transactions, Java Garbage Collection, etc.
- Monitor group names are searched by using the search box.
- To search a monitor group name, select “Group” from the drop down list given in parallel with the search box.
- Type complete monitor group name or type a word from group name along with “*” wildcard.
- Search for a Metric name in the tree. For example: Apigee Requests/Sec, CPU Utilization (Pct), etc.
- Metric names are searched by using the search box.
- To search a Metric name=>Select “Metric” from the drop down list given in parallel with the search box.
- Type complete metric name or type a word from metric name along with “*”
- Search a Subject name in the tree. For example, cprod-green-searchrestapi, cprod-green-snbservice, etc.
- Vector names are searched by using the search box.
- Select “Vector” from the drop down list given in parallel with the search box.
- Type complete vector name or type a word from vector name along with “*” wildcard.
- Search any name (Subject, metric or metric group name) present in the tree.
- Select “All” from the drop down list given in parallel with the search box.
- Type complete name or type a word name along with “*” wildcard.
- Search also works as a filter in the Metric Tree.
- If a search pattern is not present in the tree, an error message is displayed.
Example
Open Related Metrics
This functionality is used to open such metrics from the tree, which are having related hierarchies in same or across groups. This option is displayed for any hierarchical component of the subject value like tier, server, instance, Interface, Destination, Disk Partition, Processor etc.
It has four sub-menus. It can be an exact match or a partial match.
For example, if you are trying to find an open related for Tier>Server, the exact match is Tier>Server and partial match is Tier>Server>Instance or Tier>Server>Device or Tier>Server>Instance>BT.
For menu All/Non-zero/Zero, no window is displayed and it finds open related metrics with exact match till the subject on which you applied it. For the last subject, it applies as ‘All’ but for the above subjects it applies ‘Same’.
For example, if you applied Open Related Members on T1>S1 (Tier>Server) then it finds those metrics which have subjects Tier>Server only and Tier T1 but Server all.
There are following options under each drop-down:
- All: If ‘All’ is selected in drop-down, it means that graphs are displayed from all tiers/servers/instances. System also prompts for displaying graphs on single widget or separate widgets via Show Together button.
- Pattern: If ‘Pattern’ is selected, you can specify a pattern for tier/server/instance. A text box is displayed with the value of the component and this is editable, so you can make a pattern by putting regular expressions. To know more about patterns, click the help icon provided.
- Specified: You can select a specified tier/server/device from the drop-down list.
This section is to define in which groups of metrics you want to find related metrics. You can select to search in all metrics or can select a catalogue or can select Metrics. Catalogue is pre-defined bundled metrics. Here only those catalogues and metrics groups are displayed which are having the same metadata or start with it. In the case of NDE by default the same group and all of its metrics are selected. You can apply filters on the metrics like selecting the metrics from a metric group or a catalog.
Tags
Using the tag feature we will get support for various tags associated with the various servers, services, instances, etc mainly in the cloud environment, so users should be able to see the tree, metrics data, alerts using the tags as a filtering criteria.
It has the following two fields:
- Name: From the dropdown, select the tag name.
- Value: Select the value based on the tag name selected.
Metric Group
In metric group, there are following fields which are to be selected from their respective drop-down which are mentioned below:
- Metric Group: In this field, the group which is to be used for the metric is to be selected.
- Metric Name: In this field, the name which is to be used for the metric is to be selected.
- Subject: In this field, the subject which is to be used for the metric is to be selected. There are following two options which can be choose for subject selection given below:
- All: On selecting this option, the metric will be applied to all the subjects.
- Specified: On selecting this option, the metric will be applied on the selected specified subjects.
Notes:
- In case of specified, there are further options like – Advance and Specified.
- After selecting the metric group, metric name, and select subjects, click on the Add button to add the metric group into the table as shown in Figure 30.
- Advance: You can select All/Select Pattern/Cavisson Tier and its corresponding Servers. You can test the outcome/resultant tier and its servers by clicking the Test button, as shown in below figure.
- Specified: You can select a mix of tiers and servers by using this option, as shown in below figure.
Note:
- Once the selection is done, click the Apply
Once you click on the apply button, the details will be displayed on the Filter in Metrics table as shown in below figure.
- To add the filter metrics to the filter table, click on the Add
On clicking the Add 
button. the filtered metrics will be displayed in the filter metric table as shown in the below figure.
Notes:
- You can add multiple records in this way.
- To delete all records at once, click the Delete button (
) on the top right corner of the table. To delete a particular record, click the Delete button adjacent to that record. - To search records, click the Search button (
).
Metric from Catalogue:
Upon selecting this option, you need to select the catalogue from the drop-down list. Catalogue is a predefined collection of graphs. You can also add graphs to the catalogue or can remove from there by using the “Graph to Filter” table as shown in the below figure.
Note: You can perform the following two operations on the Graph to filter table which are listed below:
- Delete All: This is used for deleting all the entries in the table. To delete all entries, click on the Delete All button.
- Column Filter: This is used for filtering out the columns on the basis of the metric group, metric name, and subjects.
You can make edits to an existing catalogue or can create a new catalogue by using the Save as Catalogue button. Provide the catalog name and its description. This catalogue is saved in a common place, so that it can be used with different modules of Dashboard like Favorites, Alert, Template, Pattern Matching, etc. by just importing the catalogue as per requirement.
Advanced Settings
In this section, you can apply some advanced level operations as shown in the below figure, which are optional.
In the advanced settings window, you can select various options which are listed below:
- Show metric data as: Average, Minimum, Maximum, and Count for All, Zero, Non-Zero and Advanced Will Include or Exclude the Average, Minimum, Maximum, Count and
- Aggregate multiple time series data using
Notes:
- To apply color for a specific operation on a metric, click on the Apply Operation Based Metric Color checkbox and select the For Matching value from the following given options provided in the drop-down. You can choose from any of the following two options given: Exact and Partial.
- If you want to open the applied related metrics with a new layout, then click on the Open with New Layout (s) option and choose from the following options which are listed below:
- Auto
- 1*1
- 2*2
- 3*3
- 4*4
Example of Open Related
Note: On clicking the Open 
button, the applied metrics will be displayed as shown in below figure.
Parameterize
- You can create dynamic favorites by Tier.
- This functionality bundles a customized favorite with metrics related to a single Tier.
- You can then switch to any Tier and see the metrics for the selected Tier.
- It reduces the efforts to create multiple favorites for different tiers. Favorites can be dynamically changed with parameterization.
Group Metrics
This menu is available only for Metric Groups nodes, such as System Linux Extended, Memory Stats etc.
- Open All: It displays all the metrics under the Metric Group in the metric widget (s).
- Non-Zero: It displays all non-zero metrics (i.e. metrics with data) under the Metric Group in the metric widget (s).
- Zero: It displays all zero metrics (i.e. metrics with no data) under the Metric Group in the metric widget (s).
View Open Group Metrics Option:
- Click the Metric icon from the Tree & Click the metrics till Group level (e.g. System Metrics => Device Stats => Cavisson => Available Health).
- This feature opens all the metrics under the selected metric group and displays them on the metric widget.
Example – Open ALL
Open All/ Zero / Non Zero
It displays the last level of the Indices/Vector hierarchy as “All” and rest of the parents as “Same” and “Show Together” flag is off.
If you click on the options for Requests per sec metric under Tier>Server>Instance>Business Transaction then it opens these metrics of all Business Transactions of selected Instance, Server, and Tier.
- Open > All: It opens all Requests per sec metrics one in each widget of all Business Transactions but for selected Instance, Server, and Instance.
- Open > Non-Zero: It opens all non-zero Requests per sec metrics one in each widget of all Business Transactions but for selected Instance, Server, and Instance.
- Open > Zero: It opens all zero Requests per sec metrics one in each widget of all Business Transactions but for selected Instance, Server and Instance.
Merge
To merge metrics of the same group on a single widget based on the selection criteria (with active widget, all, zero, non-zero).
It displays the last level of the Indices/Vector hierarchy as “All” and rest of all the parents as “Same” and “Show Together” flag as “on”. In case of Merge, multiple selected metrics are displayed in one widget.
If you click on the options for Requests per sec metric under Tier > Server > Instance > Business Transaction then it merges these metrics of all Business Transactions of selected Instance, Server and Tier.
- Merge > All: It merges all Requests per sec metrics in one widget of all Business Transactions for the selected Instance, Server and Instance.
- Merge > Non-Zero: It merges all non-zero Requests per sec metrics in one widget of all Business Transactions but for selected Instance, Server and Instance.
- Merge > Zero: It merges all zero Requests per sec metrics in one widget of all Business Transactions but for selected Instance, Server and Instance.
Merge > All
Note: You can compare metrics of different components of hierarchy like all metrics of all servers, all processes or all tiers. In case of the compare members, multiple metrics are always displayed in different widgets.
If you click on the options for requests per sec metric under Tier > Server > Instance > Business Transaction then it merges these metrics of all Business Transactions of selected Instance, Server and Tier. The rule for applying this option is same as Merge option i.e. It displays the last level of Indices/Vector hierarchy as “All” and rest all the parents as “Same” and “Show Together” flag as “On”.
The difference comes when you do this operation at parent node level or with multi-selected metrics, and in this case the different metrics data is always shown in different widgets/panels but in case of merge all the metrics data still be merged in a single widget/panel.
- Compare Members > All: It merges all Requests per sec metrics in one widget of all Business Transactions but for selected Tier, Server and Instance.
- Compare Members > Non-Zero: It merges all non-zero Requests per sec metrics in one widget of all Business Transactions but for selected Instance, Server and Instance.
- Compare Members > Zero: It merges all zero Requests per sec metrics in one widget of all Business Transactions but for selected Instance, Server and Instance.
Example
Note: If selected metrics are one, then Merge and Compare Members functionality is same but if selected metrics in the tree are multiple then functionality is different. In case of Merge, multiple selected metrics are displayed in one widget but in case of comparing members, multiple metrics are always displayed in different widgets.
Advance
Use this option to perform complex operations.
You can do grouping based on Tier, Server, Region, Zone, Node, and Name Space.
- Operations Type: Denotes the operations to be performed on metrics.
- Open Metric: It opens all the individual nodes at individual panels.
- Merge Metric: All the corresponding metrics are displayed in a single widget of the dashboard.
- Advanced Open/Merge: It contains some advanced options for open/merge metrics as displayed in the ‘Operations’ section.
- Advance Compare Group Metric: Compare metrics of different components of hierarchy like all metrics of all servers, all processes or all tiers. In the case of the compare members, multiple metrics are always displayed in different widgets.
- Operations: This section has several dropdown’s as several hierarchical components present on selected metrics e.g. If the metadata of the selected metric is Tier>Server>Instance, then there are three dropdowns. Each dropdown has 3 values:
- Same
- All
- Pattern
Note: Show together can be applied when ‘all’ or ‘patterns’ are selected. If the same value is selected in the dropdown, then the ‘show together’ checkbox is not visible. By selecting the tier and server options, the Show Together check box will be by default enabled.
- Advanced Settings
- Values: You can filter metric values by Min, Max, Avg, Count, Sum Count value of its metric data.
- Open with New Layout(s): On enabling this, the graphs are displayed with a new layout. If it is disabled, the graphs are opened with the existing layout.
Filter by Value
Enable Filter: You can discard the un-desired graphs by using the filter option.
Show Values: Displays the graphs based on the selection criteria.
- No Filter: Displays the graph with no filter value.
- All Non-Zero Values: Displays the graphs with non-zero values.
- All Zero: Displays the graphs with zero values.
- Advanced Filter: Displays some advanced level operations as below:
- Values: There are following filter options, such as <, >, <=, >=, Top, Bottom, In between, which helps to achieve the desired output.
- By: You can filter graph values by Min, Max, and Avg values of its graph data. You can also use the Include or Exclude options to get the filtered results.
- Include/Exclude: These options include/exclude the graphs that lie within the specified values.
- Aggregate Multiple Time Series Data using Function
- Open with New Layout (s)
Note: Once you have filled up all the fields in the advanced open/merge window, you can perform the following operations on the Advance Open Merge Window:
- You can reset the operations window, to reset the window click on the Reset
button. - You can preview the settings which are being applied by clicking on the Preview
On clicking the preview button, the previewed image will be displayed as shown in the below figure.
3. To close the window, click on the Close 
button.
4. To apply the settings, click on the Apply 
button.
After applying the advance settings, the window will be displayed showing the respective applied settings on it as shown in below figure.
Create Derived Metrics
Derived graphs are those graphs that are derived from two or more graphs by applying some formulas. Sometimes, there is a requirement to do some analysis on reports, and for that, some calculations need to be done on reports data to get some derived data. For example, if an average of 3 reports is needed, in that case, derived data is required by adding results of 3 reports and dividing it by 3. Therefore, derived data is something like extracting new information from existing one by performing some calculations on existing data.
Group By
Here, you can apply ‘Group By’ aggregation on the selected metrics based on tier, server, or both. This mechanism is provided to take care of some special cases where hierarchy doesn’t make much sense and you would like to see the data in different hierarchy order.
For Example: In the current “Business Transactions” having hierarchy as ‘Tier>Server>Instance>BT’, you can create a ‘Group By’ aggregation by selecting ‘Tier’ and ‘BT’ and get the same data result as the current Tier>Overall>Overall>BT provides.
This window has two dropdowns. First dropdown has two functions Average and Sum and one option for auto calculation based on Metric type. The second dropdown has each hierarchical metadata component like Tier, Server, which is associated with that specific metric.
Note: Once the user clicks on the Apply button, a dialog box will appear with a Success message which is shown in the below figure.
When you click Apply in this window, it creates a Derived metric and gets added to the respective Tree.
To add a derived graph, provide the following details:
Derived Metric Details
- Derived Metric Name: It is the name for newly created metrics.
For example, if you added two metrics and one expression with Derived Metric name – AvailMem.
A – SysStat.FreeMem.[Tier=*;Host=*]
B – SysStat.CacheMem.[Tier=*:Host=*]
Expression – A + B
Then it will create one more metrics which will be sum of FreeMem and CacheMem.
There are some cases in which you should not specify the metric name, as the metric name will be picked from the metric name.
- Group Name: It is the name of the derived metric group. By default, it is auto filled with the same name as Metric Group.
- Description: It is the purpose of making these derived metrics.
Metric Expression
You can add metrics, apply functions to it, apply unary operations, apply aggregate functions like ‘Group By’, and can execute any expression on selected metrics.
- Metric Group: Select the Metric Group from the list.
- Metric Name: Select the corresponding metric name from the list.
- Subject: To select all/specific subjects. Further, on selecting ‘Specified’, the Specified and Advanced options are displayed.
- You can select the specified graphs from the Specified
- You can add some advanced options for adding graphs from the Advanced section, as shown in below Figure 69.
- In the Select Subject window, there are following two options which you have to fill as described below:
- Advanced: You can select All/Select Pattern/Cavisson Tier and its corresponding servers. You can also test the outcome/resultant tier and its servers by clicking the Test
- Specified: You can select a mix of tiers and servers by using this option.
Note: Once you have filled up all the fields, click on the Apply button to apply the setting.
- Function: Select which function needs to be applied on the selected metric.
- Sum: Addition of values of all metrics specified.
- Avg: Average of values of all metrics specified.
- Min: Minimum value of all metrics specified.
- Max: Maximum value of all metrics specified.
- Sum Count: Cumulative sum of all the count values.
- Count: Adds up count values of all the samples and creates a single metric of counts. Its behavior better matches with the name Sum Count.
- None: This option is used for perform No Operation by the user on the metric.
- Unary Operators: You can apply one or more unary operators. A unary operation is an operation with only one operand, i.e. a single input.
- Log2: log2 computes a base 2 logarithm.
- Log10: log10 computes a base 10 logarithm.
- SampleDiffPct: It is to find %age of difference. previous sample value – current sample value. The diff will be absolute in %.
- % Away from Tier Average: It is to find %age difference of the tier level average data of all hierarchy children with respect to the applied metric data It will show the metric %age away from the Tier Average.
- Adding Metrics: Add the selected metrics with parameters in the list. Each metric line has auto initials like A, B, C etc. You can add more metric rows. In the given text area, you can apply any expression on above defined metrics like A + B or A + B /2 etc.
- Group By Aggregation: It is the way to treat every hierarchy level independently and work like a relational “Group By” concept and hence this aggregation is named as “Group By” This mechanism is provided to take care of some special cases where hierarchy doesn’t make much sense and you would like to see the data in different hierarchy order.
- Functions: It contains the following functions – Average, Sum, Min, Max, Count, SumCount and Sum.
- Hierarchical Metadata Component: It contains each hierarchical metadata component like: Tier, Server, which is associated with that specific metric.
Note: ‘Group By Aggregation’, ‘Functions’, and ‘Hierarchical Metadata Component’ options are only enabled if you select ‘None’ in any of the metrics expressions.
Example
Show Description
This feature is used to display the description of the metrics at group level as well as graph level. To view the description of metrics, right click the group level (to get the description of all metrics of that group) or graph level (to get the description of a particular metric only) and click the Show Description.
Description at Graph Level
