Create a New Map

You must have the flow map license to deploy a map in monitoring session.

For new users, the free trial bundle will expire after 30 days and the GigaVUE-FM prompts you to buy a new license. For licensing information refer to GigaVUE Licensing Guide.

A map is used to filter the traffic flowing through the GigaVUE V Series Nodes. It is a collection of one or more rules (R). The traffic passing through a map can match one or more rules defined in the map.

Keep in mind the following when creating a map:

Parameter Description

Rules

A rule (R) contains specific filtering criteria that the packets must match. The filtering criteria lets you determine the targets and the (egress or ingress) direction of tapping the network traffic.

Priority

A priority determines the order in which the rules are executed. The priority value can range from 1 to 5, with 1 being the highest and 5 is the lowest priority.

Pass

The traffic from the virtual machine will be passed to the destination.

Drop

The traffic from the virtual machine is dropped when passing through the map.

Traffic Filter Maps

A set of maps that are used to match traffic and perform various actions on the matched traffic.

Inclusion Map

An inclusion map determines the instances to be included for monitoring. This map is used only for target selection.

Exclusion Map

An exclusion map determines the instances to be excluded from monitoring. This map is used only for target selection.

Automatic Target Selection (ATS)

A built-in feature that automatically selects the cloud instances based on the rules defined in the traffic filter maps, inclusion maps, and exclusion maps in the monitoring session.

The below formula describes how ATS works:

Selected Targets = Traffic Filter Maps ∩ Inclusion Maps - Exclusion Maps

Group

A group is a collection of maps that are pre-defined and saved in the map library for reuse.

To create a new map:

  1. After creating a new monitoring session, or click Edit on an existing monitoring session, the GigaVUE-FM canvas appears.
  2. In the canvas, select New > New Map, drag and drop a new map template to the workspace. The New Map quick view appears.


  3. On the New Map quick view, enter or select the required information as described in the following table.

    Field

    Description

    NameName of the new map

    Description

    Description of the map

    Map Rules

    The rules for filtering the traffic in the map. Through the map, packets can be dropped or passed based on the highest to lowest rule priority. You can add 5 rule sets on a map. Use the + and - buttons to add or remove a rule set in the map. Each rule set can have only 25 rules per map and each map can have multiple conditions. To add ATS rules for an Inclusion/Exclusion map, you must select at least one rule condition.
    To add a map rule:

    1. Enter a Priority value from 1 to 5 for the rule with 1 being the highest and 5 is the lowest priority.
    2. Click Add a Rule. The new rule field appears for the Application Endpoint.
    3. Select a required condition from the drop-down list.
    4. Select the rule to Pass or Drop through the map.
    If two rules with same condition are configured as pass and drop,
    • on a same tunnel endpoint, the traffic filtering precedence will be based on the priority value.
    • on two different tunnel endpoints, the traffic will be passed or dropped to the respective tunnel endpoints.

    For detailed information on filtering fragmented and unfragmented packets, refer to  GigaSMART Adaptive Packet Filtering (APF).

    Pass and Drop rule selection with Automatic Target Selection (ATS) differ with the Map type as follows:
    • Traffic Map—Only Pass rules for ATS
    • Inclusion Map—Only Pass rules for ATS
    • Exclusion Map—Only Drop rules for ATS
  4. To reuse the map, click Add to Library. Save the map using one of the following ways:
    1. Select an existing group from the Select Group list or create a New Group with a name.
    2. Enter a description in the Description field, and click Save.
  5. Click Save.

Note:  If a packet is fragmented then all the fragments will be destined to the same application end point. You can find the stats of mapped fragmented traffic in GigaVUE-FM. Refer to Map Statistics for detailed information.

To edit a map, select the map and click Details, or click Delete to delete the map.

Rules and Notes:

  • Directional rules do not work on single NIC VMs that are running a windows agent.

You can also perform the following action in the Monitoring session canvas.

  • Click a map and select Details to edit the map or select Delete to delete the map.
  • Click the Show Targets button to view the monitoring targets highlighted in orange.
  • Click to expand the Targets dialog box. Click to change the view from the list view to topology view. To view details about a GigaVUE V Series Node, click the arrow next to the VM.
  • In the Instances window, click to filter the list of instances.

Example- Create a New Map using Inclusion and Exclusion Maps

Consider a monitoring session with 5 cloud instances. Namely target-1-1, target-1-2, target-1-3, target-2-1, target-2-2.

  1. Drag and drop a new map template to the workspace. The New map quick view appears.
  2. Enter the name as Map 1 and enter the description. Enter the priority and Application Endpoint ID.
  3. Select the condition as VM Name and enter the target. This includes the instances, target-1-1, target-1-2, target-1-3, target-2-1, and target-2-2.
  4. Click on the Expand icon on the bottom of the Monitoring session canvas. The Inclusion Maps and Exclusion Maps sections appears.
  5. Drag and drop a new map template to the Inclusion Maps region. The New Map quick view appears. Enter the Name and Description for the map.
    1. Enter the name as Inclusionmap1 and enter the description. Enter the priority and Application Endpoint ID.
    2. Select the condition as VM Name and enter the VM Name as target-1. Then the instance with VM name target-1-1, target-1-2, and target-1-3 will be included.
  6. Drag and drop a new map template to the Exclusion Maps region. The New Map quick view appears. Enter the details as mentioned in above section.
    1. Enter the name as Exclusionmap1 and enter the description. Enter the priority and Application Endpoint ID.
    2. Select the condition as VM Name and enter the VM Name as target-1-3. Then the instance target-1-3 will be excluded.

    Based on this configuration, the Automatic Target Selection will select the instances target-1-1 and target-1-2 as target.