# Copyright (c) 2021 Cisco and/or its affiliates. # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at: # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """VPP counters utilities library.""" from pprint import pformat from robot.api import logger from resources.libraries.python.PapiExecutor import PapiExecutor, \ PapiSocketExecutor from resources.libraries.python.topology import Topology, SocketType, NodeType class VppCounters: """VPP counters utilities.""" def __init__(self): self._stats_table = None @staticmethod def vpp_show_errors(node): """Run "show errors" debug CLI command. :param node: Node to run command on. :type node: dict """ PapiSocketExecutor.run_cli_cmd_on_all_sockets(node, u"show errors") @staticmethod def vpp_show_errors_on_all_duts(nodes): """Show errors on all DUTs. :param nodes: VPP nodes. :type nodes: dict """ for node in nodes.values(): if node[u"type"] == NodeType.DUT: VppCounters.vpp_show_errors(node) @staticmethod def vpp_show_runtime(node, log_zeros=False): """Run "show runtime" CLI command. :param node: Node to run command on. :param log_zeros: Log also items with zero values. :type node: dict :type log_zeros: bool """ args = dict(path=u"^/sys/node") sockets = Topology.get_node_sockets(node, socket_type=SocketType.STATS) if sockets: for socket in sockets.values(): with PapiExecutor(node) as papi_exec: stats = papi_exec.add(u"vpp-stats", **args).\ get_stats(socket=socket)[0] names = stats[u"/sys/node/names"] if not names: return runtime = list() runtime_nz = list() for name in names: runtime.append({u"name": name}) for idx, runtime_item in enumerate(runtime): calls_th = [] for thread in stats[u"/sys/node/calls"]: calls_th.append(thread[idx]) runtime_item[u"calls"] = calls_th vectors_th = [] for thread in stats[u"/sys/node/vectors"]: vectors_th.append(thread[idx]) runtime_item[u"vectors"] = vectors_th suspends_th = [] for thread in stats[u"/sys/node/suspends"]: suspends_th.append(thread[idx]) runtime_item[u"suspends"] = suspends_th clocks_th = [] for thread in stats[u"/sys/node/clocks"]: clocks_th.append(thread[idx]) runtime_item[u"clocks"] = clocks_th if (sum(calls_th) or sum(vectors_th) or sum(suspends_th) or sum(clocks_th)): runtime_nz.append(runtime_item) if log_zeros: logger.info( f"stats runtime ({node[u'host']} - {socket}):\n" f"{pformat(runtime)}" ) else: logger.info( f"stats runtime ({node[u'host']} - {socket}):\n" f"{pformat(runtime_nz)}" ) # Run also the CLI command, the above sometimes misses some info. PapiSocketExecutor.run_cli_cmd_on_all_sockets(node, u"show runtime") @staticmethod def vpp_show_runtime_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[u"type"] == NodeType.DUT: VppCounters.vpp_show_runtime(node) @staticmethod def vpp_show_hardware(node): """Run "show hardware" debug CLI command. :param node: Node to run command on. :type node: dict """ PapiSocketExecutor.run_cli_cmd_on_all_sockets( node, u"show hardware verbose" ) @staticmethod def vpp_show_memory(node): """Run "show memory" debug CLI command. Currently, every flag is hardcoded, giving the longest output. :param node: Node to run command on. :type node: dict """ PapiSocketExecutor.run_cli_cmd_on_all_sockets( node, u"show memory verbose api-segment stats-segment main-heap" ) @staticmethod def vpp_show_memory_on_all_duts(nodes): """Run "show memory" on all DUTs. :param nodes: VPP nodes. :type nodes: dict """ for node in nodes.values(): if node[u"type"] == NodeType.DUT: VppCounters.vpp_show_memory(node) @staticmethod def vpp_clear_runtime(node): """Run "clear runtime" CLI command. :param node: Node to run command on. :type node: dict """ PapiSocketExecutor.run_cli_cmd_on_all_sockets( node, u"clear runtime", log=False ) @staticmethod def vpp_clear_runtime_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[u"type"] == NodeType.DUT: VppCounters.vpp_clear_runtime(node) @staticmethod def vpp_clear_hardware(node): """Run "clear hardware" CLI command. :param node: Node to run command on. :type node: dict :returns: Verified data from PAPI response. :rtype: dict """ PapiSocketExecutor.run_cli_cmd_on_all_sockets( node, u"clear hardware", log=False ) @staticmethod def vpp_clear_hardware_on_all_duts(nodes): """Clear hardware on all DUTs. :param nodes: VPP nodes. :type nodes: dict """ for node in nodes.values(): if node[u"type"] == NodeType.DUT: VppCounters.vpp_clear_hardware(node) @staticmethod def vpp_clear_errors(node): """Run "clear errors" CLI command. :param node: Node to run command on. :type node: dict """ PapiSocketExecutor.run_cli_cmd_on_all_sockets( node, u"clear errors", log=False ) @staticmethod def vpp_clear_errors_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[u"type"] == NodeType.DUT: VppCounters.vpp_clear_errors(node) @staticmethod def show_vpp_statistics(node): """Show [errors, hardware] stats. :param node: VPP node. :type node: dict """ VppCounters.vpp_show_errors(node) VppCounters.vpp_show_hardware(node) @staticmethod def show_statistics_on_all_duts(nodes): """Show statistics on all DUTs. :param nodes: DUT nodes. :type nodes: dict """ for node in nodes.values(): if node[u"type"] == NodeType.DUT: VppCounters.show_vpp_statistics(node) @staticmethod def clear_vpp_statistics(node): """Clear [errors, hardware] stats. :param node: VPP node. :type node: dict """ VppCounters.vpp_clear_errors(node) VppCounters.vpp_clear_hardware(node) @staticmethod def clear_statistics_on_all_duts(nodes): """Clear statistics on all DUTs. :param nodes: DUT nodes. :type nodes: dict """ for node in nodes.values(): if node[u"type"] == NodeType.DUT: VppCounters.clear_vpp_statistics(node)