"""VPP counters utilities library."""
import time
-from topology import NodeType, Topology
-from VatExecutor import VatExecutor, VatTerminal
+
from robot.api import logger
+from resources.libraries.python.PapiExecutor import PapiExecutor
+from resources.libraries.python.topology import NodeType, Topology
+from resources.libraries.python.VatExecutor import VatExecutor, VatTerminal
class VppCounters(object):
def __init__(self):
self._stats_table = None
- def vpp_nodes_clear_interface_counters(self, nodes):
- """Clear interface counters on all VPP nodes in topology.
+ @staticmethod
+ def vpp_show_errors(node):
+ """Run "show errors" debug CLI command.
- :param nodes: Nodes in topology.
- :type nodes: dict
+ :param node: Node to run command on.
+ :type node: dict
"""
- for node in nodes.values():
- if node['type'] == NodeType.DUT:
- self.vpp_clear_interface_counters(node)
+ vat = VatExecutor()
+ vat.execute_script("show_errors.vat", node, json_out=False)
+ vat.script_should_have_passed()
@staticmethod
def vpp_show_errors_verbose(node):
- """Run "show errors verbose" debug CLI command
+ """Run "show errors verbose" debug CLI command.
- :param node: Node to run command on
+ :param node: Node to run command on.
:type node: dict
"""
vat = VatExecutor()
vat.execute_script("show_errors_verbose.vat", node, json_out=False)
+ vat.script_should_have_passed()
+
+ @staticmethod
+ def vpp_show_errors_on_all_duts(nodes, verbose=False):
+ """Show errors on all DUTs.
+
+ :param nodes: VPP nodes.
+ :param verbose: If True show verbose output.
+ :type nodes: dict
+ :type verbose: bool
+ """
+
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ if verbose:
+ VppCounters.vpp_show_errors_verbose(node)
+ else:
+ VppCounters.vpp_show_errors(node)
+
+ @staticmethod
+ def vpp_show_runtime(node):
+ """Run "show runtime" CLI command.
+
+ :param node: Node to run command on.
+ :type node: dict
+ """
+ vat = VatExecutor()
+ vat.execute_script("show_runtime.vat", node, json_out=False)
+ logger.info(vat.get_script_stdout())
+ vat.script_should_have_passed()
+
+ @staticmethod
+ def show_runtime_counters_on_all_duts(nodes):
+ """Clear VPP runtime counters on all DUTs.
+
+ :param nodes: VPP nodes.
+ :type nodes: dict
+ """
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ VppCounters.vpp_show_runtime(node)
@staticmethod
def vpp_show_runtime_verbose(node):
- """Run "show runtime" debug CLI command
+ """Run "show runtime verbose" CLI command.
- :param node: Node to run command on
+ :param node: Node to run command on.
:type node: dict
"""
vat = VatExecutor()
vat.execute_script("show_runtime_verbose.vat", node, json_out=False)
+ logger.info(vat.get_script_stdout())
+ vat.script_should_have_passed()
@staticmethod
def vpp_show_hardware_detail(node):
- """Run "show hardware-interfaces detail" debug CLI command
+ """Run "show hardware-interfaces detail" debug CLI command.
- :param node: Node to run command on
+ :param node: Node to run command on.
:type node: dict
"""
vat = VatExecutor()
vat.execute_script("show_hardware_detail.vat", node, json_out=False)
+ vat.script_should_have_passed()
+
+ @staticmethod
+ def vpp_clear_runtime(node):
+ """Run "clear runtime" CLI command.
+
+ :param node: Node to run command on.
+ :type node: dict
+ """
+ cmd = 'cli_inband'
+ cmd_reply = 'cli_inband_reply'
+ err_msg = "Failed to run '{cmd}' PAPI command on host {host}!".format(
+ host=node['host'], cmd=cmd)
+ args = dict(cmd='clear runtime')
+ with PapiExecutor(node) as papi_exec:
+ papi_resp = papi_exec.add(cmd, **args).execute_should_pass(err_msg)
+ data = papi_resp.reply[0]['api_reply'][cmd_reply]
+ if data['retval'] != 0:
+ raise RuntimeError("Failed to clear runtime on host {host}".
+ format(host=node['host']))
+
+ @staticmethod
+ def clear_runtime_counters_on_all_duts(nodes):
+ """Run "clear runtime" CLI command on all DUTs.
+
+ :param nodes: VPP nodes.
+ :type nodes: dict
+ """
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ VppCounters.vpp_clear_runtime(node)
@staticmethod
def vpp_clear_interface_counters(node):
"""Clear interface counters on VPP node.
- :param node: Node to clear interface counters on.
- :type node: dict
+ :param node: Node to clear interface counters on.
+ :type node: dict
+ """
+ cmd = 'cli_inband'
+ cmd_reply = 'cli_inband_reply'
+ err_msg = "Failed to run '{cmd}' PAPI command on host {host}!".format(
+ host=node['host'], cmd=cmd)
+ args = dict(cmd='clear interfaces')
+ with PapiExecutor(node) as papi_exec:
+ papi_resp = papi_exec.add(cmd, **args).execute_should_pass(err_msg)
+ data = papi_resp.reply[0]['api_reply'][cmd_reply]
+ if data['retval'] != 0:
+ raise RuntimeError("Failed to clear interfaces on host {host}".
+ format(host=node['host']))
+
+ @staticmethod
+ def clear_interface_counters_on_all_duts(nodes):
+ """Clear interface counters on all DUTs.
+
+ :param nodes: VPP nodes.
+ :type nodes: dict
+ """
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ VppCounters.vpp_clear_interface_counters(node)
+
+ @staticmethod
+ def vpp_clear_hardware_counters(node):
+ """Clear interface hardware counters on VPP node.
+
+ :param node: Node to clear hardware counters on.
+ :type node: dict
"""
vat = VatExecutor()
- vat.execute_script('clear_interface.vat', node)
+ vat.execute_script('clear_hardware.vat', node)
vat.script_should_have_passed()
+ @staticmethod
+ def clear_hardware_counters_on_all_duts(nodes):
+ """Clear hardware counters on all DUTs.
+
+ :param nodes: VPP nodes.
+ :type nodes: dict
+ """
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ VppCounters.vpp_clear_hardware_counters(node)
+
+ @staticmethod
+ def vpp_clear_errors_counters(node):
+ """Clear errors counters on VPP node.
+
+ :param node: Node to clear errors counters on.
+ :type node: dict
+ """
+ vat = VatExecutor()
+ vat.execute_script('clear_errors.vat', node)
+ vat.script_should_have_passed()
+
+ @staticmethod
+ def clear_error_counters_on_all_duts(nodes):
+ """Clear VPP errors counters on all DUTs.
+
+ :param nodes: VPP nodes.
+ :type nodes: dict
+ """
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ VppCounters.vpp_clear_errors_counters(node)
+
def vpp_dump_stats_table(self, node):
"""Dump stats table on VPP node.
- :param node: Node to dump stats table on.
- :type node: dict
- :return: Stats table.
+ :param node: Node to dump stats table on.
+ :type node: dict
+ :returns: Stats table.
"""
with VatTerminal(node) as vat:
vat.vat_terminal_exec_cmd('want_stats enable')
for _ in range(0, 12):
stats_table = vat.vat_terminal_exec_cmd('dump_stats_table')
- if_counters = stats_table['interface_counters']
- if len(if_counters) > 0:
+ if stats_table['interface_counters']:
self._stats_table = stats_table
return stats_table
time.sleep(1)
return None
def vpp_get_ipv4_interface_counter(self, node, interface):
+ """
+
+ :param node: Node to get interface IPv4 counter on.
+ :param interface: Interface name.
+ :type node: dict
+ :type interface: str
+ :returns: Interface IPv4 counter.
+ :rtype: int
+ """
return self.vpp_get_ipv46_interface_counter(node, interface, False)
def vpp_get_ipv6_interface_counter(self, node, interface):
+ """
+
+ :param node: Node to get interface IPv6 counter on.
+ :param interface: Interface name.
+ :type node: dict
+ :type interface: str
+ :returns: Interface IPv6 counter.
+ :rtype: int
+ """
return self.vpp_get_ipv46_interface_counter(node, interface, True)
def vpp_get_ipv46_interface_counter(self, node, interface, is_ipv6=True):
- """Return interface IPv4/IPv6 counter
+ """Return interface IPv4/IPv6 counter.
- :param node: Node to get interface IPv4/IPv6 counter on.
- :param interface: Interface name.
- :type node: dict
- :type interface: str
- :return: Interface IPv4/IPv6 counter.
- :param is_ipv6: specify IP version
- :type is_ipv6: bool
- :rtype: int
+ :param node: Node to get interface IPv4/IPv6 counter on.
+ :param interface: Interface name.
+ :param is_ipv6: Specify IP version.
+ :type node: dict
+ :type interface: str
+ :type is_ipv6: bool
+ :returns: Interface IPv4/IPv6 counter.
+ :rtype: int
"""
version = 'ip6' if is_ipv6 else 'ip4'
topo = Topology()
return 0
if_counters = self._stats_table.get('interface_counters')
- if if_counters is None or len(if_counters) == 0:
+ if not if_counters:
logger.trace('No interface counters.')
return 0
for counter in if_counters:
if counter['vnet_counter_type'] == version:
data = counter['data']
return data[if_index]
- logger.trace('{i} {v} counter not found.'.format(i=interface,
- v=version))
+ logger.trace('{i} {v} counter not found.'.format(
+ i=interface, v=version))
return 0
+
+ @staticmethod
+ def show_vpp_statistics(node):
+ """Show [error, hardware, interface] stats.
+
+ :param node: VPP node.
+ :type node: dict
+ """
+ VppCounters.vpp_show_errors(node)
+ VppCounters.vpp_show_hardware_detail(node)
+ VppCounters.vpp_show_runtime(node)
+
+ @staticmethod
+ def show_statistics_on_all_duts(nodes, sleeptime=5):
+ """Show VPP statistics on all DUTs.
+
+ :param nodes: VPP nodes.
+ :type nodes: dict
+ :param sleeptime: Time to wait for traffic to arrive back to TG.
+ :type sleeptime: int
+ """
+ logger.trace('Waiting for statistics to be collected')
+ time.sleep(sleeptime)
+ for node in nodes.values():
+ if node['type'] == NodeType.DUT:
+ VppCounters.show_vpp_statistics(node)