Version 9.6
 —  Logging  —

Monitoring Logs

When you've configured CentraSite to log messages you can monitor its activities by viewing the log messages. By examining the log files you can monitor many aspects of CentraSite’s events.


Policy Log

Start of instruction setTo view the policy log

  1. In CentraSite Control, go to Administration > Logs > Policy Log.

  2. Complete the following fields to specify which type of log entries you want to view:

    In this field... Specify...
    Object Name

    Optional. A pattern string that describes the names of the objects (of Object Type) whose log entries you want to view.

    You can provide the exact name or use a pattern string consisting of a character sequence and/or the % wildcard character (which represents any string of characters). For example, if you specify the pattern string ‘A%’, CentraSite displays entities whose names start with ‘A’.

    Leave Entity Name empty to view all names.

    Policy Type The type of policy whose log entries you want to view. To view the log entries for design/change-time policies, select Design/Change Time from the drop-down list (if it is not already selected).
    Object Type The object type whose log entries you want to view.
    Event Type The event type whose log entries you want to view.
    Policy Status The policy execution status that you want to view.

    A policy's execution status is the result set of each of its action's execution result. CentraSite writes the following policy execution status to the policy log depending on the log configuration:

    Icon
    Description

    active

    Success. Displays policies that have resulted in success alert.

    graphics/Information_system_wide_10.png

    Info. Displays policies that have resulted in informational alert.

    graphics/status_yellow_16.gif

    Inprogress. Displays policies that have resulted in inprogress alert.

    graphics/Warning_system_wide_10.png

    Warning. Displays policies that have resulted in warning alert.

    inactive

    Failure. Displays policies that have resulted in failure alert.
    Execution Date

    Optional. The time period that you want to examine. Leave the From and To fields empty to view log entries for all dates.

  3. Click Search to retrieve the specified log entries.

  4. To view details for a particular entry in the returned list, click the name of the policy.

    Note:
    If a policy included a WS-I action, the log entry for the policy will include a link to the results of the WS-I action.

Top of page

The Approval History Log

The Approval History Log contains a record of all approval requests that have been triggered by a policy with an approval workflow action. This log shows the status of each approval request that has been submitted to CentraSite.

To view the Approval History Log, you must belong to a role that includes the "View Approval History" permission. To see the list of predefined roles that include this permission, see the section About Roles and Permissions in the document Users, Groups, Roles and Permissions.

To view the Approval History Log, perform the following steps:

Start of instruction setTo view the Approval History Log

  1. In CentraSite Control, go to Administration > Logs > Approval History.

  2. Filter your search for approval log information by completing the following fields and clicking Search:

    In this field... Do the following...
    Object Name The object that was submitted for approval.
    Approval Flow Name The name assigned to the approval workflow.
    Requestor Click Select User and select the user who requested the approval.
    Approver Click Select User(s) and select the user(s) who approved the request.
    Request Date From/To Use the calendar to specify a date range for the requests.
    Approval Date From/To Use the calendar to specify a date range for the approvals.
    Status Select a status of the approval request (e.g., In Progress, Approved, etc.).
  3. To view details of a particular approval workflow, click the hyperlinked value in the Approval Flow Name column.

  4. The Approval Flow Information panel provides the following information about the approval workflow.

    Field Description
    Approval Flow Name Name of the approval workflow.
    Mode Mode of the approval workflow (e.g., Anyone or Everyone).
    Status Status of the approval policy (e.g., In Progress, Approved, New, No Action, Pending or Rejected).
    Creation Date Date when the approval workflow was created.
  5. The Requestor Summary panel provides the following information about the requestor of the approval workflow.

    Field Description
    Requestor Name User who triggered the approval workflow.
    Approval Type Name of the approval action (for example, Initiate Approval or Initiate Group-dependent Approval)
    Entity Name of the entity on which the approval was triggered.
    Reason for Request Additional comments or descriptive information stating the reason for the approval request.
  6. The Approver Summary panel provides the following information about the approver(s) of the approval workflow.

    Field Description
    Approver User who approved or rejected the approval workflow.
    Action Action of the approver (e.g., Approved or Rejected).
    Comments Additional comments or descriptive information stating the reason for approval or rejection.

Top of page

Audit Logs

An audit log reports on the creation/update activities of a particular asset (including changes in an asset's lifecycle state).

You can view the audit logs of any asset that you can view. For more information about asset permissions, see the section Setting Permissions on an Asset in the document Using the Asset Catalog.

To view an asset's audit log, perform the following steps:

Start of instruction setTo view an asset's audit log

  1. Display the asset's detail page and select the Audit Log profile as described in the section Viewing Details for an Asset in the document Using the Asset Catalog.

  2. The Audit Log profile displays the following information:

    Field Description
    Event Type The type of event that was executed on the asset (e.g., created or updated).
    Date/Time The date and time that the event was executed.
    User The user who executed the event.
    Comment Descriptive information about the event executed on the asset.

Top of page

Run-Time Event Logs

The run-time event log contains information about run-time events that have occurred in a target (i.e., a policy-enforcement point (PEP) or a run-time monitoring component).

The target publishes to CentraSite the run-time events that have occurred (assuming that the target type contains a MIB file in its target type definition file, as described in the section Creating and Managing Target Types in the document Managing Targets and Run-Time Events). CentraSite provides predefined event types for use with webMethods Mediator or any third-party PEP that is integrated with CentraSite (for more information, see the section Run-Time Events in the document Managing Targets and Run-Time Events).

Each asset has its own run-time event log, which is located on the Events profile on its detail page. (To view an asset's detail page, see the section Viewing Details for an Asset in the document Using the Asset Catalog.) For a description of the Events profile of a virtual service, see the topic The Events Profile in the section Viewing or Editing the Profiles of Virtualized Services in the document Working with Virtualized Services.

By default, all the predefined event types are logged, but you may disable any type (see Configuring Logs).

Users with the proper permissions can perform these additional tasks:

For more information about these additional tasks, see the section Run-Time Events in the document Managing Targets and Run-Time Events.

Top of page

Run-Time Performance Logs

Targets capture run-time metrics for assets. If you are using the Mediator target, Mediator's data collector captures Key Performance Indicator (KPI) metrics for each virtual service and publishes them to CentraSite at regular intervals. If you are using a run-time monitoring component such as Insight, the monitoring component captures the KPI metrics of all rogue assets and publishes them to CentraSite at regular intervals.

Each asset has its own performance log, which is located on the Performance profile on its detail page. (To view an asset's detail page, see the section Viewing Details for an Asset in the document Using the Asset Catalog.) For a description of the performance metrics of a virtual service, see the section Run-Time Events in the document Managing Targets and Run-Time Events. The Performance profile is similar for all assets.

By default this log is enabled, but you may disable it as described in Configuring Logs.

Top of page