The Black List defines a set of rules for data which should not be collected or analyzed from monitored environments. For example, page views and interactions by you or other site administrators. All Black List rules are applied from the moment the rule is created and are not retroactive. The Black List can be found in the navigation pane under Administration.

Contents

How to Create a New Rule

  1. In the Navigation pane, under Administration, click Black List
  2. In the Central Area, in the bottom left corner, click Add.
  3. In the Add Rule dialog, enter the Name and Description fields.
  4. In the Add Rule dialog, under Define more criteria, select values for the Field which may be Date Range, Website Item, User Name, Authentication Group, URL, Web Server IP Address, User Agent, or Client IP Address. These are all described below.
  5. Choose the Condition you would like to define your field by.
  6. Enter a Value in the text box or use the "..." button to open a search window that depending on the Field.

     
    Add Rule Dialog
     
  7. Click Add.
  8. Choose a second set of criteria if you would like to combine rule. For example, you may want to black list a Website Item that is only accessed from a specific User Agent.
  9. Click Save.
  10. The new rule is added to the Black List. The Valid From Column in the Central Area displays the date and time the rule was activated.

    Note Separate rules in the Black List have an OR relationship, which means they do not influence or rely on each other. Multiple criteria within a single rule have an AND relationship, which means that all criteria within the rule must be met.


    Black List dialog

  11. To edit a rule, simply click on it and edit the parameters as you would when adding a rule.
  12. To delete a rule, select it using the inline check box and click Remove from the bottom left hand corner.


    Edit Rule dialog

     

How to Set a Date Range Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select Date Range from the Field drop down list.
  2. Click on Browse (...) and select a date range.
  3. Click OK to confirm your selection.


    Customized Date Range Dialog

How to Set a Website Item for a Black List Rule

  1. In the Add or Edit Rule dialog select Website Item from the Field drop down list, .
  2. Select the desired Condition from the drop-down list, Choose is (specific) to select a specific item or select is (aggregated) to also include child items.
  3. Click on Browse (...) and select an item using the Object Explorer
  4. Click OK to confirm your selection.


Website Item Object Explorer Dialog

 

How to Set a User Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select User Name or Authentication Group from the Field drop down list, .
  2. Select the desired Condition from the drop-down list.
  3. Click on Browse (...) and search for and select the desired user/group.
  4. Click OK to confirm your selection.

     
    Select User Name Dialog 

How to Set a URL Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select URL from the Field drop down list, .
  2. Select the desired Condition from the drop-down list.
  3. Enter a URL address in the Value text box.
  4. Click Save to confirm your selection.

     
    Setting a URL Criterion for a Black List Rule
 

How to Set a Web Server IP Address Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select Web Server IP Address from the Field drop down list.
  2. Select the desired Condition from the drop-down list.
  3. Enter an IP address in the Value text box.
  4. Click Save to confirm your selection.


    Setting a Web Server IP Address Criterion for a Black List Rule

How to Set a User Agent Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select User Agent from the Field drop-down list, .
  2. Select the desired Condition from the drop-down list.
  3. Enter a User Agent string in the Value text box.
  4. Click Save to confirm your selection.

     
    Setting a User Agent Criterion for a Black List Rule


How to Set a Client IP Address Criterion for a Black List Rule

  1. In the Add or Edit Rule dialog select Client IP Address from the Field drop down list.
  2. Select the desired Condition from the drop-down list.
  3. Enter an IP address in the Value text box.
  4. Click Save to confirm your selection.

     
    Setting a Client IP Address Criterion for a Black List Rule


  • No labels