pingcloud-cli

README

pingcloud-cli

Pingcloud-cli is CLI application to check latency and http trace from AWS, GCP and Azure regions.

This is a personal toy project.

Inspired by GCPing, httpstat-1 and AzureSpeed.

Capabilities

1. Send HTTP(S) request to regions of AWS, GCP and Azure. Calculate and report response time.
2. Print httpstat of region(s).
3. List region code and region name of AWS, GCP and Azure.

Thank you for using pingcloud-cli.
pingcloud-cli is command line tools to check latency and http trace from AWS, GCP and Azure regions.
You can download codes from https://github.com/reoim/pingcloud-cli
Any feedback is welcome. (And stars..)

Usage:
  pingcloud-cli [command]

Available Commands:
  aws         Check latencies of AWS regions.
  azure       Check latencies of Azure regions.
  gcp         Check latencies of GCP regions.
  help        Help about any command
  version     Print version of pingcloud-cli

Flags:
  -h, --help   help for pingcloud-cli

Use "pingcloud-cli [command] --help" for more information about a command.

Prerequisite

1. GO installed.
2. $GOPATH and $GOBIN are properly set.

Installation

1. Run git clone https://github.com/reoim/pingcloud-cli.git
2. Run GO111MODULE=on go mod vendor
3. Run go build -v
4. Run go install
5. Set Environment variable PINGCLOUD_DIR as your pingcloud-cli directory(absolute path).

   • Linux & Mac

     Add following code to your .profile or .bash_profile.

     Make sure change [YOUR pingcloud-cli DIR] to absolute path of the git cloned directory.

     # pingcloud-cli settings
     export PINGCLOUD_DIR="[YOUR pingcloud-cli DIR]"
     

     Restart terminal and check if PINGCLOUD_DIR is set properly.

     echo $PINGCLOUD_DIR
     

     Output should be like this (example)

     /Users/reolee/Downloads/pingcloud-cli
     

   • Windows

     • Open System in Control panel

     • In the System window, click the Advanced system settings

     • In the System Properties window, click on the Advanced tab, then click the Environment Variables button near the bottom of the tab

       

     • In the Environment Variables window, click the New button of the User variables section

     • Set Variable name as PINGCLOUD_DIR

     • Set Variable value as absolute path of pingcloud-cli directory like as shown below.

       C:\Users\reolee\Downloads\pingcloud-cli
       

     • Click OK button

     • Open new cmd and run echo %PINGCLOUD_DIR%

     • Output should be like this (example)

       C:\Users\reolee\Downloads\pingcloud-cli
       

Usage

GCP (Google Cloud Platform)

1. pingcloud-cli gcp

   Ping all GCP regions

   

2. pingcloud-cli gcp [region code]

   Print httpstat of specific regions. You can append multiple region codes to the end of command. (Seperate each region with space)

   

AWS

1. pingcloud-cli aws

   Ping all AWS regions

   

2. pingcloud-cli aws [region code]

   Print httpstat of specific regions. You can append multiple region codes to the end of command. (Seperate each region with space)

   

Azure

1. pingcloud-cli azure

   Ping all Azure regions

   

2. pingcloud-cli azure [region code]

   Print httpstat of specific regions. You can append multiple region codes to the end of command. (Seperate each region with space)

   

Flags

• -l or --list List all region codes and region names of the cloud provider. Add -l or --list flag after command.

Add/Edit/Delete regions

You can add/edit/delete regions by manifulating endpoints CSV files.

The CSV files of cloud platforms are located in pingcloud-cli/endpoints folder.

Make sure you follw the original csv format of the files.

Notes

Instances for latency test are not maintained by me.

Endpoints for AWS are from EC2 Reachability Test.

For GCP, GCP ping

And for Azure, AzureSpeed.

Endpoints from Azure have domain name and uses https but AWS, GCP endpoints are static and use http.

So latencies from Azure are relatively high compare to AWS and GCP because it needs domain loockup and tls handshaking.

2019-09-08

Changed Azure test endpoints https -> http.

No more TLS handshaking time.

2019-09-16

Removed endpoint information from code.

pingcloud-cli will read the endpoint information from external csv files which can be edited anytime by user.

Documentation

Overview

Copyright © 2019 NAME HERE <EMAIL ADDRESS>

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.