Chat now with support
Chat with Support

Foglight Experience Monitor 5.8.1 - User Guide

Installing and configuring Multi-appliance clusters Configuring the appliance Specifying monitored web traffic Transforming monitored URLs Managing applications Foglight components and the appliance Using the console program Troubleshooting the appliance Appendix: Third party software Monitoring the user experience Customizing reports The alarm system Integrating the appliance SOAP-based web services

Managing reports in report sets

Whenever you view a report set in the web console, you are essentially viewing a collection of component reports that together form a common theme (for example, “What is the quality of the end-user experience?”).

The Edit Report Set page shows which reports are currently included in the report set, and lists them in the Reports section.

The reports included in the report set, and the order in which they are listed, are apparent whenever you view the report elsewhere in the web console.

When the report set is viewed, its Reports are shown in the order defined (here, left to right and top to bottom).

You can reorder how the reports are displayed when the report set is viewed by using the and buttons.

You can remove a report by selecting its check box, and clicking.

Adding reports to a report set

Each report, whether it consists of a chart or table, reports on specific metrics collected by the appliance. Considering the large number of metrics available, there are is an equally large number of ways in which reports can be combined to form a report set so that it can shed light on a particular aspect of the service delivery chain.

At the bottom of every Edit Report Set page are links that allow you to add new content to the report set.

There are seven types of reports that can be added to a report set.

Metric Charts

A report based on specific resources, displayed as a chart.

See Adding metric charts.

Metric Tables

Identical to adding a metric chart, except the report is displayed in tabular form.

See Adding metric tables.

Analysis Charts

A query that finds the highest or lowest values for a statistic (for example, “Top 5 Web Pages by Download Count”), and displays them as a bar or line chart.

See Adding analysis charts.

Analysis Tables

Similar to analysis charts in that they query the system for the highest and lowest values of a statistic, but different in that the results are displayed as a table that may contain additional metrics.

See Adding an analysis table.

Alarm Log

Displays a list of alarm definitions that you can add to the alarm log report.

See Adding an alarm log.

SOAP Fault Log

Displays a list of SOAP Faults detected in the SOAP traffic monitored by the appliance.

See Using the SOAP Fault Log.

HTTP Fault Log

Displays a list of HTTP Faults detected whenever any HTTP response code that is considered an error is monitored in the traffic.

See HTTP Fault Log details.

Choosing a metric to add to a report

When you choose to create a report from a metric chart or table, or analysis chart or table, you are taken to the configuration page for that Report type:

Although each configuration page contains a unique set of options, a common task involves you indicating which individual metric are the focal point of the report. On these pages, when you click Add Metric, a Metric List window is displayed, showing a list of all metrics.

These metrics are hierarchically listed by category, and are identical to the structure discussed in Finding data based on metrics.

Click the buttons to expand the list of metrics for each category and subcategory. Selecting a metric from the list closes the window, and adds the metric to the component configuration page with its default values.

The next sections provide information about the configuration pages for each of the different report types.

This functionality allows you to easily create multiple reports on the same metric, providing multiple ways to look at the same information.

When you click Add Metric Chart while editing a report set, the Edit Report Set > Metric Chart page is displayed.

In the Definition section, configure how the metric chart is displayed in the report to which it is being added.

3
Use the Time Frame box to select a predefined time frame for the chart. For more information, see “Time frames in which metrics are viewed” in the Foglight Experience Monitor Metric Reference Guide.

You can specify a threshold line that appears in red on the chart. This is useful if you have a predetermined reference point for a metric that you wish to make visually apparent on the chart.

1
In the Metrics section, click Add Metric to display the Metric List window, from which you can select the first metric this report component displays (see Choosing a metric to add to a report for a review of the Metric List).
3
In the Label box for each metric, you can specify a label that appears in the legend for that metric. The label initializes with default values based on the metric you selected.
5
Metrics for which historical data is available present a Show Baseline check box. Select this if you would like the baseline values for this metric and resource to appear in the chart.

For each metric added, you must select the specific resource that provides the data to be displayed. Click Choose Resource to display the Resource List window, and select a resource from the list.

The metric chart is based on the entry selected from the Resource List.

All known resources in the particular metric category are presented in the Resource List. Browse through it (it may be spread across multiple pages), or enter a search term to refine the list for making a selection.

When you click a resource, the Resource List window closes, and you are returned to the Edit Report Set > Metric Chart page, where the selection is listed in the Resource box.

You can continue to edit and combine resources that are added to your report by clicking the Add Metric link found at the bottom of the Metrics section.

Whenever you complete the addition of another metric to your metric chart, the Metrics section is updated to include all metrics added up to that point. The order in which the metrics appear here is identical to how their data is displayed in the report set. You can also reorder the metrics by using the and buttons. Remove a metric by selecting its check box, and clicking Delete.

When you have completed defining and modifying the contents of the report, click OK. Doing so returns you to the main Edit Report Set page, where you can continue to add other reports to the report set.

When you click Add Metric Table while editing a report set, the Edit Report Set > Metric Table page is displayed.

In the Definition section, configure how the metric table is displayed in the Report to which it is being added.

This name appears in the Reports section of the Edit Report Set page, and it is also used as the title of the chart when the report set is displayed.
2
Use the Time Frame box to select a predefined time frame for the chart. See also “Time frames in which metrics are viewed” in the Foglight Experience Monitor Metric Reference Guide.
1
In the Metrics section, click Add Metric to display the Metric List window, from which you can select the first metric this report displays (see Choosing a metric to add to a report for a review of the Metric List).
5
Metrics for which historical data is available presents a Show Baseline check box. Select this if you would like the baseline values for this metric and resource to appear in the table.

You must select the specific resource that provides the data to be displayed. Click Choose Resource to display the Resource List window, and select a resource from the list.

All known resources in the particular metric category are presented in the Resource List. Browse through it (it may be spread across multiple pages), or enter a search term to refine the list.

When you click a resource, the Resource List window closes, and you are returned to the Edit Report Set > Metric Table page. Your selection is listed in the Resource box.

You can continue to edit and combine resources that are added to your Report by clicking the Add Metric link, found at the bottom of the Add Metric section.

Whenever you complete the addition of another metric to your metric table, the Metrics section is updated to include all of them.

The order in which the metrics appear here is identical to how their data is displayed in the report set. You can also reorder the metrics by using the and buttons. Remove a metric by selecting its check box, and clicking Delete.

When you have completed defining and modifying the contents of the metric table, click OK. Doing so returns you to the main Edit Report Set page, where you can continue to add other reports.

When you click Add Analysis Chart while editing a report set, the Edit Report Set > Analysis Chart page is displayed.

In the Definition section, configure how the analysis chart is displayed in the Report to which it is being added.

1
Give the chart a meaningful name in the Title box. This name appears in the caption of the Report when it is displayed.
2
The Time Frame box allows you to select the predefined time frame that the report utilizes. See also “Time frames in which metrics are viewed” in the Foglight Experience Monitor Metric Reference Guide.

You can specify a threshold line that appears in red on the chart. This is useful if you have a predetermined reference point for a metric that you wish to make visually apparent on the chart.

1
In the Analysis Criteria section, select Choose Metric to display the Metrics List window (see Choosing a metric to add to a report for a review of the Metric List). When a metric is chosen, its name appears in the Metric box.
4
For categories that support grouping, an additional Group box may appear. For example, the Site, Page, Hit, and Content Type categories are grouped by protocol: Web (HTTP) and Secure Web (HTTPS). In these cases, select one of the groups from the box.
5
The Additional Filter box allows you to further refine your analysis.
By default, no additional filter is enabled, but you may choose to use a Regular expression to restrict results (for example, select x from y where REGEXP “mysearch”), or use the Choose Resource option to find a specific resource whose relationship with the metric can be used to refine results (for example, if the metric is from the Page category, select a specific web site as a resource to restrict pages used in the Report to just that site).
6
When you have completed defining and modifying the contents of the analysis chart, click OK. Doing so returns you to the main Edit Report Set page, where you can continue to add other reports.

When you click Add Analysis Table while editing a report set, the Edit Report Set > Analysis Table page is displayed.

In the Definition section, configure how the analysis table is displayed in the Report to which it is being added.

1
Give the report a meaningful name in the Title box. This name appears in the caption of the Report when it is displayed.
2
The Time Frame box allows you to select the predefined time frame that the report utilizes. See also “Time frames in which metrics are viewed” in the Foglight Experience Monitor Metric Reference Guide.
1
In the Analysis Criteria section, click Choose Metric to display the Metric List window, where you can select the metric that serves as the criteria for the analysis table. (See Choosing a metric to add to a report for a review of the Metric List.)
4
The value in the Label field for each item appears in the legend of the report, and by default, contains the same name as the metric you chose to include.
5
The Filter box allows you to specify the type of filter the report uses (for more information, see Choosing a filter).
6
For categories that support grouping, an additional Group box may appear. For example, the Site, Page, Hit, and Content Type categories are grouped by protocol: Web (HTTP) and Secure Web (HTTPS). In these cases, select one of the groups from the box.

In some cases, additional filters allow you to refine the analysis further. If this is the case, the Additional Filter option appears. By default, no additional filter is enabled, but you may choose to use one of two additional filters: a regular expression, or a resource.

Use a Regular expression to restrict results (for example, select x from y where REGEXP “mysearch”) by specifying a filter that the system uses.

The alternative is to use the Choose Resource option to find a specific resource whose relationship with the metric can be used to refine results. For example, if the chosen metric is from the Page category, you can also select a specific Site in order to restrict the analysis to pages only found on that site.

Click Choose Resource to display the Resource List window, from which you can choose the resource.

All known resources in the metric’s category are presented in the Resource List. Browse through it, it may be spread across multiple pages, or enter a search term to refine the list.

When you click a resource the Resource List window closes, and you are returned to the Edit Report Set > Analysis Table page. Your selection is listed in the Choose Resource box.

The initial creation of the analysis table involved your choosing a metric as part of the analysis criteria. The chosen metric is represented in the first column of the table that is displayed in the report set.

In the Additional Metrics section of the page, you can add more metrics, each of which forms additional columns in the analysis table.

1
Click the Add Metric link to display a window of relevant metrics. Only metrics within the same category as the metric that was first chosen as part of the analysis criteria is available. Select a metric from the list that is displayed. It appears in the Metrics section with its default values.
3
The text in the Label field represents the column heading in the analysis table.

If you want to rearrange how the metrics are ordered, use the , and buttons. Remove a metric by selecting its check box, and clicking Delete.

When the final report set is viewed, each added metric forms a column in the analysis table.

The table contents are listed in the order that metrics are added (for example, the first added metric is the leftmost column, and the last added metric is the rightmost column).

When you click Add Alarm Log at the bottom of the Edit Report Set page, you can create an alarm report that is included in the report set. The alarm report includes an alarm definition. Only alarms generated by the alarm definition will appear in the alarm log. Clicking the link takes you to the Edit Report Set > Alarm Log page.

3
In the Filter list, you can choose either All Categories to show alarms from all categories, or select a specific category to show alarms only for that category.
a
Click the Choose Resource link. The Resource list which corresponds to the Filter selection opens. Select the resource that you want to use to generate the report. For example, if Servers was selected as the Filter, the Resource list displays a list of all available servers that the appliance is monitoring.
4
In the Severity box, you can filter the resultant list of alarms by including only those of a certain level of severity.
5
Use the Time Period box to further filter the resultant alarm list by choosing a pre-defined time period during which triggered alarms are displayed.
6
In the Number of Alarms field, enter the number of alarms that are present in the report.
7

When you click Add SOAP Fault Log at the bottom of the Edit Report Set page, you are given the opportunity to create an alarm report that is included in the report set.

Use the Edit Report Set > Add SOAP Fault Log page to configure how alarms are displayed in your report set. Clicking the link takes you to the Edit Report Set > SOAP Fault Log page.

3
In the SOAP Server box you can search for faults that occurred on a specific SOAP server. SOAP Servers are identified by the destination IP address in SOAP message traffic.
4
In the SOAP Consumer box you can search for faults that occurred for a specific SOAP Consumer. SOAP Consumer provides metrics from the perspective of consumers of your SOAP based web services.
5
In the SOAP Operations box you can search for faults that occurred on a specific SOAP Operation. A SOAP operation is defined by the SOAP Action String in the HTTP header and the SOAP function name embedded in the SOAP body of a SOAP message.
6
Select an option from the Time Period box (1, 2, 4, 12, or 24 hours), or use the Time Range boxes to define start and end times, as well as the date of the log.
7
In the Number of Alarms field, enter the number of alarms that are present in the report.

When you click Add HTTP Fault Log at the bottom of the Edit Report Set page, you are given the opportunity to create an alarm report that is included in the report set. Clicking the link takes you to the Edit Report Set > HTTP Fault Log page.

3
Select the fault type in the Response Code box. Select All to display all types of faults generated by the any alarm definition.
4
In the Server box you can search for faults that occurred on a specific server.
5
In the Hit box you can search for hits that caused an HTTP error. A hit is uniquely identified by the URL used in the request.
6
Select an option from the Time Period box (1, 2, 4, 12, or 24 hours).
7
In the Number of Faults field, enter the number of alarms that is present in the report.

Setting preferences

The Preferences page allows you to configure settings for your user account. Access this page by clicking Configure > Preferences on the main menu.

For more details, refer to these topics:

Related Documents