Enabling a dynamic enrichment PATROL message text translation  policy


If you are integrated with PATROL, the dynamic enrichment PATROL message translation policy enables you to substitute existing PATROL messages with messages that are meaningful to your enterprise. 

For example, you can use the PATROL message translation policy to change this message: 

NT_CPU.CPU_0.CPUprcrUserTimePercent parameter CPUCputil triggered on 90 <= 97 <= 100

to the following, more comprehensible message:

CPU Utilization is at 97%

Note

A sample dynamic enrichment service contact policy data source file, TextTranslation.csv, is provided in the installationDirectory\admin\etc\samples directory. The TextTranslation.csv file includes translations for many common messages that are useful in your enterprise. If you are integrated with PATROL, BMC recommends that you take advantage of the data that is already included in this sample file. For information about using the TextTranslation.csv file, see Using-the-sample-PATROL-messaging-text-translation-dynamic-enrichment-source-file.

To enable a dynamic enrichment PATROL message translation policy

  1. From the Event Management Policies tab of the Administration View, expand the By Policy Type folder.
  2. Under the By Policy Type folder, select Dynamic Enrichment Policy.

    A list of out-of-the-box dynamic enrichment policies are displayed in the right pane of the Administration View as shown in the following figure.

    List of out-of-the-box dynamic enrichment policies
    picobject_291.gif
  3. From the list of out-of-the-box dynamic enrichment policies, select PATROL_Message_Translation.
  4. Click Update Policy picobject_282.gif.

    The Dynamic Enrichment Policy Details tab, shown in the following figure, is displayed in the details pane of the Administration View.

    Dynamic Enrichment Policy Details tab
    picobject_293.gif
  5. To enable the event management policy, select the Enabled check box. If you do not want to enable the event management policy at this time, it can be enabled later.
  6. In the Execution Order field, if more than one policy exists, specify the order of execution.

    Note

    When a new policy is created, the number shown in the Execution Order field should be one greater the largest current execution order.

    If two policies have the same execution order, they run in indeterminate order.

  7. In the Policy Activation Timeframessection, define the periods of time the event management policy should be active (when enabled) by performing the following actions:
    1. Select one of the following choices:
      • To make the event management policy active continuously, select Always Active.
      • To specify when the policy is active or inactive, select Define Activation Timeframes.
         The Active Timeframes and Not Active Timeframes lists are displayed.
    2. If you selected Define Activation Timeframes, depending on how you want to define the timeframe for your policy do one or both of the following:
      • To specify the periods of time when the policy should be active, select the Active Timeframes check box and one or more timeframes from its scrollable list. 
      • To specify the periods of time when the policy should be inactive, select the Not Active Timeframes check box and one or more timeframes from its scrollable list.

        Note

        You can select both check boxes to create active and inactive time periods. However, the inactive time period takes precedence over the active time period.

  8. (Optional) In the Match Fields section, activate the Match Tracing check box to add diagnostic notes to the event, if necessary.
  9. Click OK.

    If this is the first time a policy is saved, the following confirmation dialog box is displayed:

    Import confirmation
    picobject_280.gif
  10. Click Yes.

    A green check mark should be displayed in the Enable column next to the policy in the event management policies list. (You might need to scroll the window to the right to see the Enable column.) The policy also should show up in the tree in the left pane of the administration console window.
  11. Import the data from the dynamic enrichment source enrichment file as described in Importing-dynamic-enrichment-source.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*