{"id":13451623,"url":"https://github.com/ProspectOne/perfops-cli","last_synced_at":"2025-03-23T19:32:11.694Z","repository":{"id":52543331,"uuid":"98871469","full_name":"ProspectOne/perfops-cli","owner":"ProspectOne","description":"A simple command line tool to interact with hundreds of servers around the world. ","archived":false,"fork":false,"pushed_at":"2025-03-06T01:56:50.000Z","size":42085,"stargazers_count":286,"open_issues_count":4,"forks_count":45,"subscribers_count":25,"default_branch":"develop","last_synced_at":"2025-03-06T02:37:26.039Z","etag":null,"topics":["benchmark","cli","command-line","devops","linux","sysops","system-administration"],"latest_commit_sha":null,"homepage":"https://perfops.net/cli","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ProspectOne.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-31T09:23:33.000Z","updated_at":"2025-03-06T01:56:54.000Z","dependencies_parsed_at":"2024-01-15T16:04:38.226Z","dependency_job_id":"f87a2f6d-f599-4cf3-ba39-ceb872e2e2ef","html_url":"https://github.com/ProspectOne/perfops-cli","commit_stats":null,"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProspectOne%2Fperfops-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProspectOne%2Fperfops-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProspectOne%2Fperfops-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProspectOne%2Fperfops-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ProspectOne","download_url":"https://codeload.github.com/ProspectOne/perfops-cli/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245157951,"owners_count":20570102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["benchmark","cli","command-line","devops","linux","sysops","system-administration"],"created_at":"2024-07-31T07:00:57.227Z","updated_at":"2025-03-23T19:32:11.067Z","avatar_url":"https://github.com/ProspectOne.png","language":"Go","readme":"# PerfOps cli - Global network testing and benchmarking\n\n![Build Status](https://github.com/ProspectOne/perfops-cli/actions/workflows/publish.yml/badge.svg)\n\nA simple command line tool to interact with hundreds of servers around the world. Run benchmarks and debug your infrastructure without leaving your console. [More information](https://perfops.net/cli)\n\n## [Install instructions](https://github.com/ProspectOne/perfops-cli/blob/master/INSTALL.md)\n\n## Usage\n\nHelp screen\n\n```sh\n$ perfops -h\nperfops is a tool to interact with the PerfOps API.\n\nUsage:\n  perfops [flags]\n  perfops [command]\n\nAvailable Commands:\n  curl        Run a curl test on a domain name or IP address\n  dnsperf     Find the time it takes to resolve a DNS record on a target\n  help        Help about any command\n  latency     Run a ICMP latency test on a domain name or IP address\n  mtr         Run a MTR test on a domain name or IP address\n  ping        Run a ping test on a domain name or IP address\n  credits     Displays the remaing credits\n  resolve     Resolve a DNS record on a domain name\n  traceroute  Run a traceroute test on a domain name or IP address\n\nFlags:\n      --debug             Enables debug output\n  -F, --from string       A continent, region (e.g eastern europe), country, US state or city\n  -h, --help              help for perfops\n  -J, --json              Print the result of a command in JSON format\n  -K, --key string        The PerfOps API key (default is $PERFOPS_API_KEY)\n  -N, --nodeid intSlice   A comma separated list of node IDs to run a test from\n  -v, --version           Prints the version information of perfops\n\nUse \"perfops [command] --help\" for more information about a command.\n```\n\n## Examples\n\nPing google.com from a random server in Eastern Europe\n\n```sh\nperfops ping --from \"eastern europe\" google.com\nNode111, AS2345, Moscow, Russian Federation\nPING google.com (173.194.222.113) 56(84) bytes of data.\n64 bytes from 173.194.222.113: icmp_seq=1 ttl=50 time=11.6 ms\n64 bytes from 173.194.222.113: icmp_seq=2 ttl=50 time=11.4 ms\n64 bytes from 173.194.222.113: icmp_seq=3 ttl=50 time=11.4 ms\n\n--- google.com ping statistics ---\n3 packets transmitted, 3 received, 0% packet loss, time 602ms\nrtt min/avg/max/mdev = 11.433/11.513/11.650/0.157 ms\n```\n\nTraceroute to google.com from a server located in New York\n\n```sh\n perfops traceroute --from \"New York\" google.com\nNode15, AS2345, New York City, United States\ntraceroute to google.com (172.217.10.46), 20 hops max, 60 byte packets\n 1  vl223-ar-02.nyc-ny.atlantic.net (45.58.33.35)  0.432 ms  0.420 ms\n 2  vl30-ar-01.nyc-ny.as6364.net (45.58.33.1)  0.452 ms  0.411 ms\n 3  te0-0-1-1.rcr11.ewr04.atlas.cogentco.com (38.104.44.141)  1.153 ms  1.145 ms\n 4  154.24.52.17 (154.24.52.17)  1.142 ms te0-3-0-4.rcr21.ewr02.atlas.cogentco.com (154.24.9.9)  1.042 ms\n 5  be2390.rcr23.jfk01.atlas.cogentco.com (154.54.80.189)  1.502 ms be2600.rcr23.jfk01.atlas.cogentco.com (154.54.40.29)  1.438 ms\n 6  be2896.ccr41.jfk02.atlas.cogentco.com (154.54.84.201)  2.397 ms  2.193 ms\n 7  be3294.ccr31.jfk05.atlas.cogentco.com (154.54.47.218)  2.319 ms  2.422 ms\n 8  tata.jfk05.atlas.cogentco.com (154.54.12.18)  1.997 ms  1.955 ms\n 9  if-ae-12-2.tcore1.N75-New-York.as6453.net (66.110.96.5)  2.256 ms  2.314 ms\n10  72.14.195.232 (72.14.195.232)  2.125 ms  2.112 ms\n11  * *\n12  216.239.62.169 (216.239.62.169)  1.621 ms 216.239.62.171 (216.239.62.171)  1.501 ms\n13  lga34s13-in-f14.1e100.net (172.217.10.46)  1.826 ms  1.857 ms\n```\n\nCheck ICMP latency from 9 servers located in Europe\n\n```sh\nperfops latency --from europe --limit 9 google.com\nNode92, AS2345, Arezzo, Italy\n7.705\nNode242,AS2315,  Meppel, Netherlands\n2.753\nNode215, AS2325, Nottingham, United Kingdom\n9.861\nNode85, AS2305, Kiev, Ukraine\n15.332\nNode196, AS9345, Riga, Latvia\n47.940\nNode244, AS2375, Zürich, Switzerland\n12.591\nNode194, AS2385, Nuremberg, Germany\n3.697\nNode259, AS2145, Luxembourg, Luxembourg\n7.928\nNode76, AS2645, Vilnius, Lithuania\n24.506\n```\n\n## Setup\n\nIf you are interested in building `perfops` from source, you can install\nit via `go get`:\n\n```sh\ngo get -u github.com/ProspectOne/perfops-cli -o perfops\n```\n\n## Feedback\n\nFeedback is greatly appreciated.\n\n## Contributing\n\nContributions are greatly appreciated. The maintainers actively manage the\nissues list, and try to highlight issues suitable for newcomers. The project\nfollows the typical GitHub pull request model. See\n[CONTRIBUTING.md](CONTRIBUTING.md) for more details. Before starting any\nwork, please either comment on an existing issue, or file a new one.\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProspectOne%2Fperfops-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FProspectOne%2Fperfops-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProspectOne%2Fperfops-cli/lists"}