SevOne SDN Collector Variables & Report Linking Usage Guide

About

This document provides guidelines on how different reports can be linked and variables that can be applied.

Variables

Report A → Report B

Variables	Description/Usage
Devices	As per SDN model, Pods, Leaves, Spines, Controllers, VMS, Hypervisors are saved as Devices. If devices are selected in the Report A and would like to link the report on Device Name then, Report B must have the Devices variable.
Objects	As per SDN model, ACI Storage, ACI APIC, ACI OS, ACI physical interfaces are saved as Objects. If you want to link Report A to Report B, Report B must have the Objects variable.
Indicator	As per SDN model, EP, BD, and VRF are saved as Indicators. If you want to link Report A to Report B, Report B must have the Indicator variable.

Warning: Example: Report Linking Requirement
Purpose : To propagate data variable query from Report A to Report B, link the reports. For example, Report A > Link To > Report B.

Solution: If a report is the child (linked) report, for example, Report B, then variables mentioned under Variables column, in tables below, are mandatory.

Prerequisites

Edit online

Prior to executing the scenarios defined below, the following reports must be created.

SDN Capacity
SDN Mapping
SDN Logical Topology
SDN Controller Status
SDN Fault Messages
TopN Heatmap (Deprecated)

Applicable Variables

Edit online

Widgets / Variables	Device	Device Groups	Object	Time zone	Time span
SDN Capacity		Yes		Yes	Yes
SDN Mapping	Yes
SDN Logical Topology	Yes
SDN Controller Status	Yes
SDN Fault Messages			Yes
TopN Heatmap (Deprecated)				Yes	Yes

Important: TopN Heatmap widget supports the following timespan options.

Today
Yesterday
Past 2-hours
Past 4-hours
Past 8-hours
Past 24-hours

SDN Capacity

Edit online

The SDN Capacity widget displays data for the ACI Capacity or ACI Switch Capacity of the device you select.

ACI capacity

Edit online

Variables	Column Name	Reports to Link
Edit Report > Add Variables > Device Groups > Single selection > Choose Device Groups	POD Device Name	SDN Fault Messages, SDN Mapping, SDN Logical Topology Alert Details, Flow, Group Metrics, Metadata, Performance Metrics (must have Devices variable)
	End Points, Bridge Domains, Tenants, EndPoint Groups, L4L7 Devices, L4L7 Graphs, Hypervisors, Virtual Machines, Virtualization Ratio	IPSLA, Performance Metrics (must have Indicator variable)

ACI Switch Capacity

Edit online

Variables	Column Name	Reports to Link
Edit Report > Add Variables > Device Groups > Single selection > Choose Device Groups	Object	SDN Fault Messages Alert Details, Flow, Group Metrics, Metadata, Performance Metrics (must have Objects variable)
	POD Device Name	SDN Fault Messages, SDN Mapping, SDN Logical Topology Alert Details, Flow, Group Metrics, Metadata, Performance Metrics (must have Devices variable)
	Switch Name	SDN Fault Messages Alert Details, Flow, Group Metrics, Metadata, Performance Metrics (must have Devices variable)
	VRF, BD, EPG, MAC, IPv4, IPv6, Multicast, Policy CAM, VLAN	IPSLA, Performance Metrics (must have Indicator variable)

SDN Mapping

Edit online

The SDN Mapping widget provides the ability to view the logical relationships between tenant endpoint groups, endpoints, and the physical infrastructure (VM affiliation, VLAN, switch, and switch port).

Variables	Column Name	Reports to Link
Edit Report > Add Variables > Devices > Single selection > Choose Devices	Tenant, AP, EPG, Port	SDN Fault Messages Alert Details, Flow, Group Metrics, Metadata, Performance Metrics (must have Objects variable)
	Switch	SDN Logical Topology, SDN Controller Status Alert Summary, Alert Details, Metadata, Performance Metrics (must have Devices variable)

SDN Logical Topology

Edit online

The SDN Logical Topology widget displays Cisco ACI overcloud objects and their interconnections.

Variables	Column Name	Reports to Link
Edit Report > Add Variables > Devices > Single selection > Choose Devices	Tenants, Application Profile, EndPoint Groups, Private Network, Port, BD, EP	SDN Fault Messages Alert Details, Flow, Group Metrics, Metadata, Performance Metrics (must have Objects variable)
	Pod Device	SDN Logical Topology, SDN Controller Status Alert Summary, Alert Details, Metadata, Performance Metrics (must have Devices variable)

SDN Controller Status

Edit online

The SDN Controller Status widget displays the status of the Cisco ACI controllers (APICs).

Variables	Column Name	Reports to Link
Edit Report > Add Variables > Devices > Single selection > Choose Devices	Name	SDN Controller Status Alert Summary, Alert Details, Metadata, Performance Metrics (must have Devices variable)

TopN Heatmap (Deprecated)

Edit online

The TopN Heatmap widget helps you view the heatmap of any given object and indicator for a certain hour on a selected day.

Variables	Column Name	Reports to Link
	Device	SDN Logical Topology, SDN Controller Status Alert Details, Alert Summary, Metadata, Performance Metrics (must have Devices variable)
	Object Description Timespan	SDN Fault Messages Alert Details, Alert Summary, Flow, Group Metrics, Metadata, Performance Metrics (must have Objects variable)

Set Log Rotation

Edit online

To set log rotation, execute the following steps.

Create file /etc/logrotate.d/SDN.
```
$ touch /etc/logrotate.d/SDN
```

Using a text editor of your choice, add the following to /etc/logrotate.d/SDN file and then, save it.


/var/log/<site name provided when adding SDN device>/<v7.0.x>/*/*.log
{
    daily
    missingok
    maxage 30
    rotate 30
    copytruncate
    compress
    delaycompress
    notifempty
}

Execute the following commands to provide read / write access to logrotate.


$ sudo chown -R root:root /var/log/<site name provided when adding SDN device>/<v7.0.x>/

$ sudo chmod -R 755 /var/log/<site name provided when adding SDN device>/<v7.0.x>/

$ sudo find /var/log/<site name provided when adding SDN device>/<v7.0.x>/ -type f -exec chmod 644 {} \;

$ sudo restorecon -Rv /var/log/<site name provided when adding SDN device>/<v7.0.x>/

$ sudo restorecon -Rv /var/lib/logrotate/

$ sudo touch /var/lib/logrotate/logrotate.status

$ sudo chown root:root /var/lib/logrotate/logrotate.status

$ sudo chmod 644 /var/lib/logrotate/logrotate.status