How to Build Port Utilization Charts sub-reports in ENA?

Building sub-reports for Composite Reports in Entuity Network Analytics (ENA)

An Introduction

This article is going to show you an example of building custom reports that can be used as sub-reports for a Composite report in Entuity Network Analytics and provides better control of your network management as you navigating around your network.

What you’ll Learn

  • Port Utilization Charts
  • Sub-reports
  • Composite Reports
  • Entuity Network Analytics
  • Network Management


12 min

I am going to illustrate how a pair of basic reports can be built in readiness for later inclusion in a composite report, which is the subject of a separate tutorial video. There’s a separate dedicated tutorial video explaining how to build a multi chart and table report which covers several concepts. In last example, we have generated one report that displays a chart and table that each Device in a View (Device Metrics Chart and Table). In this example, we will create the second report displaying separate charts for each operational enabled Ports in a View (Port Utilization Charts).

Report Builder

To build a Multi Chart/Table Report, the appropriate template should be selected from the Report Builder, which is available from the Main Menu→ Reports Page. As we have mentioned on the previous blog, there are four different fundamental templates and in this case, you should select the third one Multi chart/table report template.

Port Utilization Charts

To populate the attributes in this report, I will need to drag attributes from another Attributes Dashboard for the device. As we mentioned on the previous blog “How to Build Time Series Chart Reports in ENA“, in order to make that Dashboard available, you have to firstly duplicate this tab in the same browser window then select the Dashboards using the Explorer and select a Device. And finally, choose the Attributes Dashboard over the All Dashboards Menu.

  • As this is going to be a Port basis, you can use the Explorer to navigate to a suitable Port.
  • Then select the Attributes Dashboard from the All Dashboards Menu.
  • Sort the attributes alphabetically to make it easier to find the attributes.
  • Drag the Inbound and Outbound Utilization metrics up to the Builder tab and down to the first and second entry.

Alternatively, you could also try to drag attributes by using two browser windows.

Data Source Selection

In this example, I am going to enable the View mode, and change the default device object type to Ports.

Chart Title

Now I could use the table to display the port description, but I would rather have it included as the chart title I’ve added previously with the device name. I will use the same approach of including the name of the interface description attribute within pound or hash characters. The attributes name is ifDescr, so it would be #ifDescr# to put in the box.
One of the best ways to display the device name in this style of report is to place it into the chart Title which appears in large bold text at the top of each chart. The text is defined in the Chart Title field but I don’t want the static text to be used here. As the title needs to be the actual name of the device, which is decided at runtime, we are going to revise it. Fortunately, there’s an easy way to access the object model of the device directly from this field using the syntax. If I simply want to obtain the value of a device attribute, the name of that attribute can be placed within pound or hash symbols to cause it to be accessed. The attribute that holds the device name is called name so I can simply enter #name#.

Advanced Options

Currently, there’s no filter applied so every Port within the scope of the report will have a chart displayed for it. The filter option needs to be enabled using the Show Advanced Options on the top right of the interface.

I can enter a statement using the storm worth statement language to return true or false to determine whether each Port should have a chart displayed or not. There’s an attribute on a Port called Port Operational Status which would have a value of 1 if the port is operationally up. A test that will return true if that attribute equals 1 can be added like this. The double equals is a test through equality.

Report Format

The same as the previous report, I will disable the generation of the report’s Title Header and removed the Margins down the bottom. I am going to select a small view and preview the result. That looks good to me although there might be a large number of pores, so it might be wise to make the port charts shorter that more can be fitted onto each page.

I am going to adjust the chart height down from the default 240 pixels to 140.


Before I save the report I am going to give it a name and here’s the result in the user-defined reports folder. Now you are ready to build your Composite Report which is the subject of our next blog How to Build a Composite Report in ENA.

ENA Tips:

One point you should remember when you build a report and you’re considered to be its owner, which allows you to modify its configuration at a later date via this icon.

Share This