Using Dashboard Reports :: SAS(R) Model Manager 12.1: Tutorials

Overview

The SAS Model Manager Dashboard can provide reports that show the overall state of all projects that are being monitored. The dashboard reports are produced from existing performance monitoring data sets. For each project, a user can define dashboard report indicators that are then used to create the dashboard reports. You view the dashboard reports through the SAS Model Manager Tools menu. These reports are generated in HTML by SAS Model Manager.

Note: The dashboard reports can be defined and generated only by SAS Model Manager administrators and advanced users.

In this exercise, you create a dashboard report definition, generate the dashboard reports, and view the dashboard reports.

Prerequisites

Models Used in Tutorial 3

The exercises in this tutorial depend on some of the properties of the specific models that were added in Tutorial 3. Use the projects, versions, or models that are specified here. This tutorial is designed to follow Tutorial 3: Importing Models, Scheduling Scoring Tasks, and Creating Reports.

The Required Tutorial Files

The exercises in this tutorial depend on the performance task data sets that were created using the tutorial files in Create the Champion Model Performance Data Sets for a Classification Project.

Prepare to Use Dashboard Reports

The dashboard report directory is configured during the installation of SAS Model Manager. The default directory is \SASConfigDir\Lev#\AppData\SASModelManager12.1\Dashboard.

To configure a different directory to store the SAS Model Manager dashboard reports, follow these steps:

Connect to the SAS Workspace Server.
Create a new directory (for example, C:\Dashboard).

Note: The directory must be located on a SAS Workspace Server or a network drive that is accessible by the SAS Workspace Server. Do not include special characters or spaces in the name of the directory.
Grant user permissions for the new directory. For example, perform the following tasks:
- Grant Full Control permission to users who need to create subdirectories, write content, or delete content. This type of user includes a user who you add (using SAS Management Console) to the Model Manager Administrator Users group or a user who is a SAS administrator. This type of user includes users that are in Model Manager Administrator Users group or a user who is a SAS administrator that you added using SAS Management Console.
- Grant Read, Write, and Execute permissions to users who need to create performance indicators and execute dashboard reports. This type of user includes users that are in Model Manager Advanced Users group that you added using SAS Management Console.
- Grant Read and Execute permissions to users who need only to view the dashboard reports. This type of user includes users that are in Model Manager Users group that you added using SAS Management Console.
UNIX Specifics: In a UNIX environment, all SAS Model Manager users must be part of a group that has the appropriate group permissions. For more information, see Creating Operating System Accounts in UNIX Environments in SAS Model Manager: Administrator's Guide and Configuring Users, Groups, and Roles in SAS Model Manager: Administrator's Guide.

Note:
From SAS Management Console, expand the Application Management node on the Plug-ins tab.
Select and expand Configuration ManagerSAS Application Infrastructure.
Right-click Model Manager JavaSvcs 12.1 and select Properties.
(optional) Click the Settings tab and then select Report Options. Use this setting to specify the styles that are available when a user generates dashboard reports, and to enable the indicator override option for defining dashboard report indicators. When the indicator override configuration is enabled, indicators with conditions are available when you add dashboard report indicators using the SAS Model Manager Client.
Click the Advanced tab to modify the application dashboard directory. Change the property value for App.DashboardDir to the directory path that was configured.
Click OK.

Create a Dashboard Report Definition

To create a dashboard report definition, follow these steps:

You must have at least one project that contains performance data before you continue to the next step. For more information, see Create the Champion Model Performance Data Sets for a Classification Project.
Right-click the project folder in the Project Tree, and select Dashboard Report DefinitionNew from the pop-up menu. The New Dashboard Report Definition window appears.

Note: If a dashboard report definition already exists for a project, you can select Edit from the pop-up menu. If you want to delete an existing dashboard report definition, you can select Delete from the pop-up menu.

Click Add. The Add Indicator window appears.

Note: If you want to copy indicators from an existing project, click Copy Indicators instead of Add, follow the prompts, and then skip to step 5.

Select a template from the Template drop-down list.

Note: Click Detail to view information about the selected indicator template.

Enter values for the Normal, Warning, and Alert range definitions.

Example Performance Indicator Values

Indicator Name	Category	Normal	Warning	Alert
CHAR_P1	Characteristic	0 – 1	1 – 2	2 – 3
GINIDECAY	Model Assessment	0 – 0.2	0.2 – 0.4	0.4 – 0.6
STAB_P1	Stability	0 – 1	1 – 2	2 – 3

Click OK. The New Dashboard Report Definition window appears with information about the new indicator.

Repeat step 3 for each indicator that you want to add. To edit an existing indicator, select the indicator, and click Edit.
Select one category indicator for each category, and then select one indicator as the project indicator.

Note: The indicator that you select as a project indicator must also be a category indicator.
Click Next. The New Dashboard Report Definition window appears with information about setting up e-mail notifications.
Select a value from the Project status drop-down list, enter a value for E-mail address, and click Add. Repeat this step for each recipient who you want to send an e-mail notification to about a status. If you want an individual recipient to receive an e-mail notification for each status, you must repeat this step for each status. To delete an e-mail notification, select a project status, and click Delete.
Click Next. The New Dashboard Report Definition window appears with information about setting report types.
By default, all of the report types are selected. To change report types, follow these steps:
1. To add a report type, select a value from the Report type drop-down list, and click Add.
2. To delete a report type, select a value from the Report Description list, and click Delete.
Click Finish. An informational message is displayed indicating that the dashboard report definition were created successfully.

Note: You must define dashboard report indicators for all projects that you want to include in your dashboard reports.

Generate Dashboard Reports

To generate the dashboard reports, follow these steps:

Note: Before you generate dashboard reports, you must have at least one project that contains performance data. That project must have at least one dashboard report indicator that has been defined.

Select ToolsGenerate Dashboard Reports from the menu. The Generate Dashboard Reports window appears.
Select a style for the report from the Style drop-down list.
Select a report option:
- Create reports and data tables for projects that have new performance monitoring data
- Update the style for all reports, using the existing data tables
- Update all reports and data tables for projects whose performance monitoring data or report indicator definitions have changed
(Optional) Select one or more project types that you want to exclude from the dashboard reports.
Click OK. You can view the progress of the dashboard reports in the status bar. A message appears that indicates whether the report was created successfully. The message also displays the location of the dashboard reports on the SAS Workspace Server. Here is an example: C:\SAS\Config\Lev1\AppData\SASModelManager12.1\Dashboard.

Note: SAS Model Manager administrators can configure a different location for the dashboard reports directory. If you set up notifications when you defined the dashboard indicators, the recipients receive e-mail notifications for the configured statuses.

For more information about executing dashboard reports, see the SAS Model Manager: User's Guide.

View the Dashboard Reports

To view the dashboard reports, follow these steps:

Select ToolsView Dashboard Reports

A web page displays a table with dashboard reports for each project that has a dashboard definition.
Select a Project Name or status link to view the associated dashboard reports. The Project Reports Index appears in a new window. If you select a status, only the dashboard reports for that time frame are displayed.

Note: You can also view the report by opening the index.html file directly in the Workspace Server dashboard reports location (for example, c:\SAS\Config\Lev1\AppData\SASModelManager12.1\Dashboard\report).
Select a link from the Report column to view the report details.

Note: To return to the Project Reports Index, select the browser's back button. To return to the All Projects dashboard, select the first tab in the browser window.

For more information about dashboard reports, see the SAS Model Manager: User's Guide.