Introduction

VMware NSX-T™ Data Center provides an agile software-defined infrastructure to build cloud-native application environments. NSX-T Data Center focuses on providing networking, security, automation, and operational simplicity for emerging application frameworks and architectures that have heterogeneous endpoint environments and technology stacks.

VMware NSX

VMware NSX is a network virtualization and security platform that enables the virtual cloud network, a software-defined approach to networking that extends across data centers, clouds and application frameworks.

VMware NSX is suitable for all infrastructure types:

  • Multi-cloud environments
  • On-premises data centers
  • Bare metal servers
  • Containerized workloads

Benefits of NSX-T

The main benefit is that NSX-T can be deployed in heterogeneous environments with many different components. NSX-T is not under the confines of the vCenter deployment. You can have multiple vCenter servers and use one NSX manager as a single pane of glass for controlling your virtual network. Or, you do not have to deploy a vCenter at all. Instead, you can choose ESXi as the operating system in the NSX-T GUI.

NSX-T Main Components:

The primary components of VMware NSX-T are:

  • NSX-T Manager: provides graphical user interface (GUI) and RESTful API for creating, configuring, and monitoring NSX-T components, such as segments and gateways.

  • NSX-T Controller: they are responsible for the programmatic deployment of virtual networks across the entire NSX-T architecture, and control the virtual networks and overlay transport tunnels.

  • NSX-T Edges: provides routing services and connectivity to networks that are external to the NSX-T deployment.

  • Logical Firewall: NSX-T handles traffic in and out of the network according to firewall rules.

  • Logical Routers (Gateways): NSX-T Gateways provide North-South connectivity so that workloads can access external networks and East-West connectivity between different logical networks.

  • Transport Zone: A transport zone defines a collection of hosts that can communicate with each other across a physical network infrastructure.

Prerequisites

  • OpsRamp Classic Gateway 14.0.0 and above.
  • OpsRamp Nextgen Gateway 14.0.0 and above.
    Note: OpsRamp recommends using the latest Gateway version for full coverage of recent bug fixes, enhancements, etc.
Supported Target Version
Application validated against target versions 3.2.0 and 4.0.0
REST API version using 3.2.0
REST API version 4.0.0

Hierarchy of NSX-T resources

NsxT Manager Cluster
    – NsxT Manager (i.e, nodes)
    – NsxT Edge Cluster
        – NsxT Logical Router
            – NsxT Firewall
    – NsxT Transport Zone
        – NsxT Transport Node (i.e, Host(ESXi) nodes & Edge nodes)
            – NsxT Edge Physical Network Interface
            – NsxT Host Physical Network Interface
            – NsxT Virtual Machine (i.e, Host & Edge VMs)
        – NsxT Logical Switch

Supported Metrics

Click here to view the supported metrics
Native TypeMetric NameMetric Display NameMetric LabelUnitsApplication VersionDescription
NsxT Edge Clusternsxt_edgecluster_StatusNSXT EdgeCluster StatusAvailability2.0.0Returns the aggregated status for Edge Cluster

Possible values: Up, Down, Degraded, Unknown.
NsxT Edge Physical Network Interfacensxt_edgenode_physicalinterface_AdminStatusNSXT EdgeNode Physical Interface Admin StatusAvailability2.0.0EdgeNode Network Interface Admin Status.

Possible values: Up, Down, Degraded, Unknown.
nsxt_edgenode_physicalinterface_LinkStatusNSXT EdgeNode Physical Interface Link StatusAvailability2.0.0EdgeNode Physical Interface Link Status.

Possible values: Up, Down, Degraded, Unknown.
nsxt_edgenode_physicalinterface_TotalTransmittedPacketsNSXT EdgeNode Physical Interface Total Transmitted PacketsAvailabilitycount8.0.0Number of packets transmitted.
nsxt_edgenode_physicalinterface_DroppedTransmittedPacketsNSXT EdgeNode Physical Interface Dropped Transmitted PacketsAvailabilitycount8.0.0Number of transmitted packets dropped.
nsxt_edgenode_physicalinterface_TotalReceivedPacketsNSXT EdgeNode Physical Interface Total Received PacketsAvailabilitycount8.0.0Number of packets received.
nsxt_edgenode_physicalinterface_DroppedReceivedPacketsNSXT EdgeNode Physical Interface Dropped Received PacketsAvailabilitycount8.0.0Number of received packets dropped.
nsxt_edgenode_physicalinterface_TotalTransmittedBytesNSXT EdgeNode Physical Interface Total Transmitted BytesAvailabilityGB8.0.0Number of bytes transmitted.
nsxt_edgenode_physicalinterface_TotalReceivedBytesNSXT EdgeNode Physical Interface Total Received BytesAvailabilityGB8.0.0Number of bytes received.
nsxt_edgenode_physicalinterface_ReceiveErrorsNSXT EdgeNode Physical Interface Receive ErrorsAvailabilitycount8.0.0Number of receive errors.
nsxt_edgenode_physicalinterface_TransmitErrorsNSXT EdgeNode Physical Interface Transmit ErrorsAvailabilitycount8.0.0Number of transmit errors.
nsxt_edgenode_physicalinterface_CollisionsNSXT EdgeNode Physical Interface CollisionAvailabilitycount8.0.0Number of collisions detected.
nsxt_edgenode_physicalinterface_CarrierLossNSXT EdgeNode Physical Interface Carrier LossAvailabilitycount8.0.0Number of carrier losses detected.
NsxT Firewallnsxt_firewall_RuleCountNSXT Firewall Rule CountUsagecount2.0.0Number of Rules associated with a Firewall.
nsxt_firewall_SectionCountNSXT Firewall Section CountUsagecount2.0.0Number Of sessions within a firewall returns.

Total Number Of Sections available for a Firewall.
NsxT Host Physical Network Interfacensxt_hostnode_physicalinterface_AdminStatusNSXT HostNode Physical Interface Admin StatusAvailability2.0.0HostNode Network Interface Admin Status.

Possible values: Up, Down, Degraded, Unknown.
nsxt_hostnode_physicalinterface_LinkStatusNSXT HostNode Physical Interface Link StatusAvailability2.0.0HostNode Network Interface Link Status.

Possible values: Up, Down, Degraded, Unknown.
nsxt_hostnode_physicalinterface_TotalTransmittedPacketsNSXT HostNode Physical Interface Total Transmitted PacketsAvailabilitycount8.0.0Number of packets transmitted
nsxt_hostnode_physicalinterface_DroppedTransmittedPacketsNSXT HostNode Physical Interface Dropped Transmitted PacketsAvailabilitycount8.0.0Number of transmitted packets dropped
nsxt_hostnode_physicalinterface_TotalReceivedPacketsNSXT HostNode Physical Interface Total Received PacketsAvailabilitycount8.0.0Number of packets received
nsxt_hostnode_physicalinterface_DroppedReceivedPacketsNSXT HostNode Physical Interface Dropped Received PacketsAvailabilitycount8.0.0Number of recieved packets dropped
nsxt_hostnode_physicalinterface_TotalTransmittedBytesNSXT HostNode Physical Interface Total Transmitted BytesAvailabilityGB8.0.0Number of bytes transmitted
nsxt_hostnode_physicalinterface_TotalReceivedBytesNSXT HostNode Physical Interface Total Received BytesAvailabilityGB8.0.0Number of bytes received.
nsxt_hostnode_physicalinterface_ReceiveErrorsNSXT HostNode Physical Interface Receive ErrorsAvailabilitycount8.0.0Number of receive errors.
nsxt_hostnode_physicalinterface_TransmitErrorsNSXT HostNode Physical Interface Transmit ErrorsAvailabilitycount8.0.0Number of transmit errors.
nsxt_hostnode_physicalinterface_CollisionsNSXT HostNode Physical Interface CollisionsAvailabilitycount8.0.0Number of collisions detected.
nsxt_hostnode_physicalinterface_CarrierLossNSXT HostNode Physical Interface Carrier LossAvailabilitycount8.0.0Number of carrier losses detected.
NsxT Logical Switchnsxt_logicalswitch_DroppedReceivedPacketsNSXT LogicalSwitch Dropped Received PacketsUsagecount2.0.0Number of received packets received by Logical Switch.
nsxt_logicalswitch_DroppedTransmittedPacketsNSXT LogicalSwitch Dropped Transmitted PacketsUsagecount2.0.0Number of transmitted packets dropped by Logical Switch.
nsxt_logicalswitch_FullyRealizedSwitchCountNSXT LogicalSwitch Fully Realized Switch CountUsagecount2.0.0Number of Logical switches in fully realized state
nsxt_logicalswitch_LogicalPortCountNSXT LogicalSwitch LogicalPorts CountUsagecount2.0.0Number of Logical ports associated with a logical switch
nsxt_logicalswitch_TotalReceivedBytesNSXT LogicalSwitch Total Received ByttesUsageGB2.0.0Number of transmitted packets dropped by Logical Switch
nsxt_logicalswitch_TotalReceivedPacketsNSXT LogicalSwitch Total Received PacketsUsagecount2.0.0Number of packets received by Logical Switch
nsxt_logicalswitch_TotalSwitchCountNSXT LogicalSwitch Total CountUsagecount2.0.0Total Number of Logical Switches
nsxt_logicalswitch_TotalTransmittedBytesNSXT LogicalSwitch Total Transmitted BytesUsageGB2.0.0Number of bytes transmitted by Logical Switch
nsxt_logicalswitch_TotalTransmittedPacketsNSXT LogicalSwitch Total Transmitted PacketsUsagecount2.0.0Total number of Packets transmitted by Logical Switch
NsxT Managernsxt_manager_CPUCountNSXT Manager CPU CountUsagecount2.0.0Total Number Of CPU's on the NSXT Manager
nsxt_manager_DiskSpaceUsedNSXT Manager Disk Space UsedUsageGB10.0.0Amount of disk space in use on the system
nsxt_manager_DiskSpaceTotalNSXT Manager Disk Space TotalUsageGB10.0.0Amount of disk space available on the system
nsxt_manager_DiskSpaceUtilizationNSXT Manager Disk Space UtilizationUsage%10.0.0The Percentage of Disk Space utilized
nsxt_manager_ControllerNodeStatusNSXT Manager ControllerNodeStatusAvailability2.0.0Defines whether controller node is running or not
nsxt_manager_CpuPercentageUtilizationNSXT Manager CPU Percentage Utiizationpercent2.0.0Fifteen minute load averages for the system utilization
nsxt_manager_FilesystemUtlizationNSXT Manager Filesyestem UtilizationUsagepercent2.0.0FileSystems utilization on the VMware NSXT Manager
nsxt_manager_FreeMemoryNSXT Manager Free MemoryUsagekilobytes2.0.0The amount of free memory on the VMware NSXT Manager
nsxt_manager_MemoryUtilizationNSXT Manager Memory UtilizationUsagepercent2.0.0The amount of memory used by the VMware NSXT Manager in percentage
nsxt_manager_TotalMemoryNSXT Manager Total MemoryUsagekilobytes2.0.0The amount of Total memory on the VMware NSXT Manager.
nsxt_manager_UsedMemoryNSXT Manager Used MemoryUsagekilobytes2.0.0The amount of Used memory on the VMware NSXT Manager.
nsxt_manager_CPUUtilizationNSXT Manager CPU UtilizationUsagePercentage2.0.0Fifteen minute load averages for the system utilization
nsxt_manager_ControllerStatusNSXT Manager Controller Status2.0.0Controller Status. Possible values are Running(1),Not Running(0)
NsxT Manager Clusternsxt_managercluster_BackupConfigurationNSX Manager Backup ConfigurationUsageper hour2.0.0Get backup configuration,get a configuration of a file server and timers for automated backup. Fields that contain secrets (password, passphrase) are not returned.
nsxt_resource_APIStatsNSXT Resource API Statistics4.0.0Provides the number of API calls made within the frequency and resources
nsxt_alert_statisticsNSXT Alert Statistics3.0.0Provides NSXT Alert Statistics
NsxT Transport Nodensxt_transportNode_BfdAdminDownCountNSXT TransportNode BFD Admin Down CountAvailabilitycount2.0.0Returns Bidirectional Forwarding Admin Down Count
nsxt_transportNode_BfdAdministrativelyDownCountNSXT TransportNode BFD Administrative Path Down Countcount2.0.0Returns BFD Administrative Path Down Count
nsxt_transportNode_BfdConcatenatedPathDownCountNSXT TransportNode BFD Concatenated Path Down CountAvailabilitycount2.0.0Returns BFD Concatenated Path Down Count
nsxt_transportNode_BfdControlDetectionTimeExpiredCountNSXT TransportNode BFD Control Detection TimeExpired CountAvailabilitycount2.0.0Returns Bi-directional Forwarding Control Detection TimeExpired Count.
nsxt_transportNode_BfdDownCountNSXT TransportNode BFD Down CountAvailabilitycount2.0.0Returns Bidirectional Forwarding Down Count.
nsxt_transportNode_BfdEchoFunctionFailedCountNSXT TransportNode BFD Echo Function Failed CountAvailabilitycount2.0.0Returns Bidirectional Forwarding Detection Of Echo Function Failed Count.
nsxt_transportNode_BfdForwardPlaneResetCountNSXT TransportNode BFD Echo Function Failed CountAvailabilitycount2.0.0Returns BFD Forward Plane Reset Count.
nsxt_transportNode_BfdInitCountNSXT TransportNode BFD Init CountAvailabilitycount2.0.0Returns Bidirectional Forwarding Init Count.
nsxt_transportNode_BfdNeighbourSignalledSessionDownCountNSXT TransportNode BFD Neighbour Signalled Session Down CountAvailabilitycount2.0.0Returns BFD Neighbour Signalled Session Down Count.
nsxt_transportNode_BfdNoDiagnosticCountNSXT TransportNode BFD No Diagnostic CountAvailabilitycount2.0.0Returns Bidirectional Forwarding NoDiagnostic Count.
nsxt_transportNode_BfdPathDownCountNSXT TransportNode BFD Path Down CountAvailabilitycount2.0.0Returns BFD Path Down Count.
nsxt_transportNode_BfdReverseConcatenatedPathDownCountNSXT TransportNode BFD Reverse Concatenated Path Down CountAvailabilitycount2.0.0Returns BFD Reverse Concatenated Path Down Count.
nsxt_transportNode_BfdUpCountNSXT TransportNode BFD Up CountAvailabilitycount2.0.0Returns Bidirectional Forwarding Up Count.
nsxt_transportNode_DataPathHeapUsageNSXT TransportNode Data Path Heap UsageUsagepercent2.0.0Returns Heap usage of the data path of a Transport Node.
nsxt_transportNode_DataPathTotalUsageNSXT TransportNode Data Path Total UsageUsagepercent2.0.0Returns Total usage of data path of a Transport Node.
nsxt_transportNode_LCPConnectionStatusNSXT TransportNode LCP Connection StatusAvailability2.0.0Returns the connection status of transportnode with local control plane.

Possible values: Up, Down, Unknown, Degraded.
nsxt_transportNode_MPAConnectionStatusNSXT TransportNode MPA Connection StatusAvailability2.0.0Returns the connection status of transportnode with Management Plane Agent.

Possible values: Up, Down, Unknown, Degraded.
nsxt_transportNode_PnicDegradedCountNSXT TransportNode PNIC Degraded CountAvailabilitycount2.0.0Returns Count of Physical NIC's in Degraded State.
nsxt_transportNode_PnicDownCountNSXT TransportNode PNIC Down CountAvailabilitycount2.0.0Returns Physical NIC's Down Count.
nsxt_transportNode_PnicStatusNSXT TransportNode PNIC StatusAvailability2.0.0TransportNode PNIC Status.

Possible values: Up, Down, Unknown and Degraded.
nsxt_transportNode_PnicUpCountNSXT TransportNode PNIC Up CountAvailabilitycount2.0.0Returns Physical NIC's Up Count.
nsxt_transportNode_StatusNSXT TransportNode StatusAvailability2.0.0TransportNode Status.

Possible values: Up, Down, Unknown and Degraded.
nsxt_transportNode_TunnelDownCountNSXT TransportNode Tunnel Down CountAvailabilitycount2.0.0Returns Tunnel Count which is in Down State.
nsxt_transportNode_TunnelStatusNSXT TransportNode Tunnel StatusAvailability2.0.0Defines Connectivity Status Of a TransportNode with Another Remote TransportNodes

Possible values: Up, Down, Unknown, Degraded.
nsxt_transportNode_TunnelUpCountNSXT TransportNode Tunnel Up CountAvailabilitycount2.0.0Returns Tunnel Count which is in Up State.
nsxt_transportnode_AvgDpdkCpuCoreUtilizationNSXT TransportNode Avg Dpdk Cpu Core UtilizationUsagepercent2.0.0Average Utilization of DPDK CPU cores in a TransportNode.
nsxt_transportnode_AvgNonDpdkCpuCoreUtilizationNSXT TransportNode Avg Non Dpdk Cpu Core UtilizationUsagepercent2.0.0Average Utilization of Non-DPDK CPU cores in a TransportNode.
nsxt_transportnode_CacheMemoryNSXT TransportNode Cache MemoryUsagemegabytes2.0.0Cache Memory allocated to a TransportNode.
nsxt_transportnode_CacheUtilizationNSXT TransportNode Cache UtilizationUsagepercent2.0.0Cache Memory Utilization of a TransportNode.
nsxt_transportnode_CpuCoresCountNSXT TransportNode Cpu Cores CountUsagecount2.0.0The number of CPU cores in a TransportNode.
nsxt_transportnode_DpdkCpuCoresCountNSXT TransportNode Dpdk Cpu Cores CountUsagecount2.0.0The number of DPDK CPU cores in a TransportNode.
nsxt_transportnode_FileSystemUtlizationNSXT TransportNde FileSystem UtilizationUsagepercent2.0.0File System Utilization Of a TransportNode.
nsxt_transportnode_HighestDpdkCpuCoreUtilizationNSXT TransportNode Highest Dpdk Cpu Core UtilizationUsagepercent2.0.0Highest Utilization of DPDK CPU cores in a TransportNode.
nsxt_transportnode_HighestNonDpdkCpuCoreUtilizationNSXT TransportNode Highest Non Dpdk Cpu Core UtilizationUsagepercent2.0.0Highest Utilization of Non-DPDK CPU cores in a TransportNode.
nsxt_transportnode_LoadAveragesNSXT TransportNode Load AveragesUsagepercent2.0.0Fifteen minute load averages for the system utilization.
nsxt_transportnode_NonDpdkCpuCoresCountNSXT TransportNode Non Dpdk Cpu Cores CountUsagecount2.0.0The number of NON-DPDK CPU cores in a TransportNode.
nsxt_transportnode_SwapUtilizationNSXT TransportNode Swap UtilizationUsagepercent2.0.0Swap Memory utilization of a TransportNode.
nsxt_transportnode_SystemMemoryUtilizationNSXT TransportNode System Memory UtilizationUsagepercent2.0.0Total Memory utilization of a TransportNode.
nsxt_transportnode_TotalDiskSpaceNSXT TransportNode Total Disk SpaceUsagekilobytes2.0.0Total Disk Space of a TransportNode.
nsxt_transportnode_TotalMemoryNSXT TransportNode Total MemoryUsagemegabytes2.0.0Total Memory allocated to a TransportNode.
nsxt_transportnode_UsedDiskSpaceNSXT TransportNode Used Disk SpaceUsagekilobytes2.0.0NSXT TransportNode Used Disk Space.
nsxt_transportnode_UsedMemoryNSXT TransportNode Used MemoryUsagemegabytes2.0.0Amount of memory used by a Transport Node.
nsxt_transportnodes_DegradedCountNSXT TransportNodes Degraded CountAvailabilitycount2.0.0The number of transport nodes in DegradedState.
nsxt_transportnodes_DownCountNSXT TransportNodes Down CountAvailabilitycount2.0.0The number of transport nodes are down.
nsxt_transportnodes_UnknownStateCountNSXT TransportNodes Unknown State CountAvailabilitycount2.0.0The number of transport nodes in Unknown State.
nsxt_transportnodes_UpCountNSXT TransportNodes Up CountAvailabilitycount2.0.0The number of transport nodes are running.
nsxt_transportNode_BfdAdministrativeDownCountNSXT TransportNode BFD Administrative Path Down CountAvailabilitycount2.0.0Returns BFD Administrative Path Down Count
NsxT Transport Zonensxt_transportzone_DegradedCountNSXT TransportZone Degraded CountAvailabilitycount2.0.0The number of transport zones in DegradedState.
nsxt_transportzone_DownCountNSXT TransportZone Down CountAvailabilitycount2.0.0The number of transport zones are down.
nsxt_transportzone_LogicalSwitchesCountNSXT TransportZone LogicalSwitches CountAvailabilitycount2.0.0The number of logicalswitches associated with a transportzone.
nsxt_transportzone_TransportNodeCountNSXT TransportZone TransportNode CountAvailabilitycount2.0.0The number of transportnodes associated with a transportzone
nsxt_transportzone_UnknownStateCountNSXT TransportZone Unknown CountAvailabilitycount2.0.0The number of transport zones in Unknown State.
nsxt_transportzone_UpCountNSXT TransportZone Up CountAvailabilitycount2.0.0The number of transport zones are running.
nsxt_transportzones_LogicalSwitchCountNSXT TransportZones Logical Switch Countcount2.0.0The number of Logical Switches associated with a transport zone
nsxt_transportzones_TransportNodeCountNSXT TransportZones TransportNode Countcount2.0.0The number of transportnodes. both HostNode and EdgeNode associated with a transportzone
nsxt_transportzones_UpCountNSXT TransportZones Up Countcount2.0.0The number of transport zones in Up(Running) state
nsxt_transportzones_DownCountNSXT TransportZones Down Countcount2.0.0The number of transport zones in Down state
nsxt_transportzones_DegradedCountNSXT TransportZones Degraded Countcount2.0.0The number of transport zones in Degraded State
nsxt_transportzones_UnknownStateCountNSXT TransportZones Unknown State Countcount2.0.0The number of transport zones in Unknown State
NsxT Virtual Machinensxt_virtualmachines_StatussNSXT VirtualMachine StatusAvailability2.0.0VirtualMachine Status.

Possible values: VM_Running, VM_Stopped
NsxT Logical Routernsxt_logicalrouter_BGP_neighbor_connection_StateNSXT LogicalRouter BGP Neighbor Connection State2.0.0Current state of the BGP session.

Possible values 0-UNKNOWN, 1-INVALID, 2-IDLE, 3-CONNECT, 4-ACTIVE, 5-OPEN_SENT, 6-OPEN_CONFIRM, 7-ESTABLISHED.
nsxt_logicalrouter_BGP_neighbor_established_connection_CountNSXT LogicalRouter BGP Neighbor Established Connection Countcount2.0.0Count of connections established.
nsxt_logicalrouter_BGP_neighbor_connection_drop_CountNSXT LogicalRouter BGP Neighbor Connection Drop Countcount2.0.0Count of connection drop.
nsxt_logicalrouter_StatusNSXT LogicalRouter Status6.0.0Overall state of desired configuration. The success states are NODE_READY and TRANSPORT_NODE_READY, pending states are {VM_DEPLOYMENT_QUEUED, VM_DEPLOYMENT_IN_PROGRESS, REGISTRATION_PENDING} and other values indicate failures.in_sync state indicates that the desired configuration has been received by the host to which it applies, but is not yet in effect. When the configuration is actually in effect, the state will change to success. Please note, failed state is deprecated. Possible values 0-SUCCESS, 1-IN_PROGRESS, 2-ERROR, 3-UNINITIALIZED, 4-UP, 5-DOWN, 6-UNKNOWN, 7-IN_SYNC, 8-PENDING, 9-FAILURE
nsxt_logicalrouter_HA_ModeNSXT LogicalRouter HA Mode6.0.0Logical Router High availability mode. Possible values 0-ACTIVE_ACTIVE, 1-ACTIVE_STANDBY, 2-DISTRIBUTED ONLY

Application Migration

  1. Check for the gateway version as a prerequisite step - classic gateway-12.0.1 and above.
    Notes:

    • You only have to follow these steps when you want to migrate from sdk 1.0 to sdk 2.0.
    • For the first time installation below steps are not required.
  2. Disable all configurations associated with sdk 1.0 adaptor integration application.

  3. Install and Add the configuration to that sdk 2.0 application.
    Note: refer to Configure and Install the VMware NSX-T Integration & View the VMware NSX-T Details sections of this document.

  4. Once all discoveries are completed with the sdk 2.0 application, follow any one of the approaches.

    • Direct uninstallation of the sdk 1.0 adaptor application through the uninstall API with skipDeleteResources=true in the post request

      End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}

      Request Body:
          {
          "uninstallReason": "Test",
          "skipDeleteResources": true
          }


      (OR)

    • Delete the configuration one by one through the Delete adaptor config API with the request parameter as skipDeleteResources=true

      End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/config/{configId}?skipDeleteResources=true.

    • Finally, uninstall the adaptor application through API with skipDeleteResources=true in the post request.

      End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}

      Request Body:
          {
          "uninstallReason": "Test",
          "skipDeleteResources": true
          }

Default Monitoring Configurations

VMware-NSX-T has default Global Device Management Policies, Global Templates, Global Monitors and Global Metrics in OpsRamp. You can customize these default monitoring configurations as per your business requirement by cloning respective Global Templates and Global Device Management Policies. It is recommended to clone them before installing the application to avoid noise alerts and data.

  1. Default Global Device Management Policies

    You can find the Device Management Policy for each Native Type at Setup > Resources > Device Management Policies. Search with suggested name in global scope. Each Device Management Policy follows below naming convention:

    {appName nativeType - version}

    Ex: vmware-nsx-t NsxT Manager Cluster - 2 (i.e, appName = vmware-nsx-t, nativeType = NsxT Manager Cluster, version = 2)

  2. Default Global Templates

    You can find the Global Templates for each Native Type at Setup > Monitoring > Templates. Search with suggested names in global scope. Each template follows below naming convention:

    {appName nativeType 'Template' - version}

    Ex: vmware-nsx-t NsxT Manager Cluster Template - 2 (i.e, appName = vmware-nsx-t, nativeType = NsxT Manager Cluster, version = 2)

  3. Default Global Monitors

    You can find the Global Monitors for each Native Type at Setup > Monitoring > Monitors. Search with suggested name in global scope. Each Monitors follows below naming convention:

    {monitorKey appName nativeType - version}

    Ex: NsxT Manager Cluster Monitor vmware-nsx-t NsxT Manager Cluster 2 (i.e, monitorKey = NsxT Manager Cluster Monitor, appName = vmware-nsx-t, nativeType = NsxT Manager Cluster, version = 2)

Configure and Install the VMware NSX-T Integration

  1. From All Clients, select a client.
  2. Navigate to Setup > Account.
  3. Select the Integrations tab.
  4. The Installed Integrations page, where all the installed integrations are displayed. Click + ADD on the Installed Integrations page.
  5. If you do not have any installed applications, you will be navigated to the Available Integrations page. The Available Integrations page displays all the available applications along with the newly created application with the version.
    Note: Search for the application using the search option available. Alternatively, use the All Categories option to search.
  6. Click ADD in the VMware NSX-T application.
    Note: Select the version from the drop down menu.
  7. In the Configurations page, click + ADD. The Add Configuration page appears.
  8. Enter the following BASIC INFORMATION:
FunctionalityDescription
NameEnter the name for the configuration.
NSX-T Manager IP AddressIP address of the target.
PortPort
Example: By default 443 is the port value
CredentialSelect the credentials from the drop-down list.
Note: Click + Add to create a credential.

Notes:

  • By default the Is Secure checkbox is selected.
  • NSX-T Manager IP Address and Port should be accessible from Gateway.
  • Select the following:
    • App Failure Notifications: If turned on, you will be notified in case of an application failure that is, Connectivity Exception, Authentication Exception.
    • Event/Alert Polling: Enables integrating third party alerts into OpsRamp using further configurations.
      • Below are the default values set for:
        • Alert On Root Resource: Alerts generated by on root resource, when checked.
          • Event/Alert Cleared Status: Possible values of Event/Alert Cleared Status configuration property are “ACKNOWLEDGED”,“SUPPRESSED”,“RESOLVED”.
          • Event/Alert Severity: Possible values of Event/Alert Severity configuration property are “CRITICAL”,“HIGH”,“MEDIUM”,“LOW”.
          • Event/Alert Severity Mapping: Possible values of Event/Alert Severity Mapping Filter configuration property are “CRITICAL”:“Critical”,“HIGH”:“Warning”,“MEDIUM”:“Warning”,“LOW”:“Info”.
    • API Timeouts: These are the maximum API Timeouts that the application can use to connect and get responses from the end device.
      • Connection Timeout in Secs: a time period in which a client should establish a connection with a server.
        Note: By default, 60 is selected.
      • Connection Request Timeout in Secs: a time period required to process an HTTP call: from sending a request to receiving a response.
        Note: By default, 10 is selected.
      • Socket Timeout in Secs: a maximum time of inactivity between two data packets when exchanging data with a server.
        Note: By default, 10 is selected.
  1. Select the following Custom Attribute:
FunctionalityDescription
Custom AttributeSelect the custom attribute from the drop down list box.
ValueSelect the value from the drop down list box.

Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).

  1. In the RESOURCE TYPE section, select:
    • ALL: All the existing and future resources will be discovered.
    • SELECT: You can select one or multiple resources to be discovered.
  2. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  3. Click ADD.

Now the configuration is saved and displayed on the configurations page after you save it. From the same page, you may Edit and Remove the created configuration.

  1. Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.

    Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.

  2. Click NEXT.

  3. (Optional) Click +ADD to create a new collector by providing a name or use the pre-populated name.

Veeam
  1. Select an existing registered profile.
Veeam
  1. Click FINISH.

The application is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.

Modify the Configuration

View the VMware NSX-T Details

To discover resources for VMware NSX-T

  1. Navigate to Infrastructure > Search > Software Defined Network > VMware NSX-T.
  2. The VMWARE NSX-T page is displayed, select the application name.
  3. The RESOURCE DETAILS page appears from the right.
  4. Click the ellipsis () on the top right and select View details.
  5. Navigate to the Attributes tab to view the discovery details.
  • Click the Metrics tab to view the metric details for VMware NSX-T.

Resource Filter Input Keys

VMware NSX-T application resources are filtered and discovered based on below keys:

Click here to view the Supported Input Keys
Resource TypeSupported Input Keys
All TypesresourceName
hostName
aliasName
dnsName
ipAddress
macAddress
os
make
model
serialNumber
NsxT Logical RouterRouter Type
NsxT Transport NodeTransport Node Type
NsxT Edge Physical Network InterfaceMTU
Physical Address
NsxT Host Physical Network InterfaceMTU
Physical Address
NsxT Virtual MachineVM Type

Supported Alert Custom Macros

Customize the alert subject and description with below macros then it will generate alert based on customisation.
Supported macros keys:

Click here to view the alert subject and description with macros

                                ${resource.name}

                                ${resource.ip}

                                ${resource.mac}

                                ${resource.aliasname}

                                ${resource.os}

                                ${resource.type}

                                ${resource.dnsname}

                                ${resource.alternateip}

                                ${resource.make}

                                ${resource.model}

                                ${resource.serialnumber}

                                ${resource.systemId}

                                ${Custome Attributes in the resource}

                                ${parent.resource.name}

Risks, Limitations And Assumptions

  • Application can handle Critical/Recovery failure notifications for below two cases when user enables App Failure Notifications in configuration
    • Connectivity Exception
    • Authentication Exception
  • Application will send any duplicate/repeat failure alert notification for every 6 hours.
  • The unique ID for the firewall has been changed from the Manager API to the Policy API. Consequently, during the migration of NSX-T devices from manager to policy mode, existing firewalls created using the Manager API will be removed, and new firewalls utilizing the Policy API will be created.
  • Application cannot control monitoring pause/resume actions based on above alerts. Metrics can be used to monitor the resources and can generate alerts based on the threshold values.
  • vmware-nsx-t Event/Alert polling will be started only if the user enables Event/Alert Polling in configuration.
    Notes:
    • Here Event/Alert polling support is given for vmware-nsx-t Alarms only.
    • When a status value which presents in Event/Alert Cleared Status field occurs, OpsRamp will create an Ok alert accordingly. Otherwise, OpsRamp will create an alert based on Event/Alert Severity Filter & Event/Alert Severity Mappings of the Event/Alert Polling configurations.
  • Application will publish event polling alerts on root resource if Alert on root resource is checked in the configuration, else alert will be published on respective resource.
  • Default values of Event/Alert Cleared Status configuration field are: ACKNOWLEDGED, SUPPRESSED, RESOLVED.
  • Possible vmware-nsx-t status values are OPEN, ACKNOWLEDGED, SUPPRESSED, RESOLVED.
  • Default/Possible values of Event/Alert Severity Filter configuration are CRITICAL, HIGH, MEDIUM, LOW.
  • We have provided default mappings to map vmware-nsx-t Severity with OpsRamp Severities as part of Event/Alert Severity Mapping configuration.
  • Users can modify them as per their use-case at any point of time from the application configuration page. Possible OpsRamp Severities are Critical, Warning, Ok, Info.
  • No support of showing activity logs.
  • The Template Applied Time will only be displayed if the collector profile (Classic and NextGen Gateway) is version 18.1.0 or higher.
  • This application supports both Classic Gateway and NextGen Gateway.
  • Below are the possible reasons for tunnel status related metrics of Transport Node can go missing:
    • Transport nodes which are connected to only VLAN transport zones wont have tunnel status metrics.
    • Tunnels are not setup when no NSX backed/ overlay VM is connected to the host.
    • BFD module could be errored and wiped all BFD tunnel related information.
      Transport node tunnel status related metrics nsxt_transportNode_TunnelStatus nsxt_transportNode_TunnelUpCount nsxt_transportNode_TunnelDownCount nsxt_transportNode_BfdAdminDownCount nsxt_transportNode_BfdDownCount nsxt_transportNode_BfdInitCount nsxt_transportNode_BfdUpCount nsxt_transportNode_BfdNoDiagnosticCount nsxt_transportNode_BfdControlDetectionTimeExpiredCount nsxt_transportNode_BfdEchoFunctionFailedCount nsxt_transportNode_BfdForwardPlaneResetCount nsxt_transportNode_BfdPathDownCount nsxt_transportNode_BfdConcatenatedPathDownCount nsxt_transportNode_BfdAdministrativeDownCount nsxt_transportNode_BfdReverseConcatenatedPathDownCount nsxt_transportNode_BfdNeighbourSignalledSessionDownCount
  • Latest snapshot metric support from Gateway 14.0.0.

Troubleshooting

Before troubleshooting, ensure all prerequisites prerequisites are met.

If VMware NSX-T integrations fails to discover or monitor, troubleshoot using the following steps:

  • Check if any alerts have been generated on the NSX-T resource or gateway, or if there are any error logs in vprobe.
  • If there is an error or alert related to the end device connectivity or authentication, try checking the reachability of the end device from the gateway with the following commands:
    • to ping the IP address provided in the configuration: {ping <IP Address>}
    • to try telnet: {telnet <IP Adress> <Port>}
    • To run an API:
      • Prepare the request payload by using below sample request: { “apiVersion”: “debug/v1”, “module”: “Debug”, “app”: “poly-trio”, “action”: “Reachability”, “payload”: { “ipAddressOrHostName”: “”, “protocol”: “https”, “port”: 443, “requestPath”: “”,

        “version”:“v1”,

        “requestMethod”:"<get/post>", “userName”: “”, “password”: “” } }

      • Encode the request payload to base64

      • Log in to the gateway concole and connect to the GCLI terminal using the below command: {## gcli}

      • Run the command using the previously generated base64 encoded string {## sdkappdebug <base64 encoded string>}

Version History

Application VersionBug fixes / Enhancements
10.0.1Bug fix related to disk space metrics.
10.0.0added new metric support nsxt_manager_DiskSpaceUsed, nsxt_manager_DiskSpaceTotal, nsxt_manager_DiskSpaceUtilization under NsxT Manager native type
9.0.2Resource deletion issue fix.
9.0.1Capturing Error Log Details whenever Edge Cluster Status was Degraded State.
Click here to view the earlier version updates
Application VersionBug fixes / Enhancements
9.0.0Support for Deprecated Manager API's with Alternative Policy API's
8.0.0
  • New interface statistics metric support for native types NsxT Edge Physical Network Interface and NsxT Host Physical Network Interface.
  • IPV4 validation for IP Address and VM Type as custom attribute for NsxT Virtual Machine.
7.0.0
  • Support for NSX-T Virtual Machine IpAddress, make, model.
  • Support for NSX-T Manager Host Name.
  • Updated metric units to GB for metrics nsxt_logicalswitch_TotalTransmittedBytes, nsxt_logicalswitch_TotalReceivedBytes
  • Updated metric instance to neighbor IpAddress for NSX-T Logical Router bgp neighbor metric (nsxt_logicalrouter_BGP_neighbor_connection_State, nsxt_logicalrouter_BGP_neighbor_established_connection_Count, nsxt_logicalrouter_BGP_neighbor_connection_drop_Count)
6.0.0Added nsxt_logicalrouter_Status, nsxt_logicalrouter_HA_Mode metric support for NsxT Logical Router
5.1.0
  • Flexibility to publish event polling alert on root resource or other respective resources based on Alert on root resource option provided in configuration UI.
  • Added resource name for NsxT Manager.
5.0.2
  • Code fix to use OVERLAY Transport Zone ID to fetch tunnel status for Transport Nodes.
  • Support for reoccurrence of alerts.
5.0.1
  • NSX-T API optimization.
  • Throttling code support for handling status code 429 too many request.
  • Bug fix to avoid duplicate alerts in OpsRamp.
5.0.0
  • Data point conversion enabled.
  • Updated NSX-T Manager Discovery and monitoring API.
  • Root native type and display order changes in Infrastructure resource page.
  • VMware NSX-T subcategory modified as Network Security.
4.1.1Bug fix to retry after waiting for 30sec in case of App Failure exceptions.
4.1.0
  • Bug fixes and API timeout checkbox added in the app configuration page.
  • Added metric label support.
  • Missing component alerts support added.
4.0.2Support added to map nsx-t manager cluster resource IP.
4.0.1Full discovery support added.
4.0.0
  • Enhanced app failure notification sending feature for ServiceUnavailableException, RequestTimeoutException, SocketTimeoutException.
  • API statistics metric support added with the display name - “NSX-T Statistics”.
  • Added NSX-T API retry mechanism with 2secs delay to address API throttling.
3.0.1
  • Added support to collect OS details for NSX-T VM resources.
  • Macro replacement in the threshold breach alert subject & descriptions.
3.0.0Added support to process NSX-T alarms into OpsRamp.
2.0.1Enhanced application failure notification sending feature.
2.0.0Initial SDK2.0 application Discovery and Monitoring Implementations.