From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 27ED2A0C4C; Tue, 5 Oct 2021 16:18:31 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4ACD5413C0; Tue, 5 Oct 2021 16:18:08 +0200 (CEST) Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by mails.dpdk.org (Postfix) with ESMTP id EEAFD41383 for ; Tue, 5 Oct 2021 16:18:03 +0200 (CEST) X-IronPort-AV: E=McAfee;i="6200,9189,10128"; a="206563970" X-IronPort-AV: E=Sophos;i="5.85,349,1624345200"; d="scan'208";a="206563970" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 05 Oct 2021 06:59:29 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,349,1624345200"; d="scan'208";a="488044144" Received: from silpixa00399126.ir.intel.com ([10.237.223.151]) by orsmga008.jf.intel.com with ESMTP; 05 Oct 2021 06:59:27 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: Ciara Power , David Marchand , Anatoly Burakov , Kevin Traynor , Bruce Richardson Date: Tue, 5 Oct 2021 14:59:09 +0100 Message-Id: <20211005135909.726091-6-bruce.richardson@intel.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20211005135909.726091-1-bruce.richardson@intel.com> References: <20210915141030.23514-1-bruce.richardson@intel.com> <20211005135909.726091-1-bruce.richardson@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v6 5/5] usertools/dpdk-telemetry: provide info on available sockets X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" When a user runs the dpdk-telemetry script and fails to connect because the socket path does not exist, run a scan for possible sockets that could be connected to and inform the user of the command needed to connect to those. For example, when running the script without any parameters, but there are DPDK processes running with in-memory mode (so they need to be identified by PID), the error message will include the details of how to connect to each process: $ ./usertools/dpdk-telemetry.py Connecting to /run/user/1000/dpdk/rte/dpdk_telemetry.v2 Error connecting to /run/user/1000/dpdk/rte/dpdk_telemetry.v2 Other DPDK telemetry sockets found: - dpdk_telemetry.v2.20755 # Connect with './usertools/dpdk-telemetry.py -p 20755' - dpdk_telemetry.v2.20451 # Connect with './usertools/dpdk-telemetry.py -p 20451' Signed-off-by: Bruce Richardson --- doc/guides/howto/telemetry.rst | 3 +++ usertools/dpdk-telemetry.py | 41 ++++++++++++++++++++++++++++++---- 2 files changed, 40 insertions(+), 4 deletions(-) diff --git a/doc/guides/howto/telemetry.rst b/doc/guides/howto/telemetry.rst index c3adca9504..cdde57cb3b 100644 --- a/doc/guides/howto/telemetry.rst +++ b/doc/guides/howto/telemetry.rst @@ -68,6 +68,9 @@ and query information using the telemetry client python script. When connecting to a process run with `--in-memory` EAL flag, one must specify the PID of the process to connect to using the `-p` flag. This is because there may be multiple such instances. + If there are only *in-memory* DPDK processes to connect to, + and no PID, or an invalid PID parameter, is provided, + the telemetry script will list any available telemetry sockets and how to connect to them. #. When connected, the script displays the following, waiting for user input:: diff --git a/usertools/dpdk-telemetry.py b/usertools/dpdk-telemetry.py index 690014ba9a..7f22e21828 100755 --- a/usertools/dpdk-telemetry.py +++ b/usertools/dpdk-telemetry.py @@ -10,6 +10,7 @@ import socket import os import sys +import glob import json import errno import readline @@ -17,6 +18,8 @@ # global vars TELEMETRY_VERSION = "v2" +SOCKET_NAME = 'dpdk_telemetry.{}'.format(TELEMETRY_VERSION) +DEFAULT_PREFIX = 'rte' CMDS = [] @@ -48,7 +51,28 @@ def get_app_name(pid): return None -def handle_socket(path): +def find_sockets(path): + """ Find any possible sockets to connect to and return them """ + return glob.glob(os.path.join(path, SOCKET_NAME + '*')) + + +def print_socket_options(prefix, paths): + """ Given a set of socket paths, give the commands needed to connect """ + cmd = sys.argv[0] + if prefix != DEFAULT_PREFIX: + cmd += " -f " + prefix + for s in paths: + sock_name = os.path.basename(s) + if sock_name.endswith(TELEMETRY_VERSION): + print("- {} # Connect with '{}'".format(os.path.basename(s), + cmd)) + else: + print("- {} # Connect with '{} -p {}'".format(os.path.basename(s), + cmd, + s.split('.')[-1])) + + +def handle_socket(args, path): """ Connect to socket and handle user input """ prompt = '' # this evaluates to false in conditions sock = socket.socket(socket.AF_UNIX, socket.SOCK_SEQPACKET) @@ -62,6 +86,15 @@ def handle_socket(path): except OSError: print("Error connecting to " + path) sock.close() + # if socket exists but is bad, or if non-interactive just return + if os.path.exists(path) or not prompt: + return + # if user didn't give a valid socket path, but there are + # some sockets, help the user out by printing how to connect + socks = find_sockets(os.path.dirname(path)) + if socks: + print("\nOther DPDK telemetry sockets found:") + print_socket_options(args.file_prefix, socks) return json_reply = read_socket(sock, 1024, prompt) output_buf_len = json_reply["max_output_len"] @@ -110,13 +143,13 @@ def get_dpdk_runtime_dir(fp): readline.set_completer_delims(readline.get_completer_delims().replace('/', '')) parser = argparse.ArgumentParser() -parser.add_argument('-f', '--file-prefix', default='rte', +parser.add_argument('-f', '--file-prefix', default=DEFAULT_PREFIX, help='Provide file-prefix for DPDK runtime directory') parser.add_argument('-p', '--pid', help='Connect to DPDK process with the given pid') args = parser.parse_args() rd = get_dpdk_runtime_dir(args.file_prefix) -sock_path = os.path.join(rd, 'dpdk_telemetry.{}'.format(TELEMETRY_VERSION)) +sock_path = os.path.join(rd, SOCKET_NAME) if args.pid: sock_path += ".{}".format(args.pid) -handle_socket(sock_path) +handle_socket(args, sock_path) -- 2.30.2