Cisco ACI
Introduction
Cisco Application Centric Infrastructure (ACI) is a policy-driven SDN fabric built on Nexus 9000 switches and managed via APIC.
Getting Started
Compatibility
Cisco ACI O11ySource supports SNMP versions v1, v2c and v3.
Data Collection Method
Cisco ACI fabric nodes support SNMP, Syslog, streaming telemetry (eAPI/gNMI/sFlow), and CLI-based monitoring to collect interface, CPU/memory, environmental sensor, QoS, and forwarding/ASIC counters for seamless integration with NMS, SIEM, and observability platforms.
Prerequisites
Dependent Configuration
To configure this O11ySource, create a 'credential' of type 'snmp' under the 'Definition' tab.
Inputs for Configuring Data Source
- Group Name: This field is for grouping devices for SNMP polling, making it easier to manage devices with common characteristics or within the same network segment.
- Number of Retries: Number of times the system should reattempt polling if the initial attempt fails. Default is set to 7 retries
- Timeout Duration: Specify how long the system should wait for a response from a device before considering the attempt unsuccessful. Default timeout is 5 seconds
- Device: Details needed to collect health data from the devices using SNMP
- Device IP: Enter the IP address of the device.
- SNMP Credential: Select the SNMP credential from the dropdown list that corresponds to this device.
- Vendor: Select the vendor of the device from the dropdown list
- Model: Select the model of the device from dropdown list.
- MIB Groups: Define what MIBs to be queried and how often
- MIB Group: Default: 'ALL_SUPPORTED_MIB_GROUPS'.
- Interval: Default: 360 seconds
Applications
Firewall Requirement
To collect data from this O11ySource, ensure the following ports are opened:
| Source IP | Destination IP | Destination Port | Protocol | Direction |
|---|---|---|---|---|
| vuSmartMaps IP | IP address of the SNMP device | 161* | UDP | Outbound |
*Before providing the firewall requirements, please update the port based on the customer environment.
Configuring the Target
Configure SNMP on Cisco ACIes and grant SNMP access permissions to vuSmartMaps designated IP address.
Configuration Steps
Enablethe O11ySource.- Select the sources tab and press the
+button to add a new instance that has to be monitored. - Provide the required configurations:
- *Resource Name
- *Period (in seconds)
- *Credential
- *Resource ID
- Click
Saveto close the data source window.
Metrics Collected
| Name | Description | Data Type |
|---|---|---|
| @timestamp | Timestamp string | String |
| timestamp | Timestamp with precision | DateTime64 |
| bu_id | Business unit ID | LowCardinality(String) |
| tenant_id | Tenant ID | LowCardinality(String) |
| host | Host IP Address | IPv4 |
| target | Target system | String |
| DeviceIP | Device IP Address | IPv4 |
| data_type | Type of data | LowCardinality(String) |
| type | Event type | LowCardinality(String) |
| vendor_name | Vendor name | LowCardinality(String) |
| device_type | Device type | LowCardinality(String) |
| period | Time period | Int32 |
| system_name | System name | String |
| name | Name of the object | String |
| index | Index value | String |
| vublock_name | VuBlock Name | String |
| topic_of | Topic associated | String |
| CPU Name | CPU Name | LowCardinality(String) |
| Uptime in seconds | System Uptime in Seconds | Float64 |
| CPU Utilization | CPU utilization per logical processor (hrProcessorLoad) | Float64 |
| Memory Used Bytes | Used memory in pool | UInt64 |
| Memory Free Bytes | Free memory in pool | UInt64 |
| Memory Utilization | Memory utilization percentage (derived) | Float64 |
| Memory Total KB | Total real memory | UInt64 |
| Memory Available KB | Available real memory | UInt64 |
| Disk Total Units | Total storage size (allocation units) | UInt64 |
| Disk Used Units | Used storage (allocation units) | UInt64 |
| Disk Allocation Unit Bytes | Allocation unit size in bytes | UInt64 |
| Disk Used Percentage | Disk usage percentage (derived or UCD) | Float64 |
| System Uptime (sysUpTime) | System uptime timeticks (sysUpTimeInstance) | UInt64 |
| Filesystem Description | Filesystem description (hrStorageDescr) | String |
| Filesystem Total Units | Total filesystem size (allocation units) | UInt64 |
| Filesystem Used Units | Used filesystem space (allocation units) | UInt64 |
| Filesystem Allocation Unit Bytes | Allocation unit size in bytes | UInt64 |
| Filesystem Used Percentage | Filesystem usage percentage (derived) | Float64 |
| Hardware Operational Status | Physical component status (entPhysicalOperStatus) | Int32 |
| Temperature Value | Temperature reading | Float64 |
| Fan State | Fan status | Int32 |
| PSU State | Power supply status | Int32 |
| temperature_c | Temperature reading | Float64 |
| temperature_valid | Temperature validation | UInt64 |
| node_role | Indicates whether the device is a Leaf or Controller node | LowCardinality(String) |
| cpu_util_5s_p | CPU utilization per logical processor (leaf) | Float64 |
| cpu_util_1m_p | CPU utilization per logical processor (leaf) | Float64 |
| cpu_util_5m_p | CPU utilization per logical processor (leaf) | Float64 |
