IBM Tivoli Netcool Performance Manager, Version Model Maker Document Revision R2E1. Getting Started with Common Reporting Guide

Transcription

1 IBM Tivoli Netcool Performance Manager, Version Model Maker Document Revision R2E1 Getting Started with Common Reporting Guide

2 Note Before using this information and the product it supports, read the information in Notices on page 31. Copyright IBM Corporation 2011, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents About this information v Getting started with Common Reporting 1 Common Reporting on Tivoli Netcool Performance Manager Accessing Common Reporting in Tivoli Netcool Performance Manager Common Reporting Web-based report authoring Performing ad-hoc reporting TCR Time contents Reports containing both wireless and wireline data. 7 Getting started with wireline reports Limitation on selecting resources in wireline reports Optimizing the common pack attribute data source to improve report performance Wireline data sources Wireline Report Templates Using the wireline report template Design considerations for wireline report authors 13 Getting started with wireless reports Authoring a simple report Authoring an efficient report Authoring a drill-down report Authoring a charting report Drill-through reports Including multiple granularity items in the same report Known Common Reporting issues Additional resources Books Web Resources Notices Trademarks Additional copyright notices Copyright IBM Corp. 2011, 2012 iii

4 iv IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

5 About this information The IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide describes how to get started with Common Reporting in Tivoli Netcool Performance Manager. Copyright IBM Corp. 2011, 2012 v

6 vi IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

7 Getting started with Common Reporting This information explains how users of Tivoli Netcool Performance Manager wireless and wireline components can get started with Tivoli Common Reporting for network performance management. You are guided through the basic reporting tasks, with particular emphasis on techniques that are unique to performance management. Tivoli Common Reporting is based on IBM Cognos Business Intelligence, an enterprise reporting solution. It delivers a subset of IBM Cognos Business Intelligence functionality as a common reporting platform across the Tivoli portfolio. By using Model Maker IBM Cognos Edition, you can extend the domain-specific reporting capabilities of technology packs to Common Reporting by deploying common packs on your system. This information is not a comprehensive guide to Tivoli Common Reporting or IBM Cognos, or a substitute for their respective documentation sets. Rather, it is complementary information that focuses on specific reporting issues for performance management reporting on telecommunications technology. Common Reporting on Tivoli Netcool Performance Manager An overview of Tivoli Common Reporting for Tivoli Netcool Performance Manager users. Accessing Common Reporting in Tivoli Netcool Performance Manager Wireless users access Common Reporting from a separately installed Tivoli Common Reporting interface. Wireline users access Common Reporting in the Tivoli Netcool Performance Manager console. As both applications share the Tivoli Integrated Portal user interface, the basic steps are the same. Before you begin Ensure that you have the appropriate login credentials from your administrator. Procedure 1. Log in to the Tivoli Integrated Portal. 2. In the left navigation, expand Reporting > Common Reporting. The Common Reporting tab opens showing you the Working with reports page. Copyright IBM Corp. 2011,

8 Common Reporting Use the Common Reporting task to publish, find, manage, organize, and view your organization s Business Intelligence content, such as reports, scorecards, and agents. If you have the necessary permissions, you can access the Report Studio and Query Studio or access the administration functions for content administration, including scheduling and distributing reports, and creating jobs. You view reports in Cognos Viewer. System administrators also use the portal to administer servers, optimize performance, and set access permissions. Users of Cognos Connection will be familiar with the Common Reporting task. Cognos Connection is the Web portal for IBM Cognos Business Intelligence 8. It is the starting point to access Business Intelligence information and the functionality of IBM Cognos 8. For more information, see the IBM Cognos 8 Business Intelligence Getting Started Guide at com.ibm.swg.im.cognos.wig_cr doc/wig_cr.html Report Studio Report Studio is a Web-based tool that professional report authors use to build sophisticated, multiple-page, multiple-query reports against multiple databases. With Report Studio, you can create any report that your company requires, such as invoices, statements, and weekly sales and inventory reports. For more information about Report Studio, see the Report Studio Professional Authoring User Guide at topic/com.ibm.swg.im.cognos.ug_cr_rptstd doc/ug_cr_rptstd.html. Query Studio Query Studio is the reporting tool for creating simple queries and reports in Tivoli Common Reporting. For more information about Query Studio, see the Query Studio User Guide at com.ibm.swg.im.cognos.ug_cr_qstd doc/ug_cr_qstd.html. Administration From the Administration component, you can perform server administration, data management, security and content administration, activities management, and portal services administration. For more information about the Administration component, see the IBM Cognos 8 Administration and Security Guide at c8bi/v8r4m0/index.jsp?topic=/com.ibm.swg.im.cognos.ug_cra doc/ ug_cra.html. 2 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

9 Web-based report authoring Create reports in a Web-based tool that professional report authors use to build sophisticated, multiple-page, multiple-query reports against multiple databases. You can create any reports that your company requires, such as invoices, statements, and weekly sales and inventory reports. Procedure 1. Log in to the Tivoli Common Reporting interface, and go to Common Reporting. 2. In the Work with reports window on the right choose Report Studio from the Launch drop-down list. This opens up the Report Studio, a Web-based application. 3. Use the menu controls to create a report or edit existing ones by formatting the layout and manipulating the data that appears in the report. 4. Save your report, and run it at any time. What to do next Learn more about Web-based report authoring in Report Studio Professional Authoring User Guide available on clicking F1 from the Report Studio. Report Specifications When you author a report, you actually create a report specification. The report specification is an XML representation of the queries and prompts that are used to retrieve data, as well as the layouts and styles used to present the data. For simplicity, the report specification is called the report. Report specifications can be useful to report authors for troubleshooting. You can see the XML specification for a report at any time by selecting Tools > Show Specifications from Report Studio. For information about working with report specifications, see the Report Studio Professional Authoring User Guide. Models and packages Because stored data is typically designed for storage and not for reporting, a data modeler uses Framework Manager to create metadata models. A model structures, adds to, and manages data in ways that make sense to business users. For example, a model defines business rules, data descriptions, data relationships, business dimensions and hierarchies, and other administrative tasks. Planning and creating a model is an important task that should be performed by a modeler or a modeling team familiar with both the database structure and the needs of the users. After the metadata model is defined, modelers create a package to make metadata available to report authors. Each package must contain all the information that a specific user or group of users needs to create reports. The Model Maker tooling in Tivoli Netcool Performance Manager simplifies the creation of packages for Tivoli Netcool Performance Manager users. Generally, each report can contain data from only one package. However, using Model Maker, modelers can combine models and create a single package from multiple models to allow reporting across multiple dimensions. Getting started with Common Reporting 3

10 Performing ad-hoc reporting Create reports ad-hoc by using simple queries and formatting. Before you begin To perform ad-hoc reporting you have to have some report packages imported. Procedure 1. Log in to the Tivoli Common Reporting interface, and go to Common Reporting. 2. In the Work with reports window on the right choose the Query Studio from the Launch drop-down list. 3. Select a package to work with. This opens a New window where you can create the new report. 4. From the navigation on the left drag and drop data items you want to include in your report. Tip: Change the appearance of the data by using the menu icons at the top. 5. Once your data and appearance is edited, save the report by specifying a Name, and optionally a Description, and a Screen tip. Results TCR Time contents You have now created your ad-hoc report. What to do next Learn more about authoring the reports in the IBM Cognos Query Studio User Guide. The following timestamp items are available in the TCR Time base common pack. Day, Hour, Minute Presentation View Description Oracle Type Oracle function used when populating column Standard Timestamp Timestamp representing the start of the time period being reported on. Aligns with the granularity of the calendar. TIMESTAMP loaddate where loaddate is the timestamp for the interval we are populating the table with. 01/01/ :00:00 Date Date of the associated calendar entry (that is, midnight of that day). DATE trunc(loaddate,'dd') Year-Month-Day ( ) VARCHAR(10) to_char(loaddate, 'YYYY-MM-DD') Day Day in the month (1-31). SMALLINT to_char(loaddate,'dd') YMD-H :00 VARCHAR(16) to_char(trunc(loaddate, 'HH24'), 'YYYY-MM-DD HH24') Hour Hour of the day (0-23). SMALLINT to_char(loaddate,'hh24') 4 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

11 YMD-H 30 Min String representation of the 30 minute interval timestamp column for example, 01/01/ :30:00 30 Minute Current minute integer value of the 30 minute interval timestamp. YMD-H 15 Min String representation of the 15 minute interval timestamp column for example, 01/01/ :15:00 15 Minute Current minute integer value of the 15 minute interval timestamp YMD-H 10 Min Current minute integer value of the 10 minute interval timestamp. 10 Minute Current 30 minute value of the timestamp (50). YMD-H 5 Min String representation of the 5 minute interval timestamp column for example, 01/01/ :05:00 5 Minute Current minute integer value of the 5 minute interval timestamp. Minute Current single minute value (59). VARCHAR(16) SMALLINT VARCHAR(16) SMALLINT VARCHAR(16) SMALLINT VARCHAR(16) SMALLINT SMALLINT to_char(ts30, 'YYYY-MM-DD HH24:MI') where ts30 is the loaddate timestamp truncated to a 30 minute interval to_char(ts30, 'MI') to_char(ts15, 'YYYY-MM-DD HH24:MI') where ts15 is the loaddate timestamp truncated to a 15 minute interval to_char(ts15, 'MI') to_char(ts10, 'YYYY-MM-DD HH24:MI') where ts10 is the loaddate timestamp truncated to a 10 minute interval to_char(ts10, 'MI') to_char(ts5, 'YYYY-MM-DD HH24:MI') where ts5 is the loaddate timestamp truncated to a 5 minute interval to_char(ts5, 'MI') to_char(loaddate,'mi') Year, Quarter, Month, Day Presentation View Description Oracle Type Oracle function used when populating column Year Year in 4-digit format SMALLINT to_char(loaddate,'yyyy') for example, Quarter Quarter of the year (1, SMALLINT to_char(loaddate,'q') 2,3or4). Year-Quarter VARCHAR(7) to_char(loaddate, 'YYYY-Q') Month (Numeric) Month (01-12). SMALLINT to_char(loaddate,'mm') Month Name of the Month. VARCHAR trim(to_char(loaddate,'month')) Year-Month VARCHAR(7) to_char(loaddate, 'YYYY-MM') Days in Month Number of days in the month (31). Week of Year Week of year (1-53) where week 1 starts on the first day of the year and continues to the seventh day of the year. SMALLINT SMALLINT ADD_MONTHS(to_date(TO_CHAR(loaddate, 'yyyy-mm') '-01', 'yyyy-mm-dd'),1) - to_date(to_char(loaddate, 'yyyy-mm') '-01', 'yyyy-mm-dd') to_char(loaddate,'ww') Getting started with Common Reporting 5

12 Week of Quarter Week of Quarter (1-13) 13 weeks per quarter. Week of Month Week of month (1-5) where week 1 starts on the first day of the month and ends on the seventh. SMALLINT to_char(loaddate,'ww') - (to_char(loaddate,'q') - 1)*13 SMALLINT round(to_char(loaddate,'dd')/7 + 1) where loaddate is the timestamp interval we are populating. Weekday Name of the Day. VARCHAR trim(to_char(loaddate,'day')) Day of Year Day of year (1-366). SMALLINT to_char(loaddate,'ddd') Day of Week Day of week (1-7). SMALLINT to_char(loaddate,'d') ISO Year and Week Presentation View Description Oracle Type Oracle function used when populating column Year (ISO) 4-digit year based on ISO SMALLINT to_char(loaddate, 'IYYY') standard. Week (ISO) Week of year (1-52 or 1-53) based on ISO standard. SMALLINT to_char(loaddate, 'IW') Year-Week-Day (ISO) Year, week, and Day based on ISO standard for example, 2012-W13-2. VARCHAR(10) to_char(loaddate, 'IYYY-"W"IW-') to_char(floor(loaddate - trunc(loaddate, 'IW')) + 1) Keys Presentation View TIMESTAMP_KEY_5 TIMESTAMP_KEY_10 TIMESTAMP_KEY_15 TIMESTAMP_KEY_30 HOUR_KEY DAY_KEY WEEK_KEY WEEK_KEY_ISO MONTH_KEY QUARTER_KEY YEAR_KEY YEAR_KEY_ISO DATE_KEY_5 DATE_KEY_10 DATE_KEY_15 DATE_KEY_30 DATE_KEY_HOUR DATE_KEY_DAY DATE_KEY_WEEK Oracle Type TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP TIMESTAMP DATE DATE DATE DATE DATE DATE DATE 6 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

13 DATE_KEY_WEEK_ISO DATE_KEY_MONTH DATE_KEY_QUARTER DATE_KEY_YEAR DATE_KEY_YEAR_ISO TIME_RANGE_END CANDLETIMESTAMP END_CANDLETIMESTAMP DATE DATE DATE DATE DATE DATE CHAR(16) CHAR(16) Reports containing both wireless and wireline data You have the option to install the Common Pack Service so that you can include data from both the wireless and wireline databases in reports. While you can include both wireless and wireline data in the same report, there is currently no relationship between the data. Getting started with wireline reports This information can help you get started with Common Reporting on wireline networks with Tivoli Netcool Performance Manager. Limitation on selecting resources in wireline reports A limitation in Tivoli Common Reporting affects the number of resources that you can select in wireline reports. You must not directly select more than 180 resources when authoring reports from Tivoli Netcool Performance Manager models in Report Studio or Query Studio. Directly selecting more than 180 resources can push the number of characters in your query over a known limit, and cause the report to fail with an error. However, this limitation does not apply when selecting the resources in a group. To select large numbers of resources, use the select all option on the report prompt page to select all the resources in a group. Then use filtering to select the resources you want. Alternatively, you can design reports to limit your selection to less than 180 resources. Optimizing the common pack attribute data source to improve report performance For improved performance, it is recommended that you review the common pack attribute data source ibm.tivoli.tnpm.packname.resourcetype.attribute attribute to see if all the properties are required. If some properties are not needed, you can remove them from the data source file. Removing data sources improves the overall query time for all data sources that require properties. Removing data sources also reduces the amount of temporary space that Tivoli Common Reporting requires to merge the data. Getting started with Common Reporting 7

14 Wireline data sources Wireline reports use two types of data source, a raw data source or a summary data source. Raw data source Raw data is collected on the collection-time interval as configured in the wireline component. v Snapshot of the value of a metric for a particular timestamp based on collection interval (example 15 minutes). v Used to display the detail raw value of a metric for a particular resource based on the collection interval. v Timestamp return will be adjusted based on selected time zone in the prompt page. Summary data source The summary data source collects 24-hour-data pre-aggregated by Proviso based on the timezone configured on Proviso. There are 5 types of aggregation available in the summary-datasource, that is:- sum, count, max, min and average. v Raw Data is pre-aggregated into daily (24 hours) based on the time zone configured in the wireline component v Metric value is aggregated into 5 values, MIN, MAX, AVERAGE, COUNT and SUM. v Data are always aggregated based on timezone configured in the wireline component and are not affected by the time zone selected in the prompt page. Wireline Report Templates You can use the provided templates to quickly get started with creating reports, without having to build the prompt pages from scratch. TNPM Wireline Raw Report Template These report templates replace an older template called TNPM Wireline Report Template, so if you have this older version on your system, do not use it. The default prompt page in this template allows you to select a date and time when generating a report, making it suitable for use with the raw data source. This template is not suitable for the summary data source because summary data source is pre-aggregated into 24 hours so the time do not have any impact to the report and it create confusion. TNPM Wireline Summary Report Template The default prompt page in this template allows you to select a date, but not a time, when generating a report and is suitable for the following types of report: v v v Raw data source reports that do not need a time selection. For example, the "Device Health Summary Report" report in ALU 5529 SDC to show raw metrics for a full day in 24 hours. Summary data source reports, as the summary data source does not support time selection. Reports with a mixture of raw data source and summary data source. In this scenario, ensure that no time is selected so data is always in 24 hours blocks, 8 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

15 which is how summary data sources are aggregated. This avoids the issue where the raw data source and summary data source results do not match. For example, the "All KPI Report" mixes both raw and summary data sources. The default prompt page The default prompt page in this template allows you to select a date, but not a time, when generating a report and is suitable for the following types of report: v v v Raw data source reports that do not need a time selection. For example, the "Device Health Summary Report" report in ALU 5529 SDC to show raw metrics for a full day in 24 hours. Summary data source reports, as the summary data source does not support time selection. Reports with a mixture of raw data source and summary data source. In this scenario, ensure that no time is selected so data is always in 24 hours blocks, which is how summary data sources are aggregated. This avoids the issue where the raw data source and summary data source results do not match. For example, the "All KPI Report" mixes both raw and summary data sources. Using the wireline report template The following procedure explains how to use the TNPM Wireline Report Template to create a report. In the example procedure, we use the Alcatel 5529 SDC common pack to illustrate the steps. You can modify the charts or tables you need, and delete the rest. About this task This task assumes that the Alcatel 5529 SDC common pack package has been published, and that the TNPM Wireline Raw Report Template is available in Common Reporting. Procedure 1. In the Tivoli Integrated Portal, select Reporting > Common Reporting. 2. On the toolbar, click Launch and select Report Studio. 3. On the Select a package window, under Public Folders, select the ibm.tnpm.wireline.common package. Report Studio opens. 4. On the Welcome window, select Open an existing report or template. 5. On the Open page, select the TNPM Wireline Raw Report Template and click Open. 6. For this example, we use the Alcatel 5529 SDC package. Select File > Report Package. 7. On the Report Package window, Select the ibm.tnpm.alcatel.5529.sdc package and click OK. A prompt window opens. When you open a wireline data model, you are prompted for the values normally provided in the default report prompt screens. 8. On the prompt window, click Cancel and on the next window, click OK. All Alcatel 5529 SDC objects are now available in the Insertable Objects pane. 9. Save the report as Wireline_Test_Report in My Folders. The report template contains a Chart Type section containing charts like the following charts. Getting started with Common Reporting 9

16 The template contains a Table section containing lists (tables) like the following lists. 10 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

17 The Insertable Objects pane contains the available Alcatel 5529 SDC Key Performance Indicators (KPIs). Expand TNPM alcatel_5529_sdc (Presentation) to show the KPIs. There are 10 different groups of metrics, divided into raw and summary metrics. Because of the frequency of data collection, raw metrics are suitable for both charts and tables, while summary metrics are best suited for tables. 10. Start by modifying the time series chart. To create a time series report, select one or more raw metrics and drag them to the Series drop box, and select a Getting started with Common Reporting 11

18 time object and drag it to the x-axis drop box. You can also drag an object to populate the y-axis or populate the other annotation fields, such as the x- and y-axis titles. 11. The Tivoli Netcool Performance Manager collection interval can be up to 1 minute, so reduce the time granularity for plotting the chart from HH:MM:SS to HH:MM. This results in better plotting of results in the chart and avoids overlapping data points caused by the longer collection frequency. a. Double-click the time object. The Data Item Expresssion - time window opens. b. In the Expression Definition pane, replace the existing definition with the following definition. substring(cast([tnpm alcatel_5529_sdc (Presentation)]. [ibm.tnpm.alcatel_5529_sdc.card.raw].[time],varchar(30)),1,16) + IF(extract(hour,[TNPM alcatel_5529_sdc (Presentation)]. [ibm.tnpm.alcatel_5529_sdc.card.raw].[time]) < 12) THEN ('AM')else('PM') Note: There are separate time objects for both Interface and Device, ensure that they are correctly mapped. For example, ibm.tnpm.alcatel_5529_sdc.card.raw and ibm.tnpm.alcatel_5529_sdc.ethernet LAG.Raw. 12. You must add a repeater to the chart so that the chart query runs for each resource that you select. a. Drag a repeater object to the chart box. b. Modify the repeater properties. c. Link the repeater to the appropriate query. In this example, we are setting ChartQuery1 to repeat for the resource name. 13. The Table section contains list items that you can update. From the Insertable Objects pane, drag insertable objects into the list. For example, to create a Card Summary report: a. Expand TNPM alcatel_5529_sdc (Presentation) > ibm.tnpm.alcaltel_5529_sdc.card.summary to show the KPIs. 12 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

19 b. Drag resourcename into the first column. c. Drag CPU Utilization (max) into the next column. d. Drag Memory Utilization (max) into the next column 14. Return to Common Reporting and click the My Folders tab. 15. Find Wireline_Test_Report in the list of reports and click the Run button to run the report. 16. The template contains a prompt page, that prompts for the time range, the report group, and the resources when running the report. Complete each step in the prompt page, and run the report. There is a limitation on the number of resources that you can include in a report. Ensure that you do not select more than 180 resources. Design considerations for wireline report authors For best results when authoring reports for Common Reporting, keep in mind the following design considerations and limitations. Be aware of the following behavior: v The data source test in Tivoli Common Reporting always fails for attribute data sources, but that does not mean that there is a problem with the data source. The test fails because there is no value for the??group?? parameter. The Cognos Servlet indicates that an invalid group name was provided. The??group?? parameter value is normally provided at a prompt page when running the report so is not present when running the data source test function. v The TCR Time dimension in wireline common packs supports only a data granularity of 15 minutes. Therefore, although they are in the data model, do not use the TCR Time insertable objects for 10 minute and 5 minute granularity. v If you include images in your reports, test them thoroughly with the Excel output. Time zone limitation for pre-1.3d common packs This limitation occurs if you develop reports using the report templates, with the new prompt page, delivered in wireline common BCP for common packs developed prior to 1.3D. Regardless of what time zone is selected in the new default prompt page, it does not affect the report result. The report still works in GMT, not the time zone selected in the prompt page. Modifying timestamps in custom charts to round up to minutes instead of milliseconds By default, timestamps in reports created by using the wireline data models are rounded up to milliseconds. This task explains how to change the report to round the timestamps up to minutes instead. About this task This procedure assumes that time data item found on the Source is inserted into the chart or table in Report Studio as shown. Repeat these steps as required while creating custom charts or tables. Procedure 1. Double-click on a time data item. The Data Item Expression window opens. 2. In the Expression Definition window, enter the following expression: Getting started with Common Reporting 13

20 substring(cast( data_item_path,varchar(30)),1,16) where data_item_path is the path of the selected data item. This expression removes seconds and milliseconds, resulting in the display of year-month-day hour:minute only. 3. Save the expression by clicking OK. Limitations on selecting time ranges for summary data There are two limitations on how you can select time ranges for summary data. You must use the default start time for summary data Wireline reports containing summary data must use the default start time in the prompt page or no summary data is displayed in the report. To display reports containing summary data for the same start and end date, you must use the default start time of 12:00 AM in the prompt page. If you modify the start time to a value other than 12:00 AM, then no summary data is returned. For example, the following filtering condition on a table or graph containing summary data returns no data. Start date= April 28 Start time > 1:00AM End date=april 28 End time = > any You must select time ranges in multiples of one day Symptoms Summary data is aggregated for one day (24 hours) even if the selected time range is less than one day. Summary data for periods of more than one day, but not a multiple of 24, is aggregated up to the next 24-hour period. Causes Summary data cannot show data aggregated for a partial day. Example: Less than 24 hours For example, if you select a time range of 10 hours as follows: Start Time: 1:00 AM End Time: 11:00 AM Raw data is returned for the specified time range of 10 hours. Summary data should be also aggregated for this 10-hour period. However, the summary data is aggregated for one day (24 hours). Example: More than 24 hours For example, if you select a time period of 32 hours, the data is aggregated for 48 hours (2 x 24 hours). Conforming to Cognos reporting guidelines To conform to the Cognos reporting guidelines, leave table cells with no data blank rather than using a dash (-) to indicate no data. In wireline reports for previous wireline versions, dashes were used (-) in table cells where there is no data. 14 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

21 Microsoft Excel formatting limitations When authoring reports, be aware that wireline users can still experience some formatting problems with charts that have a decimal number on the y-axis. These issues are due to formatting limitations in Microsoft Excel If this problem occurs, use Report Studio to modify the chart and change the data format property of the y-axis to the Number with 2 decimal places option. Also, be aware that for best results when exporting reports to Excel, users are directed to always select Microsoft Excel Due to formatting limitations in older versions of Excel, exporting in versions such as 2000 or 2002 can produce incompatible charts. Always ensure that you test your reports in Microsoft Excel If you include icons in your reports, test them thoroughly with the Excel export option. Report titles and labels are displayed in ASCII format Certain technology packs do not automatically convert the resourcealias attribute from ASCII format to text. If you are working with reports on one of these packs, titles and labels are displayed as a long ASCII string. If you are creating Common Reporting reports for one of these technology packs, open Report Studio and modify the affected titles or labels to use resourcename instead of resourcealias. Getting started with wireless reports This information can help you get started with Common Reporting on wireless networks with Tivoli Netcool Performance Manager. Authoring a simple report You can follow these basic steps to create a simple report. This example uses the package created when the Huawei GSM BSS common pack is published. Procedure 1. In Common Reporting, select a package. In this example, select the Huawei GSM BSS package. 2. On the toolbar, click Launch and select Report Studio. Report Studio opens. 3. On the Welcome window, select Create a new report or template. 4. On the New window, select List, and click OK. An empty report opens containing a list (a single row table). 5. Select a Time attribute from the Insertable Objects window and drag it into the list. For best results, use the keys where possible. In this example, drag the TCR Time (Presentation) > Time > Keys > DATE_KEY_HOUR key into the list. 6. Select a primary key or an entity ID and drag it into the list right beside the DATE_KEY_HOUR key. Ensure that your selection is in the list, if a singleton is created, click Undo and try again. In this example, drag TNPM Mobile GSM (Presentation) -> TNPM GSMCell -> CELL_ID into the list. 7. Select metrics and drag them into the list next to the CELL_ID column. In this example, drag TNPM Huawei GSM BSS V900 Measurements (Presentation) -> TNPM Huawei GSM BSS V900 Measurements Cell Measurements -> Getting started with Common Reporting 15

22 Cell.AMR_calls -> Cell.Huawei.GSM.AMR_calls -> CALL_DROP_AMRFR_CAll_FAIL_TIMES. 8. Create a prompt page by highlighting CELL_ID and DATE_KEY_HOUR, and clicking the Build prompt page button on the toolbar. The prompt page is automatically generated. 9. Save the report as Simple_Report in My Folders. 10. Return to Common Reporting and click the My Folders tab. 11. Find Simple_Report in the list of reports and click the Run button to run the report. Authoring an efficient report The Tivoli Netcool Performance Manager database relies heavily on an Oracle feature called Partition Pruning to efficiently process data. Reports must be defined in a certain way to ensure that Oracle has enough information to identify data partitions. About this task You can build a prompt page to ensure that Oracle has the required information to identify data partitions. These steps assume that you have created a list report with 15-minute data by dragging the appropriate report items into the report. Procedure 1. As this data is 15-minute data, drag the DATE_KEY_15 key into the report. You remove this key later as it is used only as a quick method to build a prompt. 2. Select the DATE_KEY_15 column and click the Build Prompt page button on the toolbar. A prompt is created for the report. 16 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

23 3. Return to the report definition page and remove the DATE_KEY_15 column by right-clicking and selecting cut. You must remove the key or the report displays only the raw data with the drill up. 4. Save and run the report. Getting started with Common Reporting 17

24 Authoring a drill-down report In this example, we edit the Simple_Report report to allow drill up and drill down levels for both time and resource (entity) in the report. Procedure 1. In Common Reporting, select the package used to create the simple report. In this example, select the Huawei GSM BSS package. 2. On the toolbar, click Launch and select Report Studio. Report Studio opens. 3. Select Open an existing report or template, select Simple_Report and Open. 4. Save the report as Drill_Down_Report. 5. Edit the report to use Cell Hierarchy and Time (Dimensional) by completing the following steps: a. Delete the CELL_ID and the DATE_KEY_HOUR columns. b. In the vertical toolbar beside the Insertable Objects window, point to the Query Explorer button to see Query Explorer and select Query1. c. Delete both filters. to remove the current prompt pages. With the removal of CELL_ID, and DATE_KEY_HOUR, these filters are no longer useful in the context of this report. d. Point to Page Explorer button to see the Page Explorer, right-click on Prompt Page1 and select Delete to delete the prompt page. e. In Page Explorer, click Page1 to return to the list. f. Drag the following elements into the list. You can navigate further into the file structure as required. v TCR Time (Presentation) > Time (Dimensional) > Year > Day v CDM Mobile GSM (Presentation) > CDM GSM > Cell Hierarchy > Network to Cell > Cell 6. From the main menu, select Data > Drill Behaviour. 7. On the Basic tab of the Drill Behaviour window, select the Allow drill-up and drill down option and click OK. You can now drill on entity and time when you run this report. If you want, you can also add a filter to restrict the time scope on which the report is displayed, the prompt page is not as useful in this scenario as it would restrict the drilling process. 8. Add a filter to limit the time scope of the report by completing the following steps: a. In the vertical toolbar beside the Insertable Objects window, point to the Query Explorer button to see Query Explorer and select Query1. b. In the Insertable Objects window, select the Toolbox tab. c. Drag a filter into the Detailed Filters pane from the Insertable Objects pane. In this example, the filter is set to report on the previous 7 days. In the dialog box for the calculation, insert the following calculation: [TCR Time (Presentation)].[Time].[DATE_KEY_DAY] > _add_days(current_date, -8) AND [TCR Time (Presentation)].[Time].[DATE_KEY_DAY] <= _add_days(current_date, -1) d. For this filter to work, the DATE_KEY_DAY key must be in the report. Drag DATE_KEY_DAY into the list. 18 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

25 e. The DATE_KEY_DAY key does not need to be displayed so you can hide it. Select the title of the column, and in the Properties window, set Box Type to none, Select the column body and in the Properties window, set Box Type to none. 9. Save the Drill_Down_Report report. 10. Return to Common Reporting and click the My Folders tab. 11. Find Drill_Down_Report in the list of reports and click the Run button to run the report. 12. When the report viewer has appeared, the entries under Cell and Day should be highlighted, you can click these entries to perform a drill down or you can right-click and select drill up to perform a drill up. Authoring a charting report Charts are a graphical representation of tabular data. They can be used to quickly identify large numeric data for different areas of business. They are commonly used in dashboard style reports. Procedure 1. In Common Reporting, select a package. 2. On the toolbar, click Launch and select Report Studio. Report Studio opens. 3. On the Welcome window, select Create a new report or template. 4. On the New window, select Chart, and click OK. The Insert Chart window is displayed. 5. In the Chart group list, select a group. For this example, select Column. 6. In the Chart Type pane, select a chart type. For this example, select Column with 3-D Visual Effect. 7. Click OK. A blank chart displays in the work area. 8. A column chart has three drop zones; Default measure (y-axis), Series, and Categories (x-axis). 9. From the Source tab in the Insertable Objects pane, drag a data item to the Series drop zone. In this example, we drag the Raw KPI to the Series drop zone. Getting started with Common Reporting 19

26 10. From the Source tab in the Insertable Objects pane, drag a TCR data item to the Categories drop zone. In this example, we also include the CELL_ID measure from the Orders query subject in the Default measure drop zone. 11. From the Standard toolbar, click Run Report. The results are displayed. 20 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

27 Drill-through reports Creating drill-through access within a report makes it easier for you to navigate through large reports or to link separate reports containing related information. When you create drill-through access, you can create a bookmark that lets you navigate through a particular dimension of a report or pass a parameter from a source report to a target report. When the drill-through data item value in the source report is selected, the target report opens. The target report is filtered on the parameter that was passed from the source report. This filtering allows you to link separate reports with related information. For the following example, we set up drill-through access using two separate reports: a target report, and a source report. Authoring a drill-through target report A target report opens after you click a data item value in a source report. Typically, this report contains related or more detailed information about the source report. Setting up drill-through access gives the user quick access to detailed information without having to navigate through folders to run another report. About this task The MTP3_DSP_ID resource is set up as the drill-through text in the target report. When you click the MTP3_DSP_ID drill-through text, the target report opens, displaying raw data for KPIs for the MTP3_DSP_ID that was selected in the source report. The Date_Key_Hour key is added to the report and hidden; it is used in the drill through, but not required in the report. Procedure 1. Create or open a list report to use as the target report. 2. Add MTP3_DSP_ID, Date_Key_Hour, Date_Key_Hour and raw KPIs columns. 3. Hide the Date_Key_Hour key in the report: a. Click the list column body for the Date_Key_Hour data item and, in the Properties panel, set Box Type = None. b. Click the list column title for the Date_Key_Hour data item and, in the Properties panel, set Box Type = None. 4. Save the target report. For this example, save the target report as Test Target report. What to do next Create a source report that contains raw data for all resources. Authoring a drill-through source report A source report contains the data item value that you can click to drill-through to the target report to view more detailed information. About this task To set up the source report to contain the drill-through definition, you need to know the name and location of the target report and the parameter used in the filter of the target report. Getting started with Common Reporting 21

28 Procedure 1. Create or open a list report to use as the target report. 2. Add MTP3_DSP_ID, Date_Key_Hour, and raw KPIs columns. 3. In the work area, select the item to be used as the drill-through. For this example, select MTP3_DSP_ID as the drill-through. Note: To activate the Drill-Through Definitions option, you must first make a selection in the work area. 4. Click Launch on the toolbar and select Drill-Through Definitions. The Drill-Through Definitions window is displayed. 5. Click the New Drill-Through Definition button. A new Drill-Through definition is created. 22 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

29 6. Under Report, choose the target report. 7. Select the target report and click the Open button. For this example, select Test Target report. 8. From the Action list, select how the target report renders during drill-through. v Run The Report, runs the report and displays the most recent data. v View Most Recent Report, displays the most recent saved output version of the report. v Default, uses the report action defined in Cognos Connection. 9. From the Format list, select the output format for the report when it runs. You can choose HTML, PDF, Excel 2007, Excel 2002, Excel 2000 Single Sheet, Delimited Text (CSV), XML, and Default, which uses the output format defined in Cognos Connection. 10. Optionally, select the Open In New Window check box to open the target report in a new window when it is accessed from the source report. If you do not select this check box, the target report replaces the source report in the Cognos Viewer. 11. Click Edit to display details the parameters from the target report. The Parameters window is displayed. 12. From the Method list, select the method for passing the parameter. You can choose from Do Not Use Parameter, which does not pass the parameter; Pass Data Item Value, which passes a value from a data item within the source report; Pass Parameter Value, which passes a parameter value from the source report; or Default, which does not pass the parameter. For this example, select Pass Data Item Value. 13. From the Value list, select the Data Item value from the source report. In this example, we use Date_Key_Day and MTP3_DSP_ID. Getting started with Common Reporting 23

30 14. Click OK. The parameters to pass to the drill-through definition display in the Parameters pane on the Drill-Through Definitions window. 15. From the Display Prompt Pages list, select an option for when to display the prompt pages. The available options are Always, Based On The Default Prompt Settings Of The Target Report, and Only When Required Parameter Values Are Missing. For this example, select Only When Required Parameter Values Are Missing. 16. Click OK. Report Studio updates the report. The data item being used as a drill-through object becomes a hyperlink, and the drill-through icon is displayed. 17. Run the report to test the drill-through. The source report opens in Cognos Viewer and the data items containing the drill-through definition display as hyperlinks that allow you to drill-through to the target report. 18. From the column containing the drill-through definition links, click a hyperlink. The drill-through target report displays with detailed information about the selected item. In this example, the target report opens and displays detailed information about the raw KPIs for the selected resource and date range. 24 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

31 Including multiple granularity items in the same report You can include items of multiple granularity in the same report. Use this set of examples and information to help you with this feature. Displaying multiple granularity items with drill-down only This example task assumes that you want to display data of multiple granularities in the same report. You can drill up and drill down by time or by resource, in this example, the drill-down is by time. The lowest level of granularity is 5 minutes, the 5-minute timestamp value is displayed in the report. The other data is drilled down to this level. About this task Granularity KPI 5 min BSCLOOP_FAIL_APPLY_TRSL_FAIL 10 min IMM_ASS_CH_ALLOC_REQ_SD 15 min PREFER_TCHH_IP_HDLC_TRANS 30 min IMM_ASS_CH_ALLOC_FAIL_SD 60 min TCH_CALL_DROP_TA The report definition is as follows: To report correctly, additional information needs to be added to the report: Procedure 1. From the Keys folder under the Times object, drop and drag the DATE keys of all the traffic data of a higher granularity. (As we are reporting at 5 minutes, we drop in the keys for 10, 15, 20, 30, and Hour) 2. Hide those keys in the report: a. Keeping the Ctrl key pressed, click the column headers and column of each of these keys. b. In the Properties pane, set Box Type property to None. Note: To view these objects again, view the report definition in Page Structure mode: View > Page Structure. Getting started with Common Reporting 25

32 3. Run the report. Results The 5-minute data is displayed. The other timestamps are drilled down. Due to the way Common Reporting displays reports, metrics that have a greater time granularity than the level at which the report is based can show duplicate results. You can avoid these duplicates by using the method detailed in the UDC calculations and drill downs on page 27 topic. The UDC is as follows: if (DATE_KEY_15 = DATE_KEY_HOUR) then ([TCH_CALL_DROP_TA]) else null Displaying multiple granularity items with drill up and drill down This example task assumes that you want to display data of multiple granularities in the same report. You can drill up and drill down by time or by resource. Here we are going to create a report with some counters drilled up and some drilled down by time. About this task Taking the example data in the table, we create a report that reports data at 30-minute intervals. Hence we expect the 5, 10 and 15 minute data to drill up and the hourly data to drill down. Granularity KPI 5 min BSCLOOP_FAIL_APPLY_TRSL_FAIL 10 min IMM_ASS_CH_ALLOC_REQ_SD 15 min PREFER_TCHH_IP_HDLC_TRANS 30 min IMM_ASS_CH_ALLOC_FAIL_SD 60 min TCH_CALL_DROP_TA Procedure 1. Drag all the KPIs, CELLID, and 30 minute object into the table. For each object that we want to drill down on, we must include the key for that granularity. Therefore, in this example, we drag in the DATE_KEY_HOUR key. 26 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide

33 2. Hide those keys in the report: a. Keeping the Ctrl key pressed, click the column headers and column of each of the keys. b. In the Properties menu, set Box Type to None. Note: To view these object again, view the report definition in Page Structure mode: View > Page Structure. 3. Run the report. UDC calculations and drill downs This example partially replicates the functionality of Tivoli Netcool Performance Manager - Wireless Component. In a drill-down scenario, we create a User Defined Calculation (UDC) that is calculated at run time as the sum of two other calculations. However, one raw counter has a 5-minute granularity and the other has an hourly granularity. The expected result is that we add the counters together only when the timestamps match, that is, on the hour. The report result is as follows; we add the hourly column only when the timestamps are equal. Getting started with Common Reporting 27

34 This result is achieved as follows, the method used here avoids problems with data corruption. Add the following columns to the report: [TNPM Huawei BSS Measurements (Consolidation)].[Cell.Huawei.Generic.Local_switch_call_drops]. [BSCLOOP_FAIL_APPLY_TRSL_FAIL] [TNPM Huawei BSS Measurements (Consolidation)].[Cell.Huawei.Generic.TCH_call_fail_per_cell]. [TCH_CALL_DROP_TA] When creating the UDC, use the column values rather than the database values. That is, when creating the expression in the Data Item Expression window, choose the metrics from the Data Items tab, rather than the Source tab. This method performs the calculation on the visible results in the existing columns, rather than the values taken from the database. Edit the UDC formula to be something as follows: IF ( [TCR Time (Presentation)].[Time].[DATE_KEY_5] = [TCR Time (Presentation)].[Time].[DATE_KEY_HOUR] ) THEN ( [BSCLOOP_FAIL_APPLY_TRSL_FAIL] +[TCH_CALL_DROP_TA] ) ELSE ([BSCLOOP_FAIL_APPLY_TRSL_FAIL] ) Now that the UDC is complete the two metrics you added can be hidden by setting the Box Type property to none in the Properties pane. If the timestamps match we add the counters together, otherwise we display only the counter from the 5 minute data. 28 IBM Tivoli Netcool Performance Manager: Getting Started with Common Reporting Guide