CiscoACI Integration

Overview

The Cisco ACI Integration lets you:

• Track the state and health of your network
• Track the capacity of your ACI
• Monitor the switches and controllers themselves

Setup

Installation

The Cisco ACI check is packaged with the Agent, so simply install the Agent on a server within your network.

Configuration

Host

To configure this check for an Agent running on a host:

1. Edit the cisco_aci.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory. See the sample cisco_aci.d/conf.yaml for all available configuration options:

   init_config:
   
   instances:
        ## @param aci_url - string - required
        ## URL to query to gather metrics.
        #
      - aci_url: http://localhost
    
        ## @param username - string - required
        ## Authentication can use either a user auth or a certificate.
        ## If using the user auth, enter the `username` and `pwd` configuration.
        #
        username: datadog
    
        ## @param pwd - string - required
        ## Authentication can use either a user auth or a certificate.
        ## If using the user auth, enter the `username` and `pwd` configuration.
        #
        pwd: <PWD>
    
        ## @param tenant - list of strings - optional
        ## List of tenants to collect metrics data from.
        #
        # tenant:
        #   - <TENANT_1>
        #   - <TENANT_2>

   NOTE: Be sure to specify any tenants for the integration to collect metrics on applications, EPG, etc.

2. Restart the Agent to begin sending Cisco ACI metrics to Datadog.

Containerized

For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.

Parameter	Value
<INTEGRATION_NAME>	cisco_aci
<INIT_CONFIG>	blank or {}
<INSTANCE_CONFIG>	{"aci_url":"%%host%%", "username":"<USERNAME>", "pwd": "<PASSWORD>"}

Validation

Run the Agent's status subcommand and look for cisco_aci under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The Cisco ACI check sends tenant faults as events.

Service Checks

See service_checks.json for a list of service checks provided by this integration.

Troubleshooting

Missing cisco_aci.tenant.* metrics

If you are missing cisco_aci.tenant.* metrics, you can run the test/cisco_aci_query.py script to manually query the tenant endpoint.

Modify the apic_url, apic_username, and apic_password to your configuration information, and input the tenant URL for the apic_url.

Verify that the output you get from cURLing the endpoint matches any of the metrics collected in datadog_checks/cisco_aci/aci_metrics.py. If none of the statistics match, this means that the endpoint is not emitting any statistics that the integration can collect.

Need help? Contact Datadog support.