Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


Viewing Topology Maps from Contrail Command

You can view heatmaps from the Infrastructure > Fabrics > Fabric Name > Topology View page.

The Topology View feature helps visualize the heatmaps generated based on the metrics collected through sources such as sFlows and SNMP. You can select a time range from the Summary section on the left panel to view the network statistics during a specific time period.

The metrics are represented in color and with a temperature scale displayed on the right of the topology as shown in Figure 1. The maximum numeric value retrieved for the metric among all possible nodes or edges are represented as red on the scale. The lowest possible value, 0 (zero), is represented as Green. The color gradation is from Red to Green with Yellow at 50%. For metrics represented in percentages, the maximum (100%) is represented as Red, yellow is 50% and green is 0%. For a node, the heat color is based on the maximum of the sum of either ingress or egress traffic.

Figure 1: Topology ViewTopology View

Figure 1 shows the Bytes/sec metric to visualize the heatmap. The temperature scale on the right indicates that 34 Kb/sec is the maximum rate discovered among all devices and is color coded in red. The lowest value is 0 Bytes/sec, which is shown as green. You can hover on the edge devices or nodes to view the actual values as shown in Figure 2.

Figure 2: Edge Devices Heatmap MetricEdge Devices Heatmap Metric

The node color for a7-ex2 is based on the values of the maximum of sum of ingress versus the egress traffic.

For example, in Figure 3, the sum of egress traffic is 13.32 KB/sec and ingress is traffic is 12.30 KB/sec. Hence, for this node, the traffic is shown as 13.21 KB/sec and is marked red. This is because this value is close to the maximum values obtained from all the links and the nodes.

Figure 3: Node Heatmap MetricNode Heatmap Metric

Figure 4 shows the sample traffic data collected and provided by the Contrail Insights Flows API.

Figure 4: Sample Traffic from Contrail Insights Flows APISample Traffic from Contrail Insights Flows API

Table 1 describes the metrics, its source, and the method of calculation.

Table 1: Metrics and Its Source



Calculation Method


sFlow / Contrail Insights Flows

Calculated by dividing the sum of bytes by time range in seconds.


sFlow / Contrail Insights Flows

Calculated by dividing the sum of packets by time range in seconds.


sFlow / Contrail Insights Flows

Utilization is % of link capacity used and is calculated based on the link capacity. The total utilization divided by time range in seconds is used to show average utilization over the time range.

Host/Instances—All host and instances metrics collected by Contrail Insights.

Memory Usage

Contrail Insights


CPU Usage

Contrail Insights


Disk I/O Read

Contrail Insights


Disk I/O Write

Contrail Insights


Ingress Errors

Contrail Insights


Egress Errors

Contrail Insights


Ingress Drops

Contrail Insights


Egress Drops

Contrail Insights


User SNMP Metrics

Contrail Insights

All the SNMP metrics collected by Contrail Insights.

For Contrail Insights to collect SNMP data, you need to configure SNMP and select IFMIB.

For more information, see Metrics Collected by Contrail Insights.


Clicking on a node or edge device filters data for the selected connection, network device, host, instance, or baremetal server. You can select the filter criteria from the Heatmap parameters section on the right pane. You can apply multiple filters at a time.

Table 2: Filter Parameters



Source Virtual Network

Filter traffic data for a particular source virtual network.

Destination Virtual Network

Filter traffic data for a particular destination virtual network.

Network Device

Filter traffic for the selected network device.


Filter traffic data for the selected host or node instance.

Source Interface

Filter traffic for the selected source interface.

Destination Interface

Filter traffic for the selected destination interface.