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 2E03BA0032; Fri, 1 Oct 2021 18:33:03 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id F305B41166; Fri, 1 Oct 2021 18:32:25 +0200 (CEST) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by mails.dpdk.org (Postfix) with ESMTP id A4D8C4120E for ; Fri, 1 Oct 2021 18:32:24 +0200 (CEST) X-IronPort-AV: E=McAfee;i="6200,9189,10124"; a="311029741" X-IronPort-AV: E=Sophos;i="5.85,339,1624345200"; d="scan'208";a="311029741" Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 01 Oct 2021 09:22:57 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.85,339,1624345200"; d="scan'208";a="565094537" Received: from silpixa00399126.ir.intel.com ([10.237.223.151]) by fmsmga002.fm.intel.com with ESMTP; 01 Oct 2021 09:22:55 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: Ciara Power , David Marchand , Anatoly Burakov , Kevin Traynor , Bruce Richardson Date: Fri, 1 Oct 2021 17:22:35 +0100 Message-Id: <20211001162235.389781-6-bruce.richardson@intel.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20211001162235.389781-1-bruce.richardson@intel.com> References: <20210915141030.23514-1-bruce.richardson@intel.com> <20211001162235.389781-1-bruce.richardson@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v5 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..15a8233cfc 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(args, paths): + """ Given a set of socket paths, give the commands needed to connect """ + cmd = sys.argv[0] + if args.file_prefix != DEFAULT_PREFIX: + cmd += " -f " + args.file_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, 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