This OBE introduces you to Information Publisher, a powerful reporting framework available with Enterprise Manager 10g Grid Control Release 2.
Approximately 45 minutes
This OBE covers the following topics:
| Overview | ||
| Viewing Out-of-Box Reports | ||
| Creating an Availability History and Open Alerts Report | ||
| Sharing and Scheduling Reports | ||
| Creating a Custom Host Comparison Report | ||
| Summary | ||
| Related information | ||
Place
the cursor over this icon to load and view all the screenshots for this tutorial.
(Caution: Because this action loads all screenshots simultaneously, response
time may be slow depending on your Internet connection.)
Note: Alternatively, you can place the cursor over each individual icon in the following steps to load and view only the screenshot associated with that step.
The screenshots will not reflect the specific environment you are using. They are provided to give you an idea of where to locate specific functionality in the Oracle Enterprise Manager 10g Grid Control console.
Enterprise Manager 10g Grid Control Release 2 includes Information Publisher, which is Enterprise Managers powerful reporting framework. It makes information about your managed environment available to audiences across your enterprise. Administrators can use reports to show activity, resource utilization, and configuration of managed targets. IT managers can use reports to show availability of sets of managed systems. Business executives can view reports on availability of applications (such as corporate e-mail or other critical business applications) over a period of time. This OBE guides you through viewing out-of-box reports, creating custom reports, and sharing reports with your user community.
Information Publisher includes a large number of out-of-the-box reports, providing summary monitoring, configuration, security, and service level information. Out-of-the box reports provide you with a comprehensive library of ready-to-use report definitions that allow you to generate fully-formed reports immediately without setup or configuration. Perform the following steps to interactively view out-of-box reports:
|
1. |
Open the browser and enter the following URL: http://<management service hostname>.<domain>:<port>/em/ The default port value on a clean machine is 7777. However, if there are other instances running on the machine, then the port may be different. The login page will be displayed. Enter the User Name and Password, and then click the Login button.
|
|
2. |
Click the Reports tab.
|
| 3. |
On the Reports Definition page, click the Availability History (Target) report link under the Monitoring category and Availability History subcategory.
|
| 4. |
Click the flashlight icon to select a target.
|
| 5. |
You are prompted for a target. Select your Windows host and click the Select button.
Note: This reports should be used for non-composite targets. If you want to see availability for a Group or a System, view the Availability History (Group) report. To see the availability history for a Redundancy Group, view the Availability History (Redundancy Group) report.
|
| 6. |
Click the Continue button.
|
| 7. | By default, this report shows availability
data for the last 24 hours. Click the Set Time Period button to change
the time-period.
|
| 8. |
Change the time period to Last 7 days and click the Continue
button.
|
| 9. |
The data in the report will change accordingly (i.e. displaying information for the Last 7 days). Click the Reports tab to return to the Reports Definition page.
|
| 10. |
Now, lets view additional out-of-box reports in the Reports Definition page. Click the Database Instance Overview report link, under Deployment and Configuration category, and Oracle Database Configuration sub-category.
|
| 11. |
Click the flashlight icon to select a database instance to include in this report.
|
| 12. |
Note that this report provides information about an Oracle Database. Therefore, the user is only allowed to input an Oracle Database as a parameter for this report. Select the database instance assigned to you and click the Select button.
|
| 13. |
Click the Continue button
|
| 14. |
View the Database Instance Overview report.
|
Suppose you are managing a database and you would like to have a report that displays availability history and open alerts for that database and to share this report with your manager. While looking at the out-of-box reports, you notice that Availability History (Target) report closely matches your needs. You realize that you can do a Create Like, use the information already displayed in the report, and add open alerts information to achieve the task at hand. Perform the following steps to customize the Availability History (Target) report to display information about the database you are managing and to include open alerts:
| 1. |
On the Reports Definition page, select the Availability History (Target) report under the Monitoring category and Availability History subcategory. Click the Create Like button.
|
| 2. |
Specify a title for your report, such as "Availability History and Outstanding Alert for my DB"
|
| 3. |
You can use one of the existing categories or you can also create your own. Click the Add Category button to create a new category.
|
| 4. |
You can specify any name for the category, for example My Reports. Click the Continue button.
|
| 5. |
You can use one of the existing subcategories or you can also create your own. Click the Add Subcategory button to create a new subcategory.
|
| 6. |
Enter the name for the subcategory, for example Database Reports and click the Continue button.
|
| 7. |
Since you are defining this report for a specific database, select the Use the specified target option button in the Targets section, and click the flashlight icon to select the database you would like to use.
|
| 8. |
Choose Database Instance from the Target Type drop-down list. Select a database instance and click the Select button.
|
| 9. |
In the privileges section, select Run this report with privileges of report owner checkbox. This way you can schedule your report, as well as share it with users who do not have view privileges on your database.
|
| 10. |
Click the Elements property page.
|
| 11. |
Click the Add button to add the open alerts element.
|
| 12. |
Select the Open Alerts element and click the Continue button.
|
| 13. |
Click the Set Parameters icon for the Open Alerts element.
|
| 14. |
Specify the header for the element, for example Open Alerts.
Since you are writing the report for a specific target, select the Inherit
Target option. Select severities of alerts that you would like to
include in the report. For example, select Critical and Warning. Keep
the default 10 rows per page setting. Click the Continue button.
|
| 15. |
Click the Preview button to review the changes you made to the report.
|
| 16. |
Notice, that you are no longer prompted for a target, since you specified
the target to use for this report. The report shows the data we wanted,
however we can improve on its layout by moving the Open Alerts element
to the right of the Availability History Details table. Scroll down the
page, and click the Return to Create Report Definition link.
|
| 17. |
Click the Layout button.
|
| 18. |
Select the Open Alerts element, and click the Move Up button to move it to the 3rd row.
|
| 19. |
Notice that the Open Alerts element has now moved to the 3rd row. Click the Continue button.
|
| 20. |
Click the Preview button again to validate that the report layout has been changed.
|
| 21. |
Notice the change in the report layout. Scroll down the page, and click the Return to Create Report Definition link.
|
| 22. |
Click the OK button to save the report.
|
In this exercise, you will schedule the Availability History and Open Alerts Report, share this report with another Enterprise Manager user, and publish this report to the Enterprise Manager Reports Website.
| 1. |
On the Report Definitions page, scroll down and select the report you just created and click the Edit button. The report is listed under the category and subcategory that you specified.
|
| 2. |
Click the Schedule property page.
|
| 3. |
Check the Schedule Report checkbox.
|
| 4. |
You can schedule the report to run one time immediately, one time later or on a repeating schedule. For the purposes of this exercise, you will generate one copy of the report immediately, save a copy of the report, and email the report to yourself. In order to achieve this:
|
| 5. |
Click the Access property page.
|
| 6. |
Now, you would like to share the report with the "Reporting" user and publish this report to the Enterprise Manager reports Website. Click the Add button.
|
| 7. |
Select Reporting administrator as one of the users who can access your report and click the Select button.
|
| 8. |
Check Allow viewing without logging into Enterprise Manager checkbox. Checking this option allows you to share your reports with non-Enterprise Manager administrators. Click the OK button to save your report.
|
| 9. |
Notice the confirmation message - Successfully Modified Report: "Availability History and Outstanding Alert for my DB". It might take up to a couple of minutes for your report to get generated. Once a copy has been generated, a timestamp will appear in the Date Generated column for your report. Periodically click the Refresh icon at the top of Report Definitions page to check if a copy has been generated.
|
| 10. | Once the timestamp appears, click on the
report. By clicking on a report with previous copies, you will see
the last generated copy. You can follow a Saved Copies link at the
top of the report, to view all previous copies. Also, verify that you received
the report in your email.
|
| 11. |
Logout of the Grid Control Console.
|
| 12. |
Navigate to http://<management service hostname>.<domain>/em/public/reports and verify that the report has been published to the reports Website.
|
| 13. |
Now verify that the reporting user has access to this report. Login
as: Username: reporting and Password: reporting.
|
| 14. |
Navigate to the Reports tab and you will notice that reporting user has access to your report. Click on the report, and you can view the same report.
|
Suppose you are managing a number of hosts, and you would like to be able to interactively compare performance of one of your hosts against a baseline host. Using Information Publisher, you can create a custom report that will provide this information.
In this exercise you will create a comparison report between a user-supplied host and a baseline host. This report will allow you to compare CPU Utilization, Filesystem Space Available, and Alert History between the two hosts over a user-customizable period of time. You will include charts to display CPU Utilization and Filesystem Space Available, and tables to display alert history.
To create a custom host comparison report, perform the following steps:
|
1. |
Log out from Enterprise Manager and login again with your assigned username and password.
|
|
2. |
Click the Reports tab.
|
| 3. |
On the Report Definitions page, click the Create button to launch the report creation wizard.
|
| 4. |
Here you can specify any name for the report and use any existing categories and subcategories. For this exercise, specify the name as Host Report, category as My Reports, and subcategory as Host Report.
|
| 5. |
Since this report will require a user input, use the default A target
will be selected by the report viewer when viewing the report option.
Additionally, select Host in the Target Type drop-down. This will
restrict user input to hosts.
|
| 6. |
In the Time Period section, allow the report viewer to customize the time period.
|
| 7. |
Now you need to add content to the report by adding reporting elements.
For creating this report, you will use "Metric Details" and
"Table from SQL" reporting elements. "Metric Details"
element allows you to graph a metric over a period of time, and "Table
from SQL" element allows you to write custom queries against the
Management Views to the Grid Control Repository. Click the Elements
property page.
|
| 8. | Now, let's include a metric details element
to show CPU Utilization information about the user-supplied host. Click
the Add button to add the Metric Details element.
|
| 9. |
Select the Metric Details element and click the Continue button.
|
| 10. |
Click the Set Parameters icon.
|
| 11. |
Specify a header for this element for example Selected Host CPU Utilization.
|
| 12. |
Select CPU Utilization (%): Load from the metric list, and click the Continue button.
|
| 13. |
Now, let's add an element that will show CPU Utilization for the baseline host. Click the Add button to add another Metric Details element.
|
| 14. |
Select the Metric Details element and click the Continue button.
|
| 15. |
Click the Set Parameters icon.
|
| 16. |
Specify the header, for example Baseline Host CPU Utilization.
Select the Inherit report time-period option button as this element
should show information over a user-specified time period
|
| 17. |
In the Targets section, select Use element-specific targets below option button, since this element will display information for the baseline host, you need to supply the baseline host. Click the Add button, and select the host assigned you to be used
as a baseline.
|
| 18. |
Select Host from the Target Type drop-down list. Select the host assigned to you and click the Select button.
|
| 19. |
Select CPU Utilization (%): Load in the metric list, and click
the Continue button.
|
| 20. |
Repeat the previous steps, by adding 2 Metric Details elements, one for the user-selected host, and one for the baseline host, showing Filesystem Space Available (%): Filesystems metric.
|
| 21. |
Now, you need to add the alert history information for the two hosts. You will accomplish this using the Table from SQL element. Click the Add button to add Table from SQL element.
|
| 22. |
Select Table from SQL and click the Continue button.
|
| 23. |
Click the Set Parameters icon.
|
| 24. |
Enter a header, for example Alert History for a User-supplied Host. Write a SQL statement to select all warning and critical alerts that were triggered for the user-supplied host during the specified time-period, providing information about: metric that triggered the alert, alert severity, and date the alert was triggered. Refer to the SQL Cheat Sheet Handout for documentation on mgmt$alert_history view, and a list of variables to use in your SQL. Answer: select column_label as "Metric", alert_state as "Severity", collection_timestamp as "Date Triggered" from mgmt$alert_history where target_guid=??EMIP_BIND_TARGET_GUID?? and collection_timestamp>=??EMIP_BIND_START_DATE?? and collection_timestamp<=??EMIP_BIND_END_DATE?? and alert_state in ('Critical','Warning') Click the Continue button.
|
| 25. |
Now, let's add another table that will include information about alert history for the baseline host. Click the Add button to add another Table from SQL element.
|
| 26. |
Select Table from SQL element and click the Continue button.
|
| 27. |
Click the Set Parameters icon.
|
| 28. |
Specify the header, for example Alert History for the baseline host. Write a SQL statement that will select all alerts triggered for the baseline host over the specified time-period. Answer: select column_label as "Metric", alert_state as "Severity", collection_timestamp as "Date Triggered" from mgmt$alert_history where target_name='stams03' and collection_timestamp>=??EMIP_BIND_START_DATE?? and collection_timestamp<=??EMIP_BIND_END_DATE?? and alert_state in ('Critical','Warning') Please substitute the target_name with the hostname assigned to you. Click the Continue button.
|
| 29. |
Click the Preview button.
|
| 30. |
Click the flashlight icon to select a host to include in the report.
|
| 31. |
Select the type as Host and select any host from the list. Click the Select button.
|
| 32. |
Click the Continue button.
|
| 33. |
Review the information presented in the report. While all of the information
is correct, you notice that all the elements are laid out in one column.
However, it would be better to compare data in two columns.
|
| 34. |
Click the Return to Create Report Definition link at the bottom left corner of the page.
|
| 35. |
Under the Elements subtab, click the Layout button.
|
| 36. |
Move the first two charts into the 1st row, next 2 charts into the 2nd row, and the alert tables into the 3rd row. Click the Continue button.
|
| 37. |
Click the Preview button to view the report.
|
| 38. |
Click the flashlight icon to select a host to include in the report.
|
| 39. |
Select the type as Host and select any host from the list. Click the Select button.
|
| 40. |
Click the Continue button.
|
| 41. |
Validate that the elements are shown side-by-side.
|
| 42. |
Click the Return to Create Report Definition link at the bottom left corner of the page.
|
| 43. |
Click the OK button to save the report.
|
In this lesson, you learned how to:
| View Out-of-Box Reports | ||
| Create an Availability History and Open Alerts Report | ||
| Share and Schedule Reports | ||
| Create a Custom Host Comparison Report | ||
| To ask a question about this OBE tutorial, post a query on the OBE Discussion Forum. |
Place the cursor over this icon
to hide all screenshots.