CentraSite 10.11 | CentraSite User’s Guide | Runtime Governance | Runtime Events and Key Performance Indicator (KPI) Metrics | Managing Runtime Events and Metrics through CentraSite Business UI | Displaying Event Information for Assets (APIs)
 
Displaying Event Information for Assets (APIs)
Pre-requisites:
The following general guidelines apply when displaying the events:
*Ensure that webMethods API Gateway is configured to collect and report runtime events.
You must configure API Gateway to communicate with CentraSite (in API Gateway, go to Administration > Destinations > CentraSite Configuration). For procedures, see webMethods API Gateway Administration.
*Ensure that CentraSite is configured to receive runtime events from API Gateway.
*Ensure that you have at least an instance-level View permission on the Runtime Events profile of the asset.
*Ensure that the type's definition (for example, Virtual Service) includes the Runtime Events profile to view runtime event information for its asset instance.
The Events profile displays the runtime events of an asset. You can filter the list by target, event type and time period.
The Events profile contains information about runtime events that have occurred in a target (that is, a policy-enforcement point (PEP) or a runtime monitoring component).
The target publishes to CentraSite the runtime events that have occurred (assuming that the target type contains a MIB file in its target type definition file).
CentraSite provides predefined event types for use with API Gateway, or any third-party policy-enforcement point (PEP), or runtime monitoring component such as Insight that is integrated with CentraSite.
*To display the runtime events of an asset (API)
1. In CentraSite Business UI, access the Advanced Search panel in one of the following ways:
*Click the Browse link that is located in the upper-left corner of the menu bar.
*Click the Search icon that is located next to the Scope list. The default search scope is Assets.
A list of defined assets in CentraSite is displayed in the Search Results page.
2. In the Additional Search Criteria list, select Asset Types.
3. To search for the assets of type, Virtual Service, click Choose.
4. In the Choose Asset Types dialog box, select the Assets option button, and follow these steps:
a. Click the chevron next to Assets option button.
b. In the list of asset types, select Virtual Service.
c. Click OK.
A list of defined Virtual Service assets is displayed in the Search Results page.
5. Click the Virtual Service whose runtime events you want to examine.
This opens the Virtual Service details page.
6. Select the Runtime Events profile.
7. Use the following fields to filter the event list you want to view:
In this field...
Specify...
Gateway
A gateway to which the asset is deployed or select All to view the event information of all gateways to which the API is deployed.
CentraSite displays None by default.
Consumer
A consumer of the asset or select All to view the run-time event information of all consumers of the asset.
CentraSite displays All by default. However, if you do not have at least one consumer registered in the registry, CentraSite displays None by default.
Event Type
A particular event type or select All to view all event types.
CentraSite displays All by default.
Date Range
A range of dates from which to view the events (for example, Last 1 hour, Last 12 hours, Last 1 day, Last 5 days, Last 10 days, Last 20 days, Last 1 month, Custom, and so on).
CentraSite displays Last 1 month by default.
Start Date/End Date
If chosen Custom in the previous field, then the time period for which to view the metrics.
Start Date: Click the calendar and select a starting date and time.
End Date: Click the calendar and select a ending date and time.
Display Interval
A running count events of the service displayed at regular time intervals.
The interval is specified in the format 3m 2d 6h; wherein m indicates the month, d indicates the day and h indicates the hour.
8. Click Refine.
9. Expand the Graphical node to display a graphical view of the run-time event information.
10. Expand the Tabular node.
CentraSite displays a tabular view of the event information in the left pane.
Field
Description
Date/Time
The date/time that the event occurred. Click this hyperlinked value to view the Event Detail page, which will contain the event's SOAP request or response name in the Attribute column. Click the hyperlinked request or response name to display the full SOAP request or response.
Event Type
(Read-only). The type of event (for example, Monitoring, Policy Violation, Error, and so on).
Gateway
(Read only). The gateway on which the event occurred.
11. To access the details of an event, click on the link for the event.
The Event Details dialog in the right pane shows a detailed information about the event that you select in the left pane.