tests.md

anta_title	ANTA Tests

This section describes all the available tests provided by the ANTA package.

Available Tests

Here are the tests that we currently provide:

• AAA
• Adaptive Virtual Topology
• BFD
• Configuration
• Connectivity
• CVX
• EVPN
• Field Notices
• Flow Tracking
• GreenT
• Hardware
• Interfaces
• LANZ
• Logging
• MLAG
• Multicast
• Profiles
• PTP
• Router Path Selection
• Routing Generic
• Routing BGP
• Routing ISIS
• Routing OSPF
• Security
• Services
• SNMP
• Software
• STP
• STUN
• System
• VLAN
• VXLAN

!!! tip

You can use `anta get tests` from the CLI to list all the tests available with an example. Refer to [documentation](../cli/get-tests.md) for more options.

Using the Tests

All these tests can be imported in a catalog to be used by the ANTA CLI or in your own framework.

Atomic result support

Tests marked with the following badge in the documentation support Atomic Results:

This means that when anta nrfu <command> is run with the --expand flag (currently supported for table and text), the report expands the test results to show one entry per input.

For instance, consider the following inventory and catalog:

---
anta_inventory:
  hosts:
    - host: 10.42.42.42
      name: pf1

---
anta.tests.connectivity:
  - VerifyReachability:
      hosts:
        - destination: 8.8.8.8
          vrf: MGMT
        - destination: 8.8.4.4
          vrf: default

Normal Run:

{ loading=lazy width="1600" }

Expanded Run:

{ loading=lazy width="1600" }

!!! warning

If the command collection fails for any reason, the results for that test will not be expanded.
This includes command collection failures based on [known EOS errors](./commands.md#anta.constants.KNOWN_EOS_ERRORS) tracked by ANTA.

!!! info

If you would like a test to support atomic results, please [open an issue on GitHub](https://github.com/aristanetworks/anta/issues)