[{"_1":2,"_158":-5,"_159":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_146":147},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)",{"_23":24,"_25":26,"_71":72,"_85":-7,"_86":-7,"_87":-7,"_88":-7,"_89":-5,"_90":-5,"_91":11,"_92":11,"_65":93,"_137":11,"_109":60,"_138":108,"_139":64,"_40":41,"_140":11,"_141":17,"_142":43,"_143":-5,"_144":11,"_145":11},"scanningType","none","tagData",{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_56":57,"_58":30,"_59":60,"_61":62,"_63":64,"_65":66,"_67":45,"_68":57,"_69":54,"_70":17},"content_type","image","creator",385760,"full_size",1619534,"id",13658623,"images",[37],{"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":43,"_51":-5,"_52":32,"_53":54,"_55":-5},"architecture","amd64","digest","sha256:b34135b65f2b6275bd2ffa4b21e18c0be6a89eab01aadcde1b7b44579521fc52","features","","last_pulled","2026-09-24T19:57:34.241317443Z","last_pushed","2017-08-03T04:28:24Z","os","linux","os_features","os_version","size","status","active","variant","last_updated","2017-08-03T04:43:00.934932Z","last_updater","last_updater_username","ldemailly","media_type","application/vnd.docker.container.image.v1+json","name","170802_214257","repository",1705761,"tag_last_pulled","tag_last_pushed","tag_status","v2","tagImages",[73],{"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_74":75,"_48":49,"_50":43,"_51":-5,"_52":32,"_53":54,"_55":-5},"layers",[76,80,83],{"_52":77,"_78":79,"_40":43},0,"instruction"," EXPOSE 8080/tcp",{"_40":81,"_52":32,"_78":82},"sha256:e80d5a780f898e3d2ee47506a17bb1c878ec05c8afe4ce2d1df7e7c873f257d6","ADD file:68b3c64c369146a76beb7d98b7744d758967a6e62f84e479ec2d6a1ff9619291 in /usr/local/bin/echosrv ",{"_52":77,"_78":84,"_40":43}," ENTRYPOINT [\"/usr/local/bin/echosrv\"]","layerOrdinals","packageName","cveId","sbom","scoutSummary","staticSummary","isScoutPaymentRequired","canSeeVulnerabilities",{"_94":95,"_96":97,"_98":99,"_100":101,"_102":11,"_56":103,"_104":105,"_106":107,"_63":108,"_109":60,"_110":111,"_112":28,"_113":77,"_53":114,"_115":54,"_116":-5,"_117":77,"_118":119,"_120":11,"_121":60,"_122":123,"_128":11,"_129":130,"_134":60,"_135":136},"categories",[],"content_types",[28],"date_registered","2017-08-03T04:08:59.850416Z","description","Moved to https://hub.docker.com/r/fortio/fortio/","is_private","2017-11-16T03:27:50.742352Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[62],"fortio","namespace","pull_count",24010,"repository_type","star_count",1,"status_description","source","collaborator_count","full_description","# Φορτίο\n

\n\nΦορτίο (fortio) is [Istio](https://istio.io/)'s load testing tool. Fortio runs at a specified query per second (qps) and records an histogram of execution time and calculates percentiles (e.g. p99 ie the response time such as 99% of the requests take less than that number (in seconds, SI unit))\n\nThe name fortio comes from greek φορτίο which is load/burden.\n\nFortio is a reusable, embeddable go library as well as a command line tool and server process.\n\n## Installation\n\n1. [Install go](https://golang.org/doc/install) (golang 1.8 or later)\n2. `go get -u istio.io/fortio`\n3. you can now run `fortio` (from your gopath bin/ directory)\n\nOr use docker, for instance:\n\n```shell\ndocker run -p 8080:8080 -p 8079:8079 istio/fortio server &\ndocker run istio/fortio load http://$HOSTNAME:8080/\n```\n\n## Command line arguments\n\nFortio can be an http or grpc load generator, gathering statistics using the `load` command, or start simple http and grpc ping servers, as well as a basic web UI, with the `server` command or issue grpc ping messages using the `grpcping` command. It can also fetch a single URL's content using the `-curl` flag to the load command.\n\n```\n$ fortio\nΦορτίο 0.3.6 usage:\n\tfortio command [flags] target\nwhere command is one of: load (load testing), server (starts grpc ping and http echo/ui servers), grpcping (grpc client)\nwhere target is a url (http load tests) or host:port (grpc health test)\nand flags are:\n -H value\n \tAdditional Header(s)\n -c int\n \tNumber of connections/goroutine/threads (default 4)\n -compression\n \tEnable http compression\n -curl\n \tJust fetch the content once\n -echo-debug-path string\n \thttp echo server URI for debug, empty turns off that part (more secure) (default \"/debug\")\n -gomaxprocs int\n \tSetting for runtime.GOMAXPROCS, <1 doesn't change the default\n -grpc\n \tUse GRPC (health check) for load testing\n -grpc-port int\n \tgrpc port (default 8079)\n -halfclose\n \tWhen not keepalive, whether to half close the connection (only for fast http)\n -health\n \tclient mode: use health instead of ping\n -healthservice string\n \twhich service string to pass to health check\n -http-port int\n \thttp echo server port (default 8080)\n -http1.0\n \tUse http1.0 (instead of http 1.1)\n -httpbufferkb int\n \tSize of the buffer (max data size) for the optimized http client in kbytes (default 128)\n -httpccch\n \tCheck for Connection: Close Header\n -json string\n \tJson output to provided file or '-' for stdout (empty = no json output)\n -keepalive\n \tKeep connection alive (only for fast http 1.1) (default true)\n -logcaller\n \tLogs filename and line number of callers to log (default true)\n -loglevel value\n \tloglevel, one of [Debug Verbose Info Warning Error Critical Fatal] (default Info)\n -logprefix string\n \tPrefix to log lines before logged messages (default \"> \")\n -n int\n \thow many ping(s) the client will send (default 1)\n -p string\n \tList of pXX to calculate (default \"50,75,99,99.9\")\n -payload string\n \tPayload string to send along\n -profile string\n \twrite .cpu and .mem profiles to file\n -qps float\n \tQueries Per Seconds or 0 for no wait/max qps (default 8)\n -r float\n \tResolution of the histogram lowest buckets in seconds (default 0.001)\n -stdclient\n \tUse the slower net/http standard client (works for TLS)\n -t duration\n \tHow long to run the test or 0 to run until ^C (default 5s)\n -ui-path string\n \thttp server URI for UI, empty turns off that part (more secure) (default \"/fortio/\")\n```\n\n## Example use and output\n\n* Start the internal servers:\n```\n$ fortio server &\nUI starting - visit:\nhttp://localhost:8080/fortio/\nFortio 0.3.6 echo server listening on port 8080\nFortio 0.3.6 grpc ping server listening on port 8079\n```\n* Simple grpc ping:\n```\n$ fortio grpcping localhost\n02:29:27 I pingsrv.go:116> Ping RTT 305334 (avg of 342970, 293515, 279517 ns) clock skew -2137\nClock skew histogram usec : count 1 avg -2.137 +/- 0 min -2.137 max -2.137 sum -2.137\n# range, mid point, percentile, count\n>= -4 < -2 , -3 , 100.00, 1\n# target 50% -2.137\nRTT histogram usec : count 3 avg 305.334 +/- 27.22 min 279.517 max 342.97 sum 916.002\n# range, mid point, percentile, count\n>= 250 < 300 , 275 , 66.67, 2\n>= 300 < 350 , 325 , 100.00, 1\n# target 50% 294.879\n```\n* Load (low default qps/threading) test:\n```\n$ fortio load http://www.google.com\nFortio 0.3.6 running at 8 queries per second, 8->8 procs, for 5s: http://www.google.com\n19:10:33 I httprunner.go:84> Starting http test for http://www.google.com with 4 threads at 8.0 qps\nStarting at 8 qps with 4 thread(s) [gomax 8] for 5s : 10 calls each (total 40)\n19:10:39 I periodic.go:314> T002 ended after 5.056753279s : 10 calls. qps=1.9775534712220633\n19:10:39 I periodic.go:314> T001 ended after 5.058085991s : 10 calls. qps=1.9770324224999916\n19:10:39 I periodic.go:314> T000 ended after 5.058796046s : 10 calls. qps=1.9767549252963101\n19:10:39 I periodic.go:314> T003 ended after 5.059557593s : 10 calls. qps=1.9764573910247019\nEnded after 5.059691387s : 40 calls. qps=7.9056\nSleep times : count 36 avg 0.49175757 +/- 0.007217 min 0.463508712 max 0.502087879 sum 17.7032725\nAggregated Function Time : count 40 avg 0.060587641 +/- 0.006564 min 0.052549016 max 0.089893269 sum 2.42350566\n# range, mid point, percentile, count\n>= 0.052549 < 0.06 , 0.0562745 , 47.50, 19\n>= 0.06 < 0.07 , 0.065 , 92.50, 18\n>= 0.07 < 0.08 , 0.075 , 97.50, 2\n>= 0.08 <= 0.0898933 , 0.0849466 , 100.00, 1\n# target 50% 0.0605556\n# target 75% 0.0661111\n# target 99% 0.085936\n# target 99.9% 0.0894975\nCode 200 : 40\nResponse Header Sizes : count 40 avg 690.475 +/- 15.77 min 592 max 693 sum 27619\nResponse Body/Total Sizes : count 40 avg 12565.2 +/- 301.9 min 12319 max 13665 sum 502608\nAll done 40 calls (plus 4 warmup) 60.588 ms avg, 7.9 qps\n```\n\n## Implementation details\n\nFortio is written in the [Go](https://golang.org) language and includes a scalable semi log histogram in [stats.go](stats/stats.go) and a periodic runner engine in [periodic.go](periodic/periodic.go) with specializations for [http](http/httprunner.go) and [grpc](fortiogrpc/grpcrunner.go).\nThe [http/](http/) package includes a very high performance specialized http 1.1 client.\nYou may find fortio's [logger](log/logger.go) useful as well.\n\nYou can run the histogram code standalone as a command line in [histogram/](histogram/), a basic echo http server in [echosrv/](echosrv/), or both the http echo and GRPC ping server through `fortio server`, the fortio command line interface lives in this top level directory [fortio_main.go](fortio_main.go)\n\n## Another example output\n\nWith 5k qps: (includes envoy and mixer in the calls)\n```\n$ time fortio load -qps 5000 -t 60s -c 8 -r 0.0001 -H \"Host: perf-cluster\" http://benchmark-2:9090/echo\n2017/07/09 02:31:05 Will be setting special Host header to perf-cluster\nFortio running at 5000 queries per second for 1m0s: http://benchmark-2:9090/echo\nStarting at 5000 qps with 8 thread(s) [gomax 4] for 1m0s : 37500 calls each (total 300000)\n2017/07/09 02:32:05 T004 ended after 1m0.000907812s : 37500 calls. qps=624.9905437680746\n2017/07/09 02:32:05 T000 ended after 1m0.000922222s : 37500 calls. qps=624.9903936684861\n2017/07/09 02:32:05 T005 ended after 1m0.00094454s : 37500 calls. qps=624.9901611965524\n2017/07/09 02:32:05 T006 ended after 1m0.000944816s : 37500 calls. qps=624.9901583216429\n2017/07/09 02:32:05 T001 ended after 1m0.00102094s : 37500 calls. qps=624.9893653892883\n2017/07/09 02:32:05 T007 ended after 1m0.001096292s : 37500 calls. qps=624.9885805003184\n2017/07/09 02:32:05 T003 ended after 1m0.001045342s : 37500 calls. qps=624.9891112105419\n2017/07/09 02:32:05 T002 ended after 1m0.001044416s : 37500 calls. qps=624.9891208560392\nEnded after 1m0.00112695s : 300000 calls. qps=4999.9\nAggregated Sleep Time : count 299992 avg 8.8889218e-05 +/- 0.002326 min -0.03490402 max 0.001006041 sum 26.6660543\n# range, mid point, percentile, count\n< 0 , 0 , 8.58, 25726\n>= 0 < 0.001 , 0.0005 , 100.00, 274265\n>= 0.001 < 0.002 , 0.0015 , 100.00, 1\n# target 50% 0.000453102\nWARNING 8.58% of sleep were falling behind\nAggregated Function Time : count 300000 avg 0.00094608764 +/- 0.0007901 min 0.000510522 max 0.029267604 sum 283.826292\n# range, mid point, percentile, count\n>= 0.0005 < 0.0006 , 0.00055 , 0.15, 456\n>= 0.0006 < 0.0007 , 0.00065 , 3.25, 9295\n>= 0.0007 < 0.0008 , 0.00075 , 24.23, 62926\n>= 0.0008 < 0.0009 , 0.00085 , 62.73, 115519\n>= 0.0009 < 0.001 , 0.00095 , 85.68, 68854\n>= 0.001 < 0.0011 , 0.00105 , 93.11, 22293\n>= 0.0011 < 0.0012 , 0.00115 , 95.38, 6792\n>= 0.0012 < 0.0014 , 0.0013 , 97.18, 5404\n>= 0.0014 < 0.0016 , 0.0015 , 97.94, 2275\n>= 0.0016 < 0.0018 , 0.0017 , 98.34, 1198\n>= 0.0018 < 0.002 , 0.0019 , 98.60, 775\n>= 0.002 < 0.0025 , 0.00225 , 98.98, 1161\n>= 0.0025 < 0.003 , 0.00275 , 99.21, 671\n>= 0.003 < 0.0035 , 0.00325 , 99.36, 449\n>= 0.0035 < 0.004 , 0.00375 , 99.47, 351\n>= 0.004 < 0.0045 , 0.00425 , 99.57, 290\n>= 0.0045 < 0.005 , 0.00475 , 99.66, 280\n>= 0.005 < 0.006 , 0.0055 , 99.79, 380\n>= 0.006 < 0.007 , 0.0065 , 99.82, 92\n>= 0.007 < 0.008 , 0.0075 , 99.83, 15\n>= 0.008 < 0.009 , 0.0085 , 99.83, 5\n>= 0.009 < 0.01 , 0.0095 , 99.83, 1\n>= 0.01 < 0.012 , 0.011 , 99.83, 8\n>= 0.012 < 0.014 , 0.013 , 99.84, 35\n>= 0.014 < 0.016 , 0.015 , 99.92, 231\n>= 0.016 < 0.018 , 0.017 , 99.94, 65\n>= 0.018 < 0.02 , 0.019 , 99.95, 26\n>= 0.02 < 0.025 , 0.0225 , 100.00, 139\n>= 0.025 < 0.03 , 0.0275 , 100.00, 14\n# target 50% 0.000866935\n# target 75% 0.000953452\n# target 99% 0.00253875\n# target 99.9% 0.0155152\nCode 200 : 300000\nResponse Body Sizes : count 300000 avg 0 +/- 0 min 0 max 0 sum 0\n```\n\nOr graphically (through the [http://localhost:8080/fortio/](http://localhost:8080/fortio/) web UI):\n\nSimple form/UI:\n\n![Web UI form screenshot](https://user-images.githubusercontent.com/3664595/32871761-c733f966-ca37-11e7-9d4e-8c31f98fcd4e.png)\n\n\nRun result:\n\n![Graphical result](https://user-images.githubusercontent.com/3664595/32871636-1e2531c8-ca37-11e7-8e2b-0aafe8d4305b.png)\n\n## Contributing\nContributions whether throuh issues, documentation, bug fixes, or new features\nare most welcome !\n\nPlease also see [Istio's guidelines](https://github.com/istio/istio#contributing-to-the-project)\n\nAnd make sure to run those commands successfully before sending your PRs:\n```\nmake test\nmake lint\n```\n","has_starred","hub_user","immutable_tags_settings",{"_124":11,"_125":126},"enabled","rules",[127],".*","is_automated","permissions",{"_131":17,"_132":11,"_133":11},"read","write","admin","user","storage_size",182025151,"isOrg","reponame","tag","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","showSbxLogoOverride","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_23":24,"_87":-7,"_85":-7,"_86":-7,"_25":148,"_40":41,"_151":152,"_157":11},{"_27":28,"_29":30,"_31":32,"_33":34,"_35":149,"_56":57,"_58":30,"_59":60,"_61":62,"_63":64,"_65":66,"_67":45,"_68":57,"_69":54,"_70":17},[150],{"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":43,"_51":-5,"_52":32,"_53":54,"_55":-5},"imageWithLayers",{"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_74":153,"_48":49,"_50":43,"_51":-5,"_52":32,"_53":54,"_55":-5},[154,155,156],{"_52":77,"_78":79,"_40":43},{"_40":81,"_52":32,"_78":82},{"_52":77,"_78":84,"_40":43},"hasPermissionToViewRepoSettings","actionData","errors"]

ldemailly/fortio:170802_214257