Working with Custom Reports. Dell Vizioncore

Add to My manuals
235 Pages

advertisement

Working with Custom Reports. Dell Vizioncore | Manualzz

Working with Reports

Working with Custom Reports

213

Working with Custom Reports

If you have the appropriate permissions, the Report Manager dashboard enables you to create a custom report at a more specific level than what is available on the set of supplied report templates. By creating your own report templates you can customize the content and presentation of a report.

Creating a Custom Report Template

The process of creating a custom report is similar to creating a dashboard. You can add any dashboard displayed in the user interface to the list of reports in the Report Manager or Report dashboards. Custom reports that you create will appear under My Dashboards in the navigation panel. They also appear in the Report Manager dashboard as a report template as soon as the report is created, and you can schedule the report.

To create a custom report:

1 In the navigation panel under Dashboards , click Reports > Report Manager . If you do not have access to the Report Manager, in the navigation panel, under

Dashboards , click Reports > Reports .

2 To create a custom report, click the Create Report icon on the Reports dashboard or Report Manager dashboard or click Create Report...

in the action panel.

The Create Report dialog box opens.

3 Type a unique name for the report in the Name box. This is the only information required to create a new report.

Tip Since custom reports are listed under My Dashboards in the navigation panel, you may want to choose a name that indicates that this is a report.

4 To set access to this report, click the edit icon beside Relevant Role(s) and

Allowed Role(s) and select the role(s) to control which users can access the

214 vFoglight

User Guide report. For example, choosing "Operator" publishes your dashboard to everyone with the Operator role.

• Relevant Role —this option is only valid for super users who may have multiple roles. For example, a Java administrator who also has an operator role can choose the Cartridge Developer role to restrict the Operator role from accessing the report.

• Allowed Role —determines which user role is allowed to see the dashboard.

5

6

You can enter a description of the report in the Context Help box. This text appears in a tooltip when you hover over the report name in the navigation panel.

Click OK to save your report.

7

Two additional tabs ( Views and Data ) appear at the top of the action panel.

Select the Views or Data tab and locate the views or portlets that you want to add to your report. You can add both types of information to the same report. For

information on creating and editing charts, see “ Creating a Metrics Chart ” on page 78.

8

9

To add parameterized inputs to include in your report, click the Data tab. A parameterized input allows you to define a view in which you can enter an input value for the object during report scheduling or testing the template.

• Drag an object into the Parameterized Input section.

• Drag an element from the Parameterized Input section onto the workspace to the left.

If you want to add text to the report, click and drag Drag into report to add text under Text in the action panel into the display area and type the text in the

Entering User Text dialog box.

10 If you want to customize the header or footer of the report, click Customize header or Customize footer

in the action panel. For details, see “ Customizing the Header or Footer of a Custom Report ” on page 215.

11 To divide the display area into one, two, or three columns, choose the number of columns in the action panel, under the General tab > Columns.

12 To see how the report will look when it is printed, click Create PDF in the action panel. Use the browser’s Back button to return to the report.

13 You have the option to schedule a report by clicking Schedule Report in the

Reports dashboard or Reports Manager dashboard.

When you have finished creating a report, you do not need to save it. It is automatically available under My Dashboards in the navigation panel and also appears as a template

Working with Reports

Working with Custom Reports

215 in the Report Manager, where it can be scheduled. To schedule the report, see

“ Scheduling a Report ” on page 194. To run and generate a report without scheduling it,

see “ Running a Report ” on page 192.

If you want to preview the report template without scheduling or generating the report,

see “ Adding a New Schedule ” on page 198.

Creating a CSV Report

By generating a comma-separated value (CSV) report, you can import raw data for the contents of the report into Excel for charting and analysis.

Note You can also export metrics and generate a CSV report for a table or chart using the

customizer. See “ Exporting Data from Charts and Tables ” on page 57.

When scheduling a custom report, you can choose to run a report as either a PDF report

or a CSV report using the dropdown. See “ Scheduling a Report ” on page 194.

Note To generate a CSV report, the component type of the report must support CSV output and have meaningful results for the CSV report to generate. This applies to most chart and tables. For the full list of supported component types, see the Web Component Guide . The

CSV option will not appear if the report is not capable of generating meaningful CSV data.

Except for the pre-defined vFMS Database View (diagnostic) report, most default reports will not work as CSV reports.

Customizing the Header or Footer of a Custom Report

You can add custom headers and footers to a custom report while you are creating it, or you can customize them at a later time.

To customize a header or footer:

1

2

Open the report from the Report Manager dashboard.

Click Customize header or Customize footer in the action panel.

The Customize header (or Customize footer) dialog opens.

216 vFoglight

User Guide

3 Click in a text box to add text, or click Page Number , Report Title , Current

Time , or Time Range to add those variables to a box. You can add both text and variables to a box.

4 If you want to add your own graphic to the report, click the icon to the right of

Select an Image to open the Select an Image dialog.

5 From the drop-down selector for the left image, navigate to an image that was previously uploaded and click OK . For more information on uploading an image,

see “ Adding Your Own Logo to Reports ” on page 208.

The image appears in the Customize header dialog box.

6

7

Use the Size text fields and drop-down menu to adjust the size of the image.

If you leave the Maintain Aspect Ratio check box selected, you need to enter only one size value. Clear the check box if you want to change the ratio of the image.

8 Click OK to save your changes.

Printing a Custom Report

You can print a custom report in two ways (when it is in the display area):

• Click Print in the action panel and print the HTML page from the Print dialog.

For more information, see “ Printing Views ” on page 92.

• Click PDF beside the report to print a gray color PDF output of the report from the PDF viewer. To print a colorful PDF report, you need to setup the PDF

behavior in the User Preferences dashboard under the Themes setting. For more information, see “ User Preferences ” on page 36.

Deleting a Custom Report

You can delete any custom report that you have created. You may also be able to delete reports created by other users, depending on the roles that were assigned to them.

Working with Reports

Working with Custom Reports

217

To delete a report:

1

2

Select the report that you want to delete from the list under My Dashboards .

Click Delete this Report in the Actions panel.

A confirmation dialog box appears.

3 Click Delete to confirm the deletion.

Deleting a report removes the report from the My Dashboards view and the

Report Template list.

For details about how to work with charts in a dashboard, see “ Working with Charts ” on page 78.

Example: Create a Custom Host Report

In the following example, you will create a simple custom host report in which you will:

• Include parameterized input in which you can drag and drop views onto your report for the Windows_host object. During report scheduling, you can define what the report’s input values will be at run-time.

• Include host elements (Virtual Memory metrics).

• Test the template.

• Schedule the report to generate hourly.

To create a custom host report:

1 In the navigation panel under Dashboards , click Reports > Report Manager . If you do not have access to the Report Manager, in the navigation panel, under

Dashboards , click Reports > Reports .

2

3

Click the Create Report icon or click Create Report in the action panel.

In the dialog box that appears: a b

Type a report Name .

Select which roles are allowed to view this report.

- Relevant Role —this option is only valid for SuperUsers who may have multiple roles. For example, a Java administrator who also has an operator role can choose the Cartridge Developer role to restrict the Operator role from accessing the report.

- Allowed Role —select the user role that is allowed to view the report.

218 vFoglight

User Guide c To make text appear in a tooltip when you hover over the report name in the navigation panel, type a description of the report in the Context Help text box.

5

6

4 Click OK .

Click the Data tab.

Drag a Host object (Windows_Host) into the Parameterized Input section.

Working with Reports

Working with Custom Reports

7 Drag host elements (i.e. VirtualMemory) from the data or input trees of the

Parameterized Input section onto the display area to the left.

219

8

9

On the navigation panel, under Dashboards , click Reports > Report Manager .

Notice that the report is added to the list of report templates.

From the Report Template, choose the report you created.

10 To test (i.e. preview) your report template before generating the report.

• Click the host report you just created.

• Click Test .

• In the Test dialog box, enter the context for the run-time values to include in your report. This step is optional.

• Click Test .

11 To generate your report hourly, you need to add a schedule.

• Select the report template you just created from the Report Template column.

• Click to open the Scheduled Report Editor.

220 vFoglight

User Guide

12 Enter the report inputs for the time range and Windows host. This step is optional.

13 Click Create to schedule the report.

14 After an hour, the report appears under Generated Reports view.

15 Click pdf to view the generated report.

Example: Create an SLA Availability Report

In the following example workflow, you will create a report showing SLA availability data for the workweek from 8 am to 8 pm.

Reporting Parameters

The report will use the following criteria:

• Outages from 8 am to 8 pm

• Time plot with chart type “Stacking area”

• Include number of outages, outage duration and cause(s) of outage

Step 1: Add a New Schedule

To get the 5 time ranges, schedule the report for Friday nights at 7:59 pm. You will need to create a new schedule since this is not part of the standard schedules in the Schedule drop-down.

Working with Reports

Working with Custom Reports

To create a new schedule:

1

2

In the Report Manager dashboard, click Add New Schedule .

Create the schedule. Type a Schedule Name and Description/Comments .

221

3

4

Click Next .

Add the schedule details.

5

6

Click Add .

View the details of the schedule.

222 vFoglight

User Guide

Step 2: Create the report

To create the report:

1 In the navigation panel under Dashboards , click Reports > Report Manager . If you do not have access to the Report Manager, in the navigation panel, under

Dashboards , click Reports > Reports .

3

4

2 Click the Create Report icon or click Create Report in the action panel.

Type a report Name .

5

If you want to enable this report to be included in other reports, click the Allow this report to be included in another report checkbox.

Select which roles are allowed to view this report.

• Relevant Role —this option is only valid for super users who may have multiple roles. For example, a Java administrator who also has an operator role. The Java administrator can choose the Cartridge Developer role to restrict the Operator role from accessing the report.

• Allowed Role —select the user role that is allowed to view the report.

Working with Reports

Working with Custom Reports

223

6 You can enter a description of the report in the Context Help text box. This text appears in a tooltip when you hover over the report name in the navigation panel.

8

9

7 Click OK .

Click Set metric chart defaults .

In the Chart drop-down choose Stacking Area and click OK .

10 Create two derived metrics for a specific FSMServiceLevelPolicy:

• Outage - every minute, if previously available and currently not, return 1. The sum of this metric over the period gives the number of outages.

• OutageTime - every minute, if unavailable return 60. The sum of this metric over the period gives the approximate outage duration.

11 Create Time Chunks query - the last 5 days in 12 hourly chunks.

Step 3: Generate the Report

To generate your report hourly, you need to add a schedule.

1 Select the report template you just created from the Report Template column.

2

3

4

Click to schedule the report.

Type a name for the scheduled report.

5

In the Schedule drop-down, select Friday nights at 7:59 pm.

Enter the report inputs.

224 vFoglight

User Guide

6

7

8

Click Create to schedule the report.

Check that the report appears under Generated Reports with Filter on Friday after

8:00 pm.

Click PDF to view the generated report.

Figure 8

9

Working with Data and Data

Sources

In vFoglight you can create custom views using the framework that is available in the

Configuration module. This type of work is primarily focused on those users who are advanced dashboard designers.

This chapter contains the following sections:

Overview ....................................................................................................................................226

Data Dashboard ........................................................................................................................226

Data Sources Dashboard ..........................................................................................................229

advertisement

Related manuals

Download PDF

advertisement

Table of contents