Consumption Analytics Documentation

Home > Documentation for older versions > Cloud Cruiser 4 > Collecting, transforming, and publishing > VMware vCloud Networking and Security > Mapping data to Cloud Cruiser

Mapping data to Cloud Cruiser


The VMware vCloud Networking and Security Collector retrieves XML data that you can map to CC Record output using XPath expressions and standard output field mapping. This works the same as does mapping output from the XML Collector. For general information about data mapping for XML that also applies to vCloud Networking and Security, see Mapping data to Cloud Cruiser in the section for XML collection.

The collector can write the raw XML it collects to a file, which gives you a useful reference for creating XPath mappings if you want to collect data beyond that provided by the sample collection job. To do this, set the printEntityXML property of com.cloudcruiser.batch.collect.vmware.vcloudnetsec.VCloudNetSecCollector to true, set the xmlOutput property to the desired output filename, and run the collector once. Another useful reference for the XML structure of vCloud Networking and Security data is the vShield API Programming Guide.

Feed configuration settings

You use the com.cloudcruiser.batch.collect.vmware.vcloudnetsec.VCloudNetSecFeedConfig bean to configure a vCloud Networking and Security feed. You can specify the following properties:

  • component: The component types to collect. In this release, you must set this to Edge. In future releases, the vCloud Networking and Security Collector might be enhanced to collect other component types.
  • instances: The Edge instances about which to collect data. Specify a comma-delimited list of Edge IDs or, to collect for all instances, specify *. For example, edge-68,edge-73,edge-75.
  • xpathOutputs: A list of XPathOutputMappings of data to Cloud Cruiser outputs. At the Edge instance level, this data becomes identifiers with the exception of the number of deployed VMs, which becomes a resource. At the subfeed level, the data maps a resource.
  • subFeedConfigs: A list of child VCloudNetSecFeedConfig feed configurations mapping data from Edge subcomponents such as firewall rules and network interfaces to Cloud Cruiser resources
    • If you want to collect additional resources, refer to the XML structure in the relevant section of the vShield API Programming Guide. The Guide also specifies the request URL for a given subcomponent. Use the portion of this URL following https://<vsm-ip>/api/3.0/edges/<edgeId> as the value of the subUrl property for that child VCloudNetSecFeedConfig bean.
    • Many XPath mappings in this list in the sample collection job include a qualifier that lets you restrict collection of the specified resource to only those instances that are active. For example, the XPath expression for load balancers is //loadBalancer[enabled='true'], limiting the resource count to only enabled load balancers. You could set enabled to false to count all load balancers.
  • subUrl: Used only when the feed configuration is in a list of subFeedConfigs. See description under that property.

Mapping specific fields

The sample collection job performs the following mappings.


The following resources are provided in the vcloud_networking_and_security.csv import file and the sample collection job maps data to them:

  • vcloud.netsec.edge.DeployedVm
  • vcloud.netsec.edge.Interface
  • vcloud.netsec.edge.FirewallRule
  • vcloud.netsec.edge.Appliance
  • vcloud.netsec.edge.NatRule
  • vcloud.netsec.edge.StaticRoute
  • vcloud.netsec.edge.IpsecSite
  • vcloud.netsec.edge.Loadbalancer
  • vcloud.netsec.edge.HighAvailability
  • vcloud.netsec.edge.Dhcp
  • vcloud.netsec.edge.Dns


The sample collection job maps attributes of an Edge to the following identifiers:

Name in vCloud Networking and Security Manager Identifier Name
Id EdgeId
Name EdgeName
Tenant TenantId
Size ApplianceSize
Datacenter Name DatacenterName

The job also creates the identifier typeName, which indicates which type of vCloud Networking and Security Manager component a resource is associated with. This corresponds to the componentType property of the collector's feed configuration, and because the collector only retrieves Edge data in this release, the identifier's value is always Edge.

Last modified


This page has no custom tags.


This page has no classifications.

 (c) Copyright 2017-2020 Hewlett Packard Enterprise Development LP