Skip to technology filters Skip to main content
Dynatrace Hub

Extend the platform,
empower your team.

Popular searches:
Home hero bg
Cisco ACI/APICCisco ACI/APIC
Cisco ACI/APIC

Cisco ACI/APIC

Monitor Cisco ACI fabric and tenants health, performance, faults - through APIC.

Extension
Free trialDocumentation
Cisco ACI fabric dashboardCisco ACI fabric metricsCisco ACI tenants dashboard
  • Product information
  • Release notes

Overview

The Cisco ACI/APIC extension uses the Cisco APIC REST API to monitor the network fabric and tenants managed by Application Policy Infrastructure Controllers (APIC). Running on an ActiveGate, it reports health scores and performance metrics for pods, leaf and spine nodes, controllers, and their interfaces, and for tenants with their application profiles, VRFs, bridge domains, contracts, and endpoint groups (EPGs). It builds the Smartscape topology of the fabric and tenants, and turns ACI faults into log records and Davis problems that open and close with the fault lifecycle on the APIC.

Use cases

  • Fabric health and capacity — track health scores, node and interface status, and leaf resource usage (endpoints, VLANs, TCAM) across pods.
  • Tenant visibility — see health and traffic (unicast, multicast, flood, drop) per tenant, application profile, VRF, bridge domain, and EPG.
  • Fault alerting — get a Davis problem when the APIC raises a fault, closed automatically when it's cleared or acknowledged.
  • Root cause analysis — see network issues in the context of the applications and infrastructure Dynatrace observes.

Get started

You need Cisco APIC 6.0 or later and an ActiveGate that can reach the APIC controllers. On the APIC, create a dedicated read-only user for Dynatrace.

For step-by-step instructions on the installation and configuration on both APIC and Dynatrace sides, please see Cisco ACI/APIC extension in the Dynatrace Documentation.

Details

The Cisco ACI/APIC extension collects metrics, topology, and log data for:

  • Fabric pods, fabric nodes, node systems (spines and leaves), and controller cluster elements
  • L1 physical, management, and controller physical interfaces
  • Tenants, application profiles, private networks (VRFs), bridge domains, contracts, and EPGs
  • ACI faults and, optionally, fault records, in a form of logs and Davis events.

The extension brings fabric and tenant dashboards, Explorer screens in Infrastructure & Operations, and unified analysis pages for Dynatrace Managed.

Dynatrace
Documentation
By Dynatrace
Dynatrace support center
Subscribe to new releases
Copy to clipboard

Feature sets

Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.

Feature setsNumber of metrics included
Metric nameMetric keyDescriptionUnit
Overall Metrics Data Collection Timesfm.cisco.aci.monitor.run.durationTotal duration of all queries to collect data reported as metrics and log recordsSeconds
Metrics Data Collection Errorsfm.cisco.aci.monitor.run.errorIndicates whether an error occurred during the most recent data collection.Count
Paged Data Query Durationsfm.cisco.aci.fetch_class_page.durationDuration of paged queries to collect data reported as metrics and log recordsSeconds
Paged Data Query Errorssfm.cisco.aci.fetch_class_page.errorNumber of errors that occurred during the most recent paged queries to collect data reported as metrics and log recordsCount
Paged Data Count Query Durationsfm.cisco.aci.fetch_class_count.durationDuration of queries to get object counts for paged queriesSeconds
Paged Data Count Query Errorssfm.cisco.aci.fetch_class_count.errorNumber of errors that occurred during the most recent queries to get object counts for paged queriesCount
Object Count Query Durationsfm.cisco.aci.fetch_count_query.durationDuration of queries to get object counts reported as metricsSeconds
Object Count Query Errorssfm.cisco.aci.fetch_count_query.errorNumber of errors that occurred during the most recent queries to get object counts reported as metricsCount
Metric nameMetric keyDescriptionUnit
-com.dynatrace.extension.network_device.sysuptime--
-com.dynatrace.extension.network_device.memory_usage--
-com.dynatrace.extension.network_device.memory_free--
-com.dynatrace.extension.network_device.memory_total--
-com.dynatrace.extension.network_device.memory_used--
-com.dynatrace.extension.network_device.cpu_usage--
-com.dynatrace.extension.network_device.if.status--
-com.dynatrace.extension.network_device.if.bytes_in.count--
-com.dynatrace.extension.network_device.if.bytes_out.count--
Fabric Monitoring Endpoint Statuscisco.aci.apic.statusFabric - Extension Monitoring Endpoint Status. A state metric representing a monitored Fabric endpoint, whose value is always 1 and its dimensions indicate its endpoint configuration details, including how faults are reported (as log records or as Davis events) and the enabled feature sets.State
Metric nameMetric keyDescriptionUnit
-cisco.aci.app_profile.l2_egr_bytes_ag_hist.multicast_cum--
Application Profile Multicast Egress Bytes Ratecisco.aci.app_profile.l2_egr_bytes_ag_hist.multicast_rateApplication Profile - Multicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.app_profile.l2_egr_bytes_ag_hist.unicast_cum--
Application Profile Unicast Egress Bytes Ratecisco.aci.app_profile.l2_egr_bytes_ag_hist.unicast_rateApplication Profile - Unicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.app_profile.l2_ingr_bytes_ag_hist.drop_cum--
Application Profile Ingress Drop Ratecisco.aci.app_profile.l2_ingr_bytes_ag_hist.drop_rateApplication Profile - Ingress Drop Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.app_profile.l2_ingr_bytes_ag_hist.flood_cum--
Application Profile Ingress Flood Ratecisco.aci.app_profile.l2_ingr_bytes_ag_hist.flood_rateApplication Profile - Ingress Flood Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.app_profile.l2_ingr_bytes_ag_hist.multicast_cum--
Application Profile Multicast Ingress Bytes Ratecisco.aci.app_profile.l2_ingr_bytes_ag_hist.multicast_rateApplication Profile - Multicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.app_profile.l2_ingr_bytes_ag_hist.unicast_cum--
Application Profile Unicast Ingress Bytes Ratecisco.aci.app_profile.l2_ingr_bytes_ag_hist.unicast_rateApplication Profile - Unicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.bridge_domain.l2_egr_bytes_ag_hist.multicast_cum--
Bridge Domain Multicast Egress Bytes Ratecisco.aci.bridge_domain.l2_egr_bytes_ag_hist.multicast_rateBridge Domain - Multicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.bridge_domain.l2_egr_bytes_ag_hist.unicast_cum--
Bridge Domain Unicast Egress Bytes Ratecisco.aci.bridge_domain.l2_egr_bytes_ag_hist.unicast_rateBridge Domain - Unicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.drop_cum--
Bridge Domain Ingress Drop Ratecisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.drop_rateBridge Domain - Ingress Drop Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.flood_cum--
Bridge Domain Ingress Flood Ratecisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.flood_rateBridge Domain - Ingress Flood Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.multicast_cum--
Bridge Domain Multicast Ingress Bytes Ratecisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.multicast_rateBridge Domain - Multicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.unicast_cum--
Bridge Domain Unicast Ingress Bytes Ratecisco.aci.bridge_domain.l2_ingr_bytes_ag_hist.unicast_rateBridge Domain - Unicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.endpoint_group.l2_egr_bytes_ag_hist.multicast_cum--
Endpoint Group Multicast Egress Bytes Ratecisco.aci.endpoint_group.l2_egr_bytes_ag_hist.multicast_rateEndpoint Group - Multicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.endpoint_group.l2_egr_bytes_ag_hist.unicast_cum--
Endpoint Group Unicast Egress Bytes Ratecisco.aci.endpoint_group.l2_egr_bytes_ag_hist.unicast_rateEndpoint Group - Unicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.drop_cum--
Endpoint Group Ingress Drop Ratecisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.drop_rateEndpoint Group - Ingress Drop Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.flood_cum--
Endpoint Group Ingress Flood Ratecisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.flood_rateEndpoint Group - Ingress Flood Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.multicast_cum--
Endpoint Group Multicast Ingress Bytes Ratecisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.multicast_rateEndpoint Group - Multicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.unicast_cum--
Endpoint Group Unicast Ingress Bytes Ratecisco.aci.endpoint_group.l2_ingr_bytes_ag_hist.unicast_rateEndpoint Group - Unicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.private_network.l2_egr_bytes_ag_hist.multicast_cum--
Private Network Multicast Egress Bytes Ratecisco.aci.private_network.l2_egr_bytes_ag_hist.multicast_ratePrivate Network - Multicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.private_network.l2_egr_bytes_ag_hist.unicast_cum--
Private Network Unicast Egress Bytes Ratecisco.aci.private_network.l2_egr_bytes_ag_hist.unicast_ratePrivate Network - Unicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.private_network.l2_ingr_bytes_ag_hist.drop_cum--
Private Network Ingress Drop Ratecisco.aci.private_network.l2_ingr_bytes_ag_hist.drop_ratePrivate Network - Ingress Drop Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.private_network.l2_ingr_bytes_ag_hist.flood_cum--
Private Network Ingress Flood Ratecisco.aci.private_network.l2_ingr_bytes_ag_hist.flood_ratePrivate Network - Ingress Flood Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.private_network.l2_ingr_bytes_ag_hist.multicast_cum--
Private Network Multicast Ingress Bytes Ratecisco.aci.private_network.l2_ingr_bytes_ag_hist.multicast_ratePrivate Network - Multicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.private_network.l2_ingr_bytes_ag_hist.unicast_cum--
Private Network Unicast Ingress Bytes Ratecisco.aci.private_network.l2_ingr_bytes_ag_hist.unicast_ratePrivate Network - Unicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.tenant.l2_egr_bytes_ag_hist.multicast_cum--
Tenant Multicast Egress Bytes Ratecisco.aci.tenant.l2_egr_bytes_ag_hist.multicast_rateTenant - Multicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.tenant.l2_egr_bytes_ag_hist.unicast_cum--
Tenant Unicast Egress Bytes Ratecisco.aci.tenant.l2_egr_bytes_ag_hist.unicast_rateTenant - Unicast Egress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.tenant.l2_ingr_bytes_ag_hist.drop_cum--
Tenant Ingress Drop Ratecisco.aci.tenant.l2_ingr_bytes_ag_hist.drop_rateTenant - Ingress Drop Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.tenant.l2_ingr_bytes_ag_hist.flood_cum--
Tenant Ingress Flood Ratecisco.aci.tenant.l2_ingr_bytes_ag_hist.flood_rateTenant - Ingress Flood Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.tenant.l2_ingr_bytes_ag_hist.multicast_cum--
Tenant Multicast Ingress Bytes Ratecisco.aci.tenant.l2_ingr_bytes_ag_hist.multicast_rateTenant - Multicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
-cisco.aci.tenant.l2_ingr_bytes_ag_hist.unicast_cum--
Tenant Unicast Ingress Bytes Ratecisco.aci.tenant.l2_ingr_bytes_ag_hist.unicast_rateTenant - Unicast Ingress Bytes Rate in a 15 minute sampling intervalBytePerSecond
Metric nameMetric keyDescriptionUnit
Global pcTagcisco.aci.apic.global_pc_tagsFabric Capacity - Global pcTagCount
MAC Endpointscisco.aci.apic.global_mac_endpointsFabric Capacity - MAC EndpointsCount
IPv6 Endpointscisco.aci.apic.global_ipv6_endpointsFabric Capacity - IPv6 EndpointsCount
IPv4 Endpointscisco.aci.apic.global_ipv4_endpointsFabric Capacity - IPv4 EndpointsCount
Proxy Database Entriescisco.aci.apic.global_proxy_db_entriesFabric Capacity - MAC + IP EndpointsCount
Fabric Health AVGcisco.aci.apic.health_avgFabric Health AVG in a 5 minute sampling intervalUnspecified
Fabric Health MAXcisco.aci.apic.health_maxFabric Health MAX in a 5 minute sampling intervalUnspecified
Fabric Health MINcisco.aci.apic.health_minFabric Health MIN in a 5 minute sampling intervalUnspecified
Fabric Total Health Scorecisco.aci.apic.health_totalFabric Total Health ScoreUnspecified
Admin State (in-service)cisco.aci.cluster_element.admin_state_in_serviceCluster Element - Admin State of the cluster is: in-serviceState
Health State (fully-fit)cisco.aci.cluster_element.health_fully_fitController - Health State is: fully-fitState
Operational State (available)cisco.aci.cluster_element.oper_state_availableController - Operational State is: availableState
Administrative Statecisco.aci.cnw_phys_if.admin_statusController Physical Interface - Administrative StateState
Operational Statuscisco.aci.cnw_phys_if.oper_statusController Physical Interface - Operational StatusState
Admin State (on)cisco.aci.fabric_node.admin_state_onFabric Node - Admin State is: onState
Fabric State (active)cisco.aci.fabric_node.fabric_state_activeFabric Node - Fabric State is: activeState
Fabric Pod Controllerscisco.aci.fabric_pod.controllersFabric Pod - ControllersCount
Fabric Pod Nodescisco.aci.fabric_pod.fabric_nodesFabric Pod - NodesCount
Fabric Health AVGcisco.aci.fabric_pod.health_avgFabric Pod - Fabric Health AVG in a 5 minute sampling intervalUnspecified
Fabric Health MAXcisco.aci.fabric_pod.health_maxFabric Pod - Fabric Health MAX in a 5 minute sampling intervalUnspecified
Fabric Health MINcisco.aci.fabric_pod.health_minFabric Pod - Fabric Health MIN in a 5 minute sampling intervalUnspecified
Fabric Total Health Scorecisco.aci.fabric_pod.health_totalFabric Pod - Fabric Total Health ScoreUnspecified
Fabric Pod Leavescisco.aci.fabric_pod.leavesFabric Pod - LeavesCount
Fabric Pod Spinescisco.aci.fabric_pod.spinesFabric Pod - SpinesCount
Faults by Domaincisco.aci.fault_count.domainFaults by DomainCount
Faults by Typecisco.aci.fault_count.typeFaults by TypeCount
Administrative Statecisco.aci.l1_phys_if.admin_statusPhysical Interface - Administrative StateState
Interface Healthcisco.aci.l1_phys_if.healthPhysical Interface - HealthUnspecified
Operational Statecisco.aci.l1_phys_if.oper_statusPhysical Interface - Operational StateState
Administrative Statecisco.aci.mgmt_if.admin_statusManagement Interface - Administrative StateState
Interface Healthcisco.aci.mgmt_if.healthManagement Interface - HealthPercent
Operational Port Statecisco.aci.mgmt_if.oper_statusManagement Interface - Operational Port StateState
System Health Scorecisco.aci.system.healthSystem - Health ScoreUnspecified
System Health AVGcisco.aci.system.health_avgSystem - System Node Health AVG in a 5 minute sampling intervalUnspecified
System Health MAXcisco.aci.system.health_maxSystem - System Node Health MAX in a 5 minute sampling intervalUnspecified
System Health MINcisco.aci.system.health_minSystem - System Node Health MIN in a 5 minute sampling intervalUnspecified
Total L2 Endpointscisco.aci.system.l2_total_ep_lastLeaf Layer2 usage statistics - Total L2 Endpoints in a 5 minute sampling intervalCount
L2 Endpoints Capacitycisco.aci.system.l2_total_ep_maxLeaf Layer2 usage statistics - L2 Endpoints capacity in a 5 minute sampling intervalCount
L2 Endpoints Usagecisco.aci.system.l2_total_ep_percLeaf Layer2 usage statistics - Total L2 Endpoints divided by L2 Endpoints capacityPercent
TCAMscisco.aci.system.pol_tcamsLeaf Policy entries usage statistics - TCAMs = (Cumulative - Baseline)Count
Policy Usage Capacitycisco.aci.system.pol_tcams_maxLeaf Policy entries usage statistics - Policy Usage CapacityCount
TCAMs Usagecisco.aci.system.pol_tcams_percLeaf Policy entries usage statistics - TCAMs Usage = (Cumulative - Baseline) / CapacityPercent
Policy Usage Baselinecisco.aci.system.pol_usage_baseLeaf Policy entries usage statistics - Policy Usage BaselineCount
Policy Usage Cumulativecisco.aci.system.pol_usage_cumLeaf Policy entries usage statistics - Policy Usage CumulativeCount
System Kernel CPU Utilization AVGcisco.aci.system.proc_sys_cpu_kernel_avgSystem - Kernel CPU Utilization AVGPercent
System Kernel CPU Utilization AVG Lastcisco.aci.system.proc_sys_cpu_kernel_avg_lastSystem - Kernel CPU Utilization AVG LastPercent
System User CPU Utilization AVGcisco.aci.system.proc_sys_cpu_user_avgSystem - User CPU Utilization AVGPercent
System User CPU Utilization AVG Lastcisco.aci.system.proc_sys_cpu_user_avg_lastSystem - User CPU Utilization AVG LastPercent
System Load Average (1 min)cisco.aci.system.proc_sys_load_avgSystem - one-minute load average of the switch operating systemUnspecified
System Load Average (1 min) Lastcisco.aci.system.proc_sys_load_avg_lastSystem - one-minute load average of the switch operating system (last value)Unspecified
System Memory Free Lastcisco.aci.system.proc_sys_mem_free_lastSystem - Memory Free LastKiloByte
System Memory Total Lastcisco.aci.system.proc_sys_mem_total_lastSystem - Memory Total LastKiloByte
System Memory Used Lastcisco.aci.system.proc_sys_mem_used_lastSystem - Memory Used LastKiloByte
System Memory Used % Lastcisco.aci.system.proc_sys_mem_used_perc_lastSystem - Memory Used % LastPercent
System Uptimecisco.aci.system.system_uptimeSystem - UptimeMilliSecond
IPv4 Addressescisco.aci.system.v4_addressesLeaf Layer3 v4/32 total entries usage statistics - IPv4 Addresses = (Cumulative - Baseline)Count
Total v4 Endpoints Capacitycisco.aci.system.v4_addresses_maxLeaf Layer3 total entries usage capacity - Total v4 Endpoints capacity current valueCount
IPv4 Addresses Usagecisco.aci.system.v4_addresses_percLeaf Layer3 v4/32 total entries usage statistics, Leaf Layer3 total entries usage capacity - IPv4 Addresses Usage = (Cumulative - Baseline) / CapacityPercent
Total v4 32 Endpoints Baselinecisco.aci.system.v4_ep_baseLeaf Layer3 v4/32 total entries usage statistics - Total v4 32 Endpoints BaselineCount
Total v4 32 Endpoints Cumulativecisco.aci.system.v4_ep_cumLeaf Layer3 v4/32 total entries usage statistics - Total v4 32 Endpoints CumulativeCount
Total Vlan Entries Baselinecisco.aci.system.vlan_usage_total_baseLeaf Vlan entries usage statistics - Total vlan entries BaselineCount
Total Vlan Entries Cumulativecisco.aci.system.vlan_usage_total_cumLeaf Vlan entries usage statistics - Total Vlan Entries CumulativeCount
Vlanscisco.aci.system.vlan_vlansLeaf Vlan entries usage statistics - Vlans = (Cumulative - Baseline)Count
Vlan Entries Capacitycisco.aci.system.vlan_vlans_maxLeaf Vlan entries usage statistics - Vlan Entries CapacityCount
Vlans Usagecisco.aci.system.vlan_vlans_percLeaf Vlan entries usage statistics - Vlans Usage = (Cumulative - Baseline) / CapacityPercent
Metric nameMetric keyDescriptionUnit
Application Profile Healthcisco.aci.app_profile.healthApplication Profile - HealthUnspecified
Bridge Domain Healthcisco.aci.bridge_domain.healthBridge Domain - HealthUnspecified
Endpoint Group Contract Consumerscisco.aci.endpoint_group.contract_consumersEndpoint Group - Contract ConsumersCount
Endpoint Group Contract Providerscisco.aci.endpoint_group.contract_providersEndpoint Group - Contract ProvidersCount
Endpoint Group Healthcisco.aci.endpoint_group.healthEndpoint Group - HealthUnspecified
Private Network Healthcisco.aci.private_network.healthPrivate Network - HealthUnspecified
Application Profilescisco.aci.tenant.app_profilesApplication ProfilesCount
Bridge Domainscisco.aci.tenant.bridge_domainsBridge DomainsCount
Contractscisco.aci.tenant.contractsContractsCount
Tenant healthcisco.aci.tenant.healthTenant - HealthUnspecified
Private Networkscisco.aci.tenant.private_networksPrivate NetworksCount
Metric nameMetric keyDescriptionUnit
Egress Bytes Cumulativecisco.aci.l1_phys_if.eqpt_egr_total_hist_5min.bytes_cum.countPhysical Interface - Egress Bytes CumulativeByte
Egress Bytes Ratecisco.aci.l1_phys_if.eqpt_egr_total_hist_5min.bytes_ratePhysical Interface - Egress Bytes RateBytePerSecond
Egress Packets ratecisco.aci.l1_phys_if.eqpt_egr_total_hist_5min.pkts_ratePhysical Interface - Egress Packets ratePerSecond
Egress Link Utilizationcisco.aci.l1_phys_if.eqpt_egr_total_hist_5min.util_avgPhysical Interface - Egress Link UtilizationPercent
Ingress Bytes Cumulativecisco.aci.l1_phys_if.eqpt_ingr_total_hist_5min.bytes_cum.countPhysical Interface - Ingress Bytes CumulativeByte
Ingress Bytes ratecisco.aci.l1_phys_if.eqpt_ingr_total_hist_5min.bytes_ratePhysical Interface - Ingress Bytes RateBytePerSecond
Ingress Packets ratecisco.aci.l1_phys_if.eqpt_ingr_total_hist_5min.pkts_ratePhysical Interface - Ingress Packets ratePerSecond
Ingress Link Utilizationcisco.aci.l1_phys_if.eqpt_ingr_total_hist_5min.util_avgPhysical Interface - Ingress Link UtilizationPercent
Egress Bytes Cumulativecisco.aci.mgmt_if.eqpt_egr_total_hist_5min.bytes_cum.countManagement Interface - Egress Bytes CumulativeByte
Egress Bytes Ratecisco.aci.mgmt_if.eqpt_egr_total_hist_5min.bytes_rateManagement Interface - Egress Bytes RateBytePerSecond
Egress Packets ratecisco.aci.mgmt_if.eqpt_egr_total_hist_5min.pkts_rateManagement Interface - Egress Packets ratePerSecond
Egress Link Utilizationcisco.aci.mgmt_if.eqpt_egr_total_hist_5min.util_avgManagement Interface - Egress Link UtilizationPercent
Ingress Bytes Cumulativecisco.aci.mgmt_if.eqpt_ingr_total_hist_5min.bytes_cum.countManagement Interface - Ingress Bytes CumulativeByte
Ingress Bytes Ratecisco.aci.mgmt_if.eqpt_ingr_total_hist_5min.bytes_rateManagement Interface - Ingress Bytes RateBytePerSecond
Ingress Packets ratecisco.aci.mgmt_if.eqpt_ingr_total_hist_5min.pkts_rateManagement Interface - Ingress Packets ratePerSecond
Ingress Link Utilizationcisco.aci.mgmt_if.eqpt_ingr_total_hist_5min.util_avgManagement Interface - Ingress Link UtilizationPercent

Full version history

To have more information on how to install the downloaded package, please follow the instructions on this page.
ReleaseDate

Full version history

⚠️ WARNING ⚠️️: Possible breaking changes and warnings — PLEASE READ before upgrading

  • The minimum Dynatrace version is now 1.347.0.

  • Davis events of ACI faults have a new title: [<fault code>] <cause> - <affected object>. They are now linked to the affected object, not to the fabric. Update alerting profiles, workflows, management zones and segments that use these events.

  • Fault log records now use the log levels CRITICAL, ERROR, WARN and INFO. The properties have new names: fault_lc, fault_severity, fault_type, fault_cause and fault_code. The old names are removed in the next version. Update DQL queries, alerts and log processing rules.

New in this version

  • Explorer screens in the Infrastructure & Operations app for fabrics, pods, fabric nodes, tenants, application profiles, endpoint groups, bridge domains, VRFs and contracts. Network devices and interfaces have new ACI tabs.

  • Tenants, application profiles, endpoint groups, bridge domains, VRFs and contracts are now Smartscape nodes.

  • A Davis problem opens when the APIC raises a fault. It closes when the fault is cleared, acknowledged or deleted. Consult the documentation for more information.

  • New setting Fault Collection Frequency.

  • New metric dimension polling.interval: the number of minutes one value covers.

Improved in this version

  • Fault collection needs less memory.

  • Dashboards Cisco ACI Fabric Overview and Cisco ACI Tenants Overview.

Changed in this version

  • After a start, the extension reports only the faults that changed in the last day. Raise Max age of faults on start (days) to include older faults.

  • A Metrics Collection Frequency above 300 minutes is reduced to 300 minutes.

Fixed in this version

  • Fault records are now reported as log records when Report Faults Records as Log Messages is on.

  • Wrong metric values: leaf capacity usage (100 times too small), system memory (1,024 times too small), load average (shown as CPU percent).

  • The ip field of network device nodes is now a list of IP addresses.

Full version history

⚠️ WARNING ⚠️️: Possible breaking changes and warnings — PLEASE READ before upgrading

  • The minimum Dynatrace version is now 1.347.0.

  • Davis events of ACI faults have a new title: [<fault code>] <cause> - <affected object>. Update alerting profiles, workflows and filters that match the old title.

  • Davis events of ACI faults are now linked to the object the fault is on, not to the whole fabric. Check management zones, segments, alerting profiles and workflows that select these problems by entity.

  • Fault log records now use the standard log levels CRITICAL, ERROR, WARN and INFO. Update log queries and alerts that filter fault logs by status or loglevel.

  • Fault log records have new property names: fault_lc, fault_severity, fault_type, fault_cause and fault_code. The old names lifecycle, severity, type, cause and code are still sent in this version and will be removed in the next one. Update DQL queries, alerts and log processing rules now.

New in this version

  • This extension is now using all rich visualization features of Grail within Infrastructure & Operations App.

  • Explorer screens for fabrics, pods, fabric nodes, tenants, application profiles, endpoint groups, bridge domains, VRFs and contracts, and ACI tabs on network devices and interfaces.

  • Tenants, application profiles, endpoint groups, bridge domains, VRFs and contracts are now Smartscape nodes, linked to each other.

  • Davis problems from ACI faults follow the APIC fault lifecycle: a problem opens when the APIC raises a fault and closes when the fault is cleared, acknowledged or deleted. How fault reporting works: Faults reporting and event integration in the extension documentation.

  • New setting Fault Collection Frequency.

  • More APIC details on the Smartscape nodes, including the APIC cluster on the controller.

Improved in this version

  • Fault collection needs less memory.

  • In Dynatrace Managed, fault log records are also shown on the controller interface and APIC cluster element entities.

  • Management interface traffic is reported in every collection.

  • Improved dashboards for the latest Dynatrace: Cisco ACI Fabric Overview and Cisco ACI Tenants Overview.

Changed in this version

  • After a start or a restart, the extension reports only the faults that changed in the last day. To include older faults, raise Max age of faults on start (days). Details: Faults reporting and event integration in the extension documentation.

  • A Metrics Collection Frequency above 300 minutes is reduced to 300 minutes.

  • The APIC connection status metric cisco.aci.apic.status is in the default feature set.

  • Some metric display names follow the Cisco ACI naming. The metric keys are unchanged.

Fixed in this version

  • Fault records are now reported as log records when Report Faults Records as Log Messages is on.

  • The leaf capacity usage metrics (VLAN, policy CAM, MAC, IPv4) showed values 100 times too small.

  • The system memory metrics (free, total, used), also on the generic network device, showed values 1,024 times too small.

  • The ip field of network device (EXT_NETWORK_DEVICE) nodes is now a list of IP addresses, as the Dynatrace semantic dictionary defines it. Before, it was a single text value.

  • The load average metrics (cisco.aci.system.proc_sys_load_avg and …_last) were shown as CPU utilization in percent. They are now shown as the 1-minute load average.

  • The EPG Contract Provided / Consumed attribute of the classic EPG contract entities (Dynatrace Managed) was swapped.

Full version history

Update the certifi dependency to address CVE-2026-111943

Full version history

Fixed in this version

  • Fixed broken classic topology when monitoring more than one ACI environment: some entities (such as controllers and spines) were incorrectly merged or linked across fabrics. Each entity now stays within its own fabric.
  • Fixed the fabric filter on the currently monitoring count tiles of the Cisco ACI Fabric Overview and Cisco ACI Tenants Overview dashboards. Selecting a fabric now rescopes those counts to the selected fabric — previously they always showed the totals across all monitored fabrics, while the charts and tables on the same dashboards were filtered correctly.

Note: the fault log event properties renamed in 2.0.4 are still reported under both their old and new names. The old names — lifecycle, severity, type, cause, code — remain deprecated in favor of fault_lc, fault_severity, fault_type, fault_cause and fault_code. They will be kept until a future minor release, not removed in a bugfix release.

Full version history

⚠️ WARNING ⚠️️: Possible breaking changes and warnings — PLEASE READ before upgrading

  • This version requires a minimum Dynatrace version of 1.338.0 and a minimum EEC version of 1.333.0.
  • This version includes a possible breaking change for Dynatrace on Grail.
    • With the inclusion of OpenPipeline processing rules, any metrics ingested from the extension will be processed by a dedicated OpenPipeline pipeline instead of the default pipeline.
    • This means that any custom dynamic rules you created will no longer apply to metrics from this extension. To keep enforcing them, please create pipeline groups.
    • Additionally, some field names are handled differently in OpenPipeline (e.g. capitalization). Please double-check any custom dashboards and alerts you created for this extension.
    • You must opt-in to OpenPipeline configuration via Settings API — see the documentation.
  • The apic dimension/property is deprecated and will be discontinued in a future release. Note that this dimension doesn't identify an APIC controller — its value reflects the monitored fabric infrastructure name as defined in the extension's monitoring configuration (the configuration name). The new fabric_name property carries that exact value under an accurate name. apic is still reported for backward compatibility. Please base any custom dashboards, notebooks, alerts, and DQL queries on fabric_name instead of apic.
  • The following fault log event properties have been renamed for consistency. Both old and new names are present in this release. The old names will be removed in the next release — update your DQL queries and log processing rules to use the new names.
Old nameNew name
codefault_code
causefault_cause
severityfault_severity
typefault_type
lifecyclefault_lc

This applies to both fault_info and fault_record log event types (filtered by cisco_aci_event_type).

New in this version

  • Smartscape on Grail. This extension will populate new Smartscape nodes and edges via OpenPipeline extraction.
  • Added vendor, software_revision, and serial_number properties to fabric node discovery log events, surfaced as entity attributes on cisco_aci:fabric_node.
  • Added if_name property to management interface discovery log events.
  • New fabric_name dimension/property identifying the monitored ACI fabric (one per monitoring configuration). It is present on all metrics and log events, on the classic cisco_aci:* entities, and on the Smartscape nodes. It carries the same value as the existing apic dimension.
  • Report fault records without matching fault instance (expert config): when enabled, fault records (faultRecord) are reported even when no matching fault instance (faultInst or faultDelegate) is reported. Default: disabled. Useful when fault instances are filtered out due to APIC security domain restrictions (e.g. Report Fault Instance Only combined with an APIC user that only sees faultDelegate entries).
  • Primary tags and Primary fields (monitoring configuration): two new optional sections on the APIC endpoint, planned for an upcoming release.

Improved in this version

  • Extension runtime upgraded to Python 3.14. Requires ActiveGate or OneAgent EEC version 1.333 or later (released March 2026).
  • Gen3 dashboards no longer contain navigation links to Gen2 entity screens.
  • Feature sets now include recommended flags to guide installation defaults.
  • Fault collection now uses a two-window approach: full Max age of Fault Infos and Fault Records window on first cycle to warm the cache, then a shorter Fault subsequent collection window (hours) + collection frequency window on subsequent cycles to reduce APIC API load.
  • Fixed faultInst deduplication: fault_info log records are now re-reported only when the fault's lc (lifecycle), severity, or cause properties actually change. Previously, APIC's ~5-minute heartbeat on lastTransition caused the same fault to be re-reported ~288 times/day. The occur (occurrence count) change is intentionally not considered a re-report trigger as it represents the same periodic re-evaluation, not a meaningful state change.

Full version history

Added

  • Report fault records without matching fault instance (expert config): when enabled, fault records (faultRecord) are reported even when no matching fault instance (faultInst or faultDelegate) is reported. Default: disabled. Useful when fault instances are filtered out due to APIC security domain restrictions (e.g. Report Fault Instance Only combined with an APIC user that only sees faultDelegate entries).

Changed

  • Extension runtime upgraded to Python 3.14. Requires ActiveGate or OneAgent EEC version 1.333 or later (released March 2026).
  • Gen3 dashboards no longer contain navigation links to Gen2 entity screens.
  • Feature sets now include recommended flags to guide installation defaults.
  • Fault collection now uses a two-window approach: full Max age of Fault Infos and Fault Records window on first cycle to warm the cache, then a shorter Fault subsequent collection window (hours) + collection frequency window on subsequent cycles to reduce APIC API load.

Fixed

  • Fixed faultInst deduplication: fault_info log records are now re-reported only when the fault's lc (lifecycle), severity, or cause properties actually change. Previously, APIC's ~5-minute heartbeat on lastTransition caused the same fault to be re-reported ~288 times/day. The occur (occurrence count) change is intentionally not considered a re-report trigger as it represents the same periodic re-evaluation, not a meaningful state change.

Deprecated

The following fault log event properties have been renamed for consistency. Both old and new names are present in this release. The old names will be removed in the next release — update your DQL queries and log processing rules to use the new names.

Old nameNew name
codefault_code
causefault_cause
severityfault_severity
typefault_type
lifecyclefault_lc

This applies to both fault_info and fault_record log event types (filtered by cisco_aci_event_type).

Full version history

Improved in this version

  • Improved entity topology handling in very large environments

Full version history

Improved in this version

  • Fixed display issues with the single-value metric visualization in the Infrastructure & Operations application.

Full version history

Patch level changes

  • Resolved an issue where the com.dynatrace.extension.network_device.sysuptime metric was calculated incorrectly.

Full version history

This is the first generally available release of this extension.

Note to the early adopters of the pre-release version: monitoring configuration needs to be re-created from scratch, it won't upgrade. However, if you keep the same configuration name, your previously collected metrics will remain available.

Dynatrace Hub
Get data into DynatraceBuild your own app
Dynatrace Intelligence - The Agentic PlatformThe Dynatrace Agentic AI ecosystem
All (954)Log Management and AnalyticsKubernetesAI and LLM ObservabilityInfrastructure ObservabilitySoftware DeliveryApplication ObservabilityApplication SecurityBusiness ObservabilityDigital Experience
Filter
Type
Built and maintained by
Partner FinderBecome a partnerDynatrace Developer

Discover recent additions to Dynatrace

Arize AX logo

Arize AX

Analyze traces, latency, and evals of LLM apps through Arize OpenInference data.

AI Observability logo

AI Observability

End-to-end observability for your Agentic AI and LLM workloads.

Dynatrace Assist logo

Dynatrace Assist

Dynatrace Assist: Ask, analyze, and act with Dynatrace Intelligence.

SRE Agent logo

SRE Agent

Analyze and triage incidents.

Smartscape logo

Smartscape

Interactively explore and analyze topology and relationships in digital systems.

Clouds logo

Clouds

Gain full visibility and proactive monitoring across your cloud infrastructure.

Analyze your data

Understand your data better with deep insights and clear visualizations.

Notebooks logo

Notebooks

Create powerful, data-driven documents for custom analytics and collaboration.

Dashboards logo

Dashboards

Transform complex data into clear visualizations with custom dashboards.

Investigations logo

Investigations

Fast and precise incident response on Grail data with DQL queries.

Smartscape logo

Smartscape

Interactively explore and analyze topology and relationships in digital systems.

Logs logo

Logs

Explore all your logs without writing a single query.

Problems logo

Problems

Detect, explain and triage problems automatically using Dynatrace Intelligence.

Automate your processes

Turn data and answers into actions, securely, and at scale.

Workflows logo

Workflows

Automate tasks in your IT landscape and move towards autonomous operations.

Jira logo

Jira

Open, update, and close Jira tickets automatically from Dynatrace Workflows.

Slack logo

Slack

Automate Slack messaging for security incidents, attacks, remediation, and more.

Secure your cloud application

See vulnerabilities and attacks in your environment.

Security Posture Management logo

Security Posture Management

Detect, prioritize, and remediate security and compliance findings with SPM.

Threats & Exploits logo

Threats & Exploits

Understand, triage, and investigate detection findings and alerts.

More resources

Cursor (Live-Debugger) logo

Cursor (Live-Debugger)

Get Real time Code-Level data directly to your Cursor IDE.

Documents logo

Documents

Manage Dashboards, Notebooks and other documents in your Dynatrace environment.

GitHub Copilot Coding Agent logo

GitHub Copilot Coding Agent

Automate vulnerability remediation and boost developer productivity.

GitHub Copilot Custom Agent logo

GitHub Copilot Custom Agent

Automate your development workflows with specialized agent definitions.

Dynatrace Live Debugger on JetBrains logo

Dynatrace Live Debugger on JetBrains

Get real-time code-level data directly to your Jetbrains IDE.

Metrics logo

Metrics

Browse, search, and manage all your metrics in one central catalog.

Dynatrace Live Debugger on Windsurf logo

Dynatrace Live Debugger on Windsurf

Get real-time code-level data directly to your Windsurf IDE.

Are you looking for something different?

We have hundreds of apps, extensions, and other technologies to customize your environment

Leverage our newest innovations of Dynatrace Saas

Kick-start your app creation

Kick-start your app creation

Whether you’re a beginner or a pro, Dynatrace Developer has the tools and support you need to create incredible apps with minimal effort.
Go to Dynatrace Developer
Upgrading from Dynatrace Managed to SaaS

Upgrading from Dynatrace Managed to SaaS

Drive innovation, speed, and agility in your organization by seamlessly and securely upgrading.
Learn More
Log Management and Analytics

Log Management and Analytics

Innovate faster and more efficiently with unified log management and log analytics for actionable insights and automation.
Learn more