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 Actions > 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
   Name	Name of the new map
   Description	Description of the map
   Selected Virtual Machines Using this option, you can select an individual Network adapter of a virtual machine as a target. You can also view and filter the list of virtual machines available. When using this option, you cannot use Automatic Target Selection (ATS).
   Virtual Machine List	Click on the Virtual Machine List button. The Virtual Machine List quick view opens. Select the virtual machines you wish to use as the target and click on the Apply button in the Virtual Machine List quick view to save your changes. You can also use the filter button to filter the virtual machines. To filter the list of virtual machines: Click on the Filter button to filter the virtual machines based on any of the following criteria: Data Center Cluster Host Name VM Name VM Tag Category VM Tag Name After selecting the details, click on the Apply button in the filter dialog box to apply the filters. The list of virtual machines appears based on the filter criteria. Select the virtual machines you wish to use as the target and click on the Apply button in the Virtual Machine List quick view to save your changes.
   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: Enter a Priority value from 1 to 5 for the rule with 1 being the highest and 5 is the lowest priority. Click Add a Rule. The new rule field appears for the Application Endpoint. Select a required condition from the drop-down list. 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).

   • VMware tools are not required to discover targets, since GigaVUE-FM can discover targets with ATS using the tags attached to the VMs.
   • Targets can be selected by providing the VM's node name or the hostname as selection criteria. A host is selected when the hostname matches all the active targets.
   • 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 Statisticsfor detailed information.

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

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.