Metadata-Version: 2.1
Name: serviceping
Version: 19.9.155704
Summary: A command line utility that provides a ping like interface for checking tcp/ssl ports and services
Home-page: https://github.com/yahoo/serviceping
Author: Dwight Hubbard
Author-email: dhubbard@ouroath.com
License: Apache
Description: # serviceping
        
        [![Build Status](https://cd.screwdriver.cd/pipelines/2881/badge)](https://cd.screwdriver.cd/pipelines/2881)
        [![Coverage](https://codecov.io/gh/yahoo/serviceping/branch/master/graph/badge.svg)](https://codecov.io/gh/yahoo/serviceping)
        [![Current Version](https://img.shields.io/pypi/v/serviceping.svg)](https://pypi.python.org/pypi/serviceping/)
        [![Supported Python Versions](https://img.shields.io/badge/python-3.6,3.7,3.8-blue.svg)](https://pypi.python.org/pypi/serviceping/)
        [![License](https://img.shields.io/pypi/l/serviceping.svg)](https://pypi.python.org/pypi/serviceping/)
        
        A utility with a "ping" like interface to ping tcp port services.
        
        ## Table of Contents
        
        - [Background](#background)
        - [Install](#install)
        - [Usage](#usage)
        - [Examples](#examples)
        - [Contribute](#contribute)
        - [License](#license)
        
        ## Background
        
        This utility was written to simplify troubleshooting network issues related to talking to network services
        
        ## Install
        
        To install serviceping, first make sure you are running Python 3.6+, then simply:
        
        ```
        pip install serviceping
        ```
        
        ## Usage
        
            usage: serviceping [-h] [-c COUNT] [-i INTERVAL] [-d] destination [destination ...]
            positional arguments:
              destination Destination host or URL
        
            optional arguments:
              -h, --help   show this help message and exit
              -c COUNT     Number of pings to send
              -i INTERVAL  Ping interval
              -d           Show timings for the entire connection
        
        
        ## Examples
        
        The serviceping tool uses a syntax that mirrors that of the ping commmand.
        
        
        ### Ping port 80 (http) on www.yahoo.com
        
        By pinging www.yahoo.com via http (port 80), we can clearly see the 
        multiple hosts responding and the latency of each request.
        
        ```console
        $ serviceping www.yahoo.com
        SERVICEPING www.yahoo.com:80 (98.139.180.149:80).
        from www.yahoo.com:80 (98.139.183.24:80): time=2.46 ms
        from www.yahoo.com:80 (98.139.180.149:80): time=2.43 ms
        --- www.yahoo.com ping statistics ---
        2 packets transmitted, 2 received, 0% packet loss, time 1704.0ms
        rtt min/avg/max/dev = 2.43/2.44/2.46/4.00 ms
        $
        ```
        
        ### Ping port 4443 (https) on www.yahoo.com
        
        Serviceping can also connect to other ports such as the ssl port (443).
        
        ```console
        $ serviceping www.yahoo.com:443
        SERVICEPING www.yahoo.com:443 (98.139.183.24:443).
        from www.yahoo.com:443 (98.139.180.149:443): time=2.89 ms
        from www.yahoo.com:443 (98.139.180.149:443): time=2.81 ms
        --- www.yahoo.com ping statistics ---
        2 packets transmitted, 2 received, 0% packet loss, time 1744.0ms
        rtt min/avg/max/dev = 2.81/2.85/2.89/6.08 ms
        $
        ```
        
        ### Pinging a URL instead of the port
        
        The serviceping command can also specify send ping requests to a url.  If a URL is specified, it will 
        perform an http get request and show the response, which is useful 
        when hosts are doing unexpected things in a dns
        rotation or behind a reverse proxy or vip.
        
        In this example we specify a url of http://cnn.com/
        
        ```console
        $ serviceping http://cnn.com/
        SERVICEPING cnn.com:80 (157.166.255.18:80).
        1500 bytes from cnn.com:80 (157.166.255.19:80):response=200 time=87.14 ms
        1448 bytes from cnn.com:80 (157.166.226.25:80):response=200 time=64.82 ms
        1500 bytes from cnn.com:80 (157.166.255.19:80):response=200 time=62.98 ms
        1500 bytes from cnn.com:80 (157.166.255.19:80):response=200 time=78.30 ms
        --- cnn.com ping statistics ---
        4 packets transmitted, 4 received, 0% packet loss, time 4372.0ms
        rtt min/avg/max/dev = 62.98/73.31/87.14/56.00 ms
        $
        ```
        
        The output shows that two hosts are responding to this request, and that they are returning different amounts of data in their responses.
        
        ### Pinging a URL with timings
        
        The detailed timing flag adds timings for each step of each request, 
        which is useful for determining the causes of latency issues or errors.
        
        Here we are doing the previous example with detailed timings.
        
        ```console
        $ serviceping -d http://cnn.com/
        SERVICEPING cnn.com:80 (157.166.255.19:80).
        1386 bytes from cnn.com:80 (157.166.255.19:80):response=200 dns=0.21ms connect=68.36ms request=130.02ms all=198.73ms
        1386 bytes from cnn.com:80 (157.166.226.25:80):response=200 dns=0.30ms connect=66.72ms request=101.07ms all=168.20ms
        1500 bytes from cnn.com:80 (157.166.255.18:80):response=200 dns=0.30ms connect=123.94ms request=203.08ms all=327.43ms
        1386 bytes from cnn.com:80 (157.166.226.26:80):response=200 dns=0.28ms connect=68.32ms request=87.94ms all=156.69ms
        --- cnn.com ping statistics ---
        4 packets transmitted, 4 received, 0% packet loss, time 5009.0ms
        rtt min/avg/max/dev = 156.69/212.76/327.43/138.24 ms
        $
        ```
        
        Clearly, the host with address 157.166.226.25 is taking significantly longer 
        to establish the tcp connection and handle the http request.
        
        ## License
        
        This project is licensed under the terms of the [Apache 2.0](LICENSE-Apache-2.0) open source license. Please refer to [LICENSE](LICENSE) for the full terms.
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: SunOS/Solaris
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
