Please provide API information consumed by DX NetOps Virtual Network Assurance (VNA) to get data from a Cisco ACI (APIC) data source.
search cancel

Please provide API information consumed by DX NetOps Virtual Network Assurance (VNA) to get data from a Cisco ACI (APIC) data source.

book

Article ID: 416982

calendar_today

Updated On:

Products

Network Observability

Issue/Introduction

Users or administrators of DX NetOps Virtual Network Assurance (VNA) often need to identify the specific API endpoints
and URLs that VNA uses to collect various types of data (inventory, performance, availability, subscription) from
Cisco Application Policy Infrastructure Controller (APIC) instances. This information is crucial for troubleshooting
connectivity issues, understanding data collection mechanisms, auditing configurations, or verifying that the correct
APIC host and protocols are being utilized by VNA.

Environment

DX NetOps VNA All versions

Resolution

To find the API information, such as the URLs used for inventory, performance, availability, and subscription, follow these steps on the VNA collector host:

  1. Navigate to the ACI collector's device configuration directory. Replace ACI_UUID with the actual unique identifier for your ACI integration:
    /opt/CA/VNA/collector/ACI_UUID/repository/deviceConfig
  2. Run the following commands to search the configuration files . This will display the full API URLs used by VNA. 
    1. cat ACI-Inventory.xml | grep "${PROTOCOL}://${APIC_HOST_IP}"
    2. cat ACI-Performance.xml | grep "${PROTOCOL}://${APIC_HOST_IP}"
    3. cat ACI-Availability.xml | grep "${PROTOCOL}://${APIC_HOST_IP}"
    4. cat ACI-Subscription.xml | grep "${PROTOCOL}://${APIC_HOST_IP}"

These commands will output the lines containing the API endpoints VNA is configured to use for communicating with the Cisco APIC.