This topic provides instructions for creating a new dynamic enrichment event management policy and for creating a new dynamic enrichment blackout policy.
Before you begin
To create a new dynamic enrichment policy
- From the Event Management Policies tab of the Administration View, expand the By Policy Type folder.
- Under the By Policy Type folder, select Dynamic Enrichment Policy.
- Click Add Policy.
A Selector Chooser dialog box is displayed.
- From the Selector Chooser dialog box, select the event selector that you want to use for this policy and click OK.
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
- In the Policy Name field, type a unique alphanumeric name for the event management policy. The name must contain no spaces.
- In the Description field, type a description of the event management policy.
- To enable the policy immediately, select the Enabled check box. If you do not want to enable the policy at this time, you can return to this dialog box and enable the policy later.
In the Execution Orderfield, if more than one policy exists, specify the order of execution.
- In the Policy Activation Timeframessection, define the periods of time the event management policy should be active (when enabled) by performing the following actions:
- 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.
- 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:
- If you do not want to accept the default event class, you can select an event class by clicking the ellipses button in the Event Class field of the Match Fields section, selecting a new event class, and clicking OK.
The Event Class determines what slots are available in the Available Event Fields column. - In the Class Chooser dialog box, select an event class and click OK.
- In Available Event Fields column, select the slots that correspond to the match fields in your dynamic enrichment source file. Use the left arrow button to move those slots into the Match Fields column. You might select and move multiple slots at the same time.
In Available Event Fields column, select the slots that correspond to the output fields in your dynamic enrichment source file. Use the right arrow button to move those slots into the Output Fields column. You might select and move multiple slots at the same time.
- (Optional) In the Match Fields section, activate the Match Tracing check box to add diagnostic notes to the event, if necessary.
The match tracing information is written into the event under the mc_notes
and mc_operations
slots. In the Match Table section, in the Typefield, accept the default.
In the Match Table section, in the Tagfield, accept the default.
- In the Match Table section, in the Data File field, do one of the following actions:
- Type the path to the enrichment data source.
- To browse for the enrichment data source, click the ellipses button . In the File Chooser dialog box, select the dynamic enrichment source file appropriate for your policy and click OK. For more information, see External enrichment data sources.
- In the Match Table section, in the File Formatfield, select one of the following radio buttons to specify the type of data enrichment file to import:
- Data file with this separator—Choose this option to import a flat, delimited file, such as a .csv file. Enter a separator to delimit the data column in the file.
For example, if you are using a .csv file, enter a comma (,) as the separator. - PMEP file—Choose this option to import a PMEP table and select the appropriate PMEP format for your policy from the drop list:
- Blackout
- Blackout CSV
- Location
- Location CSV
- Service
- Service CSV
- Text
Text CSV
- Click OK.
If this is the first time a policy is saved, the a confirmation dialog box is displayed as shown in the following figure.
Import confirmation
- 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 BMC ProactiveNet Administration Console window. - Import the data from the dynamic enrichment source enrichment file as described in Importing dynamic enrichment source.
To create a new dynamic enrichment blackout policy
- From the Event Management Policies tab of the Administration View, expand the By Policy Type folder.
- Under the By Policy Type folder, select Dynamic Blackout Policy.
- Click the Add Policy button
A Selector Chooser dialog box is displayed.
- From the Selector Chooser dialog box, select the event selector that you want to use for this policy and click OK.
The Dynamic Blackout Policy Details tab is displayed in the details pane of the Administration View, as shown in the following figure.
Dynamic Blackout Policy Details tab
- In the Policy Name field, type a unique alphanumeric name for the event management policy. The name must contain no spaces.
- In the Description field, type a description of the event management policy.
- To enable the policy immediately, select the Enabled check box. If you do not want to enable the policy at this time, you can return to this dialog box and enable the policy later.
In the Execution Order field, if more than one policy exists, specify the order of execution.
- In the Policy Activation Timeframes section, define the periods of time the event management policy should be active (when enabled) by performing the following actions:
- 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.
- 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:
- If you do not want to accept the default event class, you can select an event class by clicking the ellipses button
in the Event Class field of the Match Fields section, selecting a new event class, and clicking OK.
The event class determines what slots are available in the Available Event Fields column. - In the Class Chooser dialog box, select an event class and click OK.
- In Available Event Fields column, select the slots that correspond to the match fields in your dynamic enrichment source file. Use the left arrow button to move those slots into the Match Fields column. You might select and move multiple slots at the same time.
In Available Event Fields column, select the slots that correspond to the output fields in your dynamic enrichment source file. Use the right arrow button to move those slots into the Output Fields column. You might select and move multiple slots at the same time.
- (Optional) In the Match Fields section, activate the Match Tracing check box to add diagnostic notes to the event, if necessary.
In the Match Table section, in the Type field, accept the default.
In the Match Table section, in the Tag field, accept the default.
- In the Match Table section, in the Data File field, do one of the following actions:
- Type the path to the enrichment data source.
- To browse for the enrichment data source, click the ellipses button.In the File Chooser dialog box, select the dynamic enrichment source file appropriate for your policy and click OK. For more information, see External enrichment data sources.
- In the Match Table section, in the File Format field, select one of the following radio buttons to specify the type of data enrichment file to import:
- Data file with this separator—Choose this option to import a flat, delimited file, such as a .csv file. Enter a separator to delimit the data column in the file.
For example, if you are using a .csv file, enter a comma (,) as the separator. - PMEP file—Choose this option to import a PMEP table and select the appropriate PMEP format for your policy from the drop list:
- Blackout
- Blackout CSV
- Location
- Location CSV
- Service
- Service CSV
- Text
Text CSV
- Click OK.
If this is the first time a policy is saved, the following confirmation dialog box is displayed:
Import confirmation
- 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 BMC ProactiveNet Administration Console window. - Import the data from the dynamic enrichment source enrichment file as described in Importing dynamic enrichment source.