Creating and managing custom pages

Use the Custom Views tab to create or edit dashboard pages for selected application or group or instance by adding or updating widgets that are populated with the resource metrics of your choice.

About this task

The pages that you create and save are associated with the selected application. For example, the Inventory Management application in the Cloud APM Guided Demo has the following monitoring agents: Linux® OS, MySQL, Node.js, Hadoop, and Ruby. You can create and save a custom page at any level of the navigator from application to instance and then open it at the same level where it was created. A page that is created at a particular level can be opened only at the same level. The metrics available for the widgets can be from any of the resources in the application. Using the Inventory Management example, you can create a page with a table from the Ruby agent, a chart from Linux OS agent, and so on.

Procedure

The pages that you create and save are associated with the selected application. Complete the following steps to create and customize a dashboard page:

  1. After you open the Application Performance Dashboard from the Performance menu, select an application.
    The Custom Views tab is displayed after Status Overview and Events tabs. You can also drill down to the group, subgroup, or instance level of the navigator.
  2. Click the Custom Views tab.
    The tab shows the Select a Template for your Custom page window or the default page if a default page is already set.
    • If the Select a Template for your Custom Page window opens, go to step 4.
    • If the default page is displayed, go to step 3.
  3. Click icon Add to create a new page.
  4. Click a template from the following default template options:
    • 1x1 Template
    • 1x2 Template
    • 2x2 Template
    • 2x3 Template
    • 3x3 Template
    • 3x2 Template
    • 2x1 Template
    • 1x3 Template
    • 3x1 Template

    If you click Back, the page that is marked as favorite or the first page from the list opens. If no page exists, then the Select a Template for your Custom Page window opens.

  5. Customize the template. For details, see Customizing templates.
  6. Create a widget. For details, see Defining widget properties.
  7. Click icon Set Default Timeframe for the page and set the default data retention period for the page to 1, 2, 4, 12, or 24 hours.
  8. When you are ready to save the page, complete these steps:
    1. In the Page Name field, enter name for the page.
      Important: Space, underscore (_), and dash (-) are allowed in the Page name field. However, dash followed by underscore (-_) is not allowed. For example, System-_Overview is not allowed.
    2. Click Save.
      The following changes may occur on the dashboard or message may be displayed:
      • The Dashboard saved message is displayed.
      • If * is selected in the Set Conditions, then the following message is displayed:

        You selected * in Resource Instance or in Set Conditions, which will result in a large number of data series (such as lines on a graph). The large number of data series can make the page readability or performance unusable. The advisable limit for this chart is 50 data series. Adding specific values helps to narrow the data within recommended limits and results in a better user experience.

      • A red indicator is displayed on the Red indicator on chart icon to indicate that chart type is not selected and you need to select it.
      • A red indicator is displayed on the Red indicator on Select Metric icon to indicate that Select Metric is not selected and you need to select it, and then the following message is displayed:

        A metric must be saved to save a chart.

  9. Select any of the following options in the page title bar:
    Option Description
    icon Retrieve latest resource Metric Types Click to refresh metric types. If there is change in the metric type or metric when any agent patch is applied, you need to refresh the metric types.
    The interval between two refreshes is restricted to 15 minutes. If you click icon Retrieve latest resource Metric Types within 15 minutes of previous refresh, then following message is displayed:
    Metadata cache was refreshed recently.
    Please wait for time_remaining minute(s) to reload it.

    When the metadata is loading a loading image is displayed.

    When the metadata is loaded, the following message is displayed:
    Metadata Cache reloaded successfully.
    If the metadata refresh takes more than 30 seconds, then the following message is displayed:
    Reloading of Metadata cache might take some more time. 
    Do you want to wait until it is done?

    You can click Ok or Cancel.

    icon View Dashboard Click to view the data in the dashboard.
    Important: The limit for the number of rows that are returned per data definition is 11,000 rows. By default, latest data is displayed when the limit is crossed. For high volume of data, entire data for selected time interval is not displayed. For example, if you select to view last 24 hours of data for high volume data source, then only last 6 hours of data might be displayed if the 11000 rows limit is reached.

    If in a chart data series exceed 50, then the following message displayed in the widget:

    This chart cannot be loaded because the number of data series (such as lines on a graph) exceeds 50. The number of data series is currently current_data_series. You can reduce the number by selecting fewer metrics or resources instances, or by refining the Conditions per Metric. For more information, see Defining widget properties: for Cloud APM - http://ibm.biz/widgetprops and for Cloud APM Private - http://ibm.biz/widgetprops-private

    If a chart is taking more than 30 seconds to load, then the following message is displayed in the widget:

    This chart took too long to load because of a large amount of data, long network latency, or connectivity issue. Reduce the number of Resource Instances or refine the Conditions per Metric to narrow down the data. For more information, see Defining widget properties: for Cloud APM - http://ibm.biz/widgetprops and for Cloud APM Private - http://ibm.biz/widgetprops-private

    Save As Click the arrow next to Save, and click Save As and specify a different name in the Page Name field to save the page with a different name.
    Important: If you specify a page name same as an existing page, then the existing page is overwritten.
    icon Delete Click to delete the current page.
    icon Back Click to go back to the previous page or favorite page.

What to do next

View the custom pages as described in Viewing custom pages.