1 - 介绍
Fortio的介绍，以及Fortio的资料收集
1.1 - fortio
性能测试工具：fortio
介绍
Fortio is a microservices (http, grpc) load testing library, command line tool, advanced echo server, and web UI in go (golang). Fortio allows to specify a set query-per-second load and record latency histograms and other useful stats.
Fortio是一个微服务（http，grpc）负载测试库，命令行工具，高级 echo 服务器，以及go（golang）的web UI。Fortio允许指定一组每秒查询的负载，并记录延迟直方图和其他有用的统计数据。
Fortio (Φορτίο)开始是 Istio 的负载测试工具，现在已经发展成为自己的开源项目。
Fortio以指定的每秒查询次数（qps）运行，记录执行时间的柱状图，并计算百分比（例如，p99即响应时间，如99%的请求耗时少于该数字（秒，SI单位））。它可以运行一个设定的时间，固定的调用次数，或直到中断（在一个恒定的目标QPS，或每个连接/线程的最大速度/负载）。
Fortio的名字来自希腊语φορτίο（Play），意思是负载/负担。
Fortio是一个快速、小型（3MB的docker镜像，最小的依赖性）、可重用、可嵌入的go库以及一个命令行工具和服务器进程，服务器包括一个简单的web UI和结果的图形表示（既有单一的延迟图，也有多个结果的比较min、max、avg、qps和百分比图）。
Fortio还包括一组服务器端的功能（类似于httpbin），以帮助调试和测试：请求echo，包括头文件，添加延迟或错误代码的概率分布，tcp echo，tcp代理，http fan out/ scatter 和收集代理服务器，HTTP 之外的 GRPC echo/健康等等。
Fortio是相当成熟和非常稳定的，没有已知的主要bug（不过如果你想做出贡献，有很多可能的改进！），当发现bug时，他们会很快修复，所以经过1年的开发和42个增量版本，我们在2018年6月达到1.0。
Fortio组件甚至可以用于不相关的项目，例如，日志、统计或fhttp实用程序的客户端和服务器。以及新集成的动态标志支持（最初从https://github.com/mwitkow/go-flagz，受到很大启发/导入）。
参见github.com/fortio/fortio，了解更多关于fortio的信息，查看使用实例和截图，下载最新版本，提交任何问题或以任何其他方式为开源工作做贡献。
你也可以在istio网站的性能和可扩展性部分看到Fortio的现场情况
安装
go get fortio.org/fortio
或者
brew install fortio
命令行参数
Fortio 可以成为一个 http 或 grpc 负载生成器，使用 load 子命令收集统计数据，或者使用 server 命令启动简单的 http 和 grpc ping 服务器，以及一个基本的web用户界面，结果图表，tcp/udp echo，代理，https重定向器，或者使用 grpcping 命令发布 grpc ping 消息。当使用 curl 命令（或 load 命令的 -curl 标志）时，它还可以获取单个URL的数据用于调试。同样地，你可以使用 nc 命令（像独立的 netcat 包）建立一个单一的 TCP（或 unix domain 或 UDP（使用 udp:// 前缀））连接。你可以用 redirect 只运行redirector，或者用 tcp-echo 只运行 tcp echo。如果你保存了 JSON 结果（使用 web UI 或直接从命令行），你可以使用 report 命令浏览和绘制这些结果。version 命令将打印版本和构建信息，fortio version -s 只打印版本。最后，你可以用 help 命令了解哪些标志是可用的。
对于http负载生成最重要的标志:
| Flag | Description, example |
|---|---|
-qps rate |
每秒查询次数，或0表示无等待/最大qps |
-c connections |
并行同时连接的数量（和匹配的 go routine）。 |
-t duration |
运行测试的时间（例如 -t 30m 为30分钟）或0运行到 ^C，示例（默认为5s）。 |
-n numcalls |
准确地运行这个数量的调用，而不是持续时间。默认（0）则使用持续时间（-t）。 |
-payload str or -payload-file fname |
切换到使用给定有效载荷的POST（随机有效载荷见-payload-size）。 |
-uniform |
在线程中分散调用 |
-r resolution |
直方图最低桶的分辨率，以秒为单位（默认为0.001，即1ms），使用你预期典型延迟的1/10。 |
-H "header: value" |
可以多次指定以添加头信息（包括Host:）。 |
-a |
根据标签和时间戳，自动保存带有文件名的JSON结果 |
-json filename |
文件名或 - 用于 stdout 输出 json 结果（默认为相对于-data-dir，如果你想让 fortio report 显示它们，应该以 .json 结尾；使用 -a 通常是一个更好的选择。） |
-labels "l1 l2 ..." |
额外的配置数据/标签添加到生成的JSON中，默认为目标URL和主机名。 |
你可以通过设置 -content-type 或通过 -payload-* 选项之一，从 http GET 查询切换到 POST。
命令行标志的完整列表请见 fortio help。
fortion helo
$ fortio help
Φορτίο 1.23.0 usage:
fortio command [flags] target
where command is one of: load (load testing), server (starts ui, http-echo,
redirect, proxies, tcp-echo and grpc ping servers), tcp-echo (only the tcp-echo
server), report (report only UI server), redirect (only the redirect server),
proxies (only the -M and -P configured proxies), grpcping (grpc client),
or curl (single URL debug), or nc (single tcp or udp:// connection),
or version (prints the version).
where target is a url (http load tests) or host:port (grpc health test).
flags are:
-H header
Additional header(s)
-L Follow redirects (implies -std-client) - do not use for load test
-M value
Http multi proxy to run, e.g -M "localport1 baseDestURL1 baseDestURL2" -M ...
-P value
Tcp proxies to run, e.g -P "localport1 dest_host1:dest_port1" -P "[::1]:0 www.google.com:443" ...
-a Automatically save JSON result with filename based on labels & timestamp
-abort-on code
Http code that if encountered aborts the run. e.g. 503 or -1 for socket errors.
-access-log-file path
file path to log all requests to. Maybe have performance impacts
-access-log-format format
format for access log. Supported values: [json, influx] (default "json")
-allow-initial-errors
Allow and don't abort on initial warmup errors
-base-url URL
base URL used as prefix for data/index.tsv generation. (when empty, the url from the first request is used)
-c int
Number of connections/goroutine/threads (default 4)
-cacert Path
Path to a custom CA certificate file to be used for the TLS client connections, if empty, use https:// prefix for standard internet/system CAs
-calc-qps
Calculate the qps based on number of requests (-n) and duration (-t)
-cert Path
Path to the certificate file to be used for client or server TLS
-compression
Enable http compression
-config path
Config directory path to watch for changes of dynamic flags (empty for no watch)
-content-type string
Sets http content type. Setting this value switches the request method from GET to POST.
-curl
Just fetch the content once
-curl-stdout-headers
Restore pre 1.22 behavior where http headers of the fast client are output to stdout in curl mode. now stderr by default.
-data-dir Directory
Directory where JSON results are stored/read (default ".")
-echo-debug-path URI
http echo server URI for debug, empty turns off that part (more secure) (default "/debug")
-echo-server-default-params value
Default parameters/querystring to use if there isn't one provided explicitly. E.g "status=404&delay=3s"
-gomaxprocs int
Setting for runtime.GOMAXPROCS, <1 doesn't change the default
-grpc
Use GRPC (health check by default, add -ping for ping) for load testing
-grpc-max-streams uint
MaxConcurrentStreams for the grpc server. Default (0) is to leave the option unset.
-grpc-ping-delay duration
grpc ping delay in response
-grpc-port port
grpc server port. Can be in the form of host:port, ip:port or port or /unix/domain/path or "disabled" to not start the grpc server. (default "8079")
-h Print usage/help on stdout
-halfclose
When not keepalive, whether to half close the connection (only for fast http)
-health
grpc ping client mode: use health instead of ping
-healthservice string
which service string to pass to health check
-http-port port
http echo server port. Can be in the form of host:port, ip:port, port or /unix/domain/path. (default "8080")
-http1.0
Use http1.0 (instead of http 1.1)
-httpbufferkb kbytes
Size of the buffer (max data size) for the optimized http client in kbytes (default 128)
-httpccch
Check for Connection: Close Header
-https-insecure
Long form of the -k flag
-jitter
set to true to de-synchronize parallel clients' by 10%
-json path
Json output to provided file path or '-' for stdout (empty = no json output, unless -a is used)
-k Do not verify certs in https connections
-keepalive
Keep connection alive (only for fast http 1.1) (default true)
-key Path
Path to the key file matching the -cert
-labels string
Additional config data/labels to add to the resulting JSON, defaults to target URL and hostname
-log-errors
Log http non 2xx/418 error codes as they occur (default true)
-logcaller
Logs filename and line number of callers to log (default true)
-loglevel value
loglevel, one of [Debug Verbose Info Warning Error Critical Fatal] (default Info)
-logprefix string
Prefix to log lines before logged messages (default "> ")
-max-echo-delay value
Maximum sleep time for delay= echo server parameter. dynamic flag. (default 1.5s)
-maxpayloadsizekb Kbytes
MaxPayloadSize is the maximum size of payload to be generated by the EchoHandler size= argument. In Kbytes. (default 256)
-multi-mirror-origin
Mirror the request url to the target for multi proxies (-M) (default true)
-multi-serial-mode
Multi server (-M) requests one at a time instead of parallel mode
-n int
Run for exactly this number of calls instead of duration. Default (0) is to use duration (-t). Default is 1 when used as grpc ping count.
-nc-dont-stop-on-eof
in netcat (nc) mode, don't abort as soon as remote side closes
-offset duration
Offset of the histogram data
-p string
List of pXX to calculate (default "50,75,90,99,99.9")
-payload string
Payload string to send along
-payload-file path
File path to be use as payload (POST for http), replaces -payload when set.
-payload-size int
Additional random payload size, replaces -payload when set > 0, must be smaller than -maxpayloadsizekb. Setting this switches http to POST.
-ping
grpc load test: use ping instead of health
-profile file
write .cpu and .mem profiles to file
-proxy-all-headers
Determines if only tracing or all headers (and cookies) are copied from request on the fetch2 ui/server endpoint (default true)
-qps float
Queries Per Seconds or 0 for no wait/max qps (default 8)
-quiet
Quiet mode: sets the loglevel to Error and reduces the output.
-r float
Resolution of the histogram lowest buckets in seconds (default 0.001)
-redirect-port port
Redirect all incoming traffic to https URL (need ingress to work properly). Can be in the form of host:port, ip:port, port or "disabled" to disable the feature. (default "8081")
-resolve IP
Resolve host name to this IP
-runid int
Optional RunID to add to json result and auto save filename, to match server mode
-s int
Number of streams per grpc connection (default 1)
-sequential-warmup
http(s) runner warmup done in parallel instead of sequentially. When set, restores pre 1.21 behavior
-server-idle-timeout value
Default IdleTimeout for servers (default 30s)
-static-dir path
Deprecated/unused path.
-stdclient
Use the slower net/http standard client (slower but supports h2)
-sync URL
index.tsv or s3/gcs bucket xml URL to fetch at startup for server modes.
-sync-interval duration
Refresh the url every given interval (default, no refresh)
-t duration
How long to run the test or 0 to run until ^C (default 5s)
-tcp-port port
tcp echo server port. Can be in the form of host:port, ip:port, port or /unix/domain/path or "disabled". (default "8078")
-timeout duration
Connection and read timeout value (for http) (default 3s)
-udp-async
if true, udp echo server will use separate go routine to reply
-udp-port port
udp echo server port. Can be in the form of host:port, ip:port, port or "disabled". (default "8078")
-udp-timeout duration
Udp timeout (default 750ms)
-ui-path URI
http server URI for UI, empty turns off that part (more secure) (default "/fortio/")
-uniform
set to true to de-synchronize parallel clients' requests uniformly
-unix-socket path
Unix domain socket path to use for physical connection
-user user:password
User credentials for basic authentication (for http). Input data format should be user:password
服务器URL和特性
Fortio server 有以下功能，即在 8080 上监听 http（所有路径和端口都可以通过上面的标志进行配置）。
- 简单的 echo 服务器，它将回传发布的数据（对于下面没有提到的任何路径）。
例如，curl -d abcdef http://localhost:8080/ 会返回 abcdef。它支持以下可选的查询参数:
| Parameter | Usage, example |
|---|---|
| delay | 延迟响应的时间。可以是一个单一的值或一个逗号分隔的概率列表，例如 delay=150us:10,2ms:5,0.5s:1 表示有10%的机会出现150us延迟，5%的机会出现2ms延迟，1%的机会出现半秒延迟 |
| status | 返回的 http 状态，而不是200。可以是一个单一的值或一个逗号分隔的概率列表，例如 status=404:10,503:5,429:1 表示出现404状态的概率为10%，503状态为5%，429状态为1%。 |
| size | 响应的有效载荷的大小，而不是 echo 输入。也可以作为概率列表使用。size=1024:10,512:5 10%的响应将是1k，5%将是512字节的有效载荷，其余的默认为 echo。 |
| close | 应答后关闭套接字，例如 close=true 在所有请求后关闭，或者 close=5.3 在约5.3% 的请求后关闭。 |
| header | 要添加到回复中的标头，例如：&header=Foo:Bar&header=X:Y。 |
你可以通过在 server 命令行中传递 -echo-server-default-params 来设置所有这些的默认值，例如：fortio server -echo-server-default-params="delay=0.5s:50,1s:40&status=418" 将使服务器响应http 418，一半时间的延迟为0.5s，40%为1s，10%的呼叫没有延迟；除非客户传递任何 ‘?’ 查询args。请注意，引号（"）是为了让 shell 转义（&），但不应该放在yaml或动态标志的url中。
-
/debug将以纯文本形式 echo 请求，以便于人类调试。 -
/fortio/UI 用于：- 运行/触发测试并绘制结果图。
- 浏览保存的结果的用户界面，单图或多图（最小、平均、中位数、p75、p99、p99.9和最大值的比较图）。
- 代理/获取其他URL
/fortio/data/index.tsv一个符合谷歌云存储URL列表数据传输格式的tab分离值文件，所以你可以导出/备份本地结果到云端。- 从其他Fortio服务器下载/同步点对点的JSON结果文件（使用他们的index.tsv URL）。
- 从亚马逊S3或谷歌云兼容的桶列表中下载/同步XML URLs
-
从运行的服务器上触发和取消运行的API（就像form ui，但更直接，并且有
async=on选项）。/fortio/rest/run启动 run；参数可以来自命令行，也可以来自POST的JSON；可以提供 jsonPath 来寻找json对象的子集，例如 jsonPath=metadata 允许使用flagger webhook元数据作为fortio运行参数（见下面远程触发的负载测试部分）。/fortio/rest/stop停止所有当前运行或按运行ID停止。
报告模式是上述直接在/上的一个只读子集。
还有GRPC health和PING服务器，以及http->https重定向器。
示例和输出实例
启动内部服务器
$ fortio server &
[1] 38147
Fortio 1.23.0 tcp-echo TCP server listening on [::]:8078
Fortio 1.23.0 udp-echo UDP server listening on [::]:8078
Fortio 1.23.0 grpc 'ping' TCP server listening on [::]:8079
Fortio 1.23.0 https redirector TCP server listening on [::]:8081
Fortio 1.23.0 echo TCP server listening on [::]:8080
Data directory is /Users/sky
UI started - visit:
http://localhost:8080/fortio/
(or any host/ip reachable on this server)
07:35:09 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
07:35:09 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
此时访问 http://localhost:8080/fortio/ 可以打开 control UI。
➜ ~ 07:39:16 I http_server.go:487> UI: GET /fortio/ HTTP/1.1 [::1]:53289 () "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.51 Safari/537.36 Edg/99.0.1150.39"
改变端口/绑定地址
默认情况下，Fortio的 Web/echo 服务器在所有接口上都监听8080端口。使用 -http-port 标志来改变这一行为。
$ fortio server -http-port 0.0.0.0:8088
Fortio 1.23.0 tcp-echo TCP server listening on [::]:8078
Fortio 1.23.0 udp-echo UDP server listening on [::]:8078
Fortio 1.23.0 grpc 'ping' TCP server listening on [::]:8079
Fortio 1.23.0 https redirector TCP server listening on [::]:8081
Fortio 1.23.0 echo TCP server listening on [::]:8088
Data directory is /Users/sky
UI started - visit:
http://[::]:8088/fortio/
07:41:39 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
07:41:39 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
Unix domain Socket
你可以为任何服务器/客户端使用 unix domain socket。
$ fortio server --http-port /tmp/fortio-uds-http &
[1] 46551
Fortio 1.23.0 tcp-echo TCP server listening on [::]:8078
Fortio 1.23.0 udp-echo UDP server listening on [::]:8078
Fortio 1.23.0 grpc 'ping' TCP server listening on [::]:8079
Fortio 1.23.0 https redirector TCP server listening on [::]:8081
Fortio 1.23.0 echo TCP server listening on /tmp/fortio-uds-http
Data directory is /Users/sky
UI started - visit:
fortio curl -unix-socket=/tmp/fortio-uds-http http://localhost/fortio/
07:52:53 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
07:52:53 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
此时可以通过 fortio curl -unix-socket=/tmp/fortio-uds-http http://localhost/fortio/ 访问 UI，但这不是浏览器啊，体验就很不好了。
TCP
单独启动 echo-server 并运行一个负载（使用 tcp:// 前缀的负载测试是针对tcp echo server的）。
$ fortio tcp-echo &
[1] 49475
Fortio 1.23.0 tcp-echo TCP server listening on [::]:8078
07:59:00 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
07:59:00 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
启动客户端测试一下：
$ fortio load -qps -1 -n 100000 tcp://localhost:8078
Fortio 1.23.0 running at -1 queries per second, 10->10 procs, for 100000 calls: tcp://localhost:8078
08:00:44 I tcprunner.go:222> Starting tcp test for tcp://localhost:8078 with 4 threads at -1.0 qps
Starting at max qps with 4 thread(s) [gomax 10] for exactly 100000 calls (25000 per thread + 0)
08:00:45 I periodic.go:693> T001 ended after 841.767125ms : 25000 calls. qps=29699.425479463815
08:00:45 I periodic.go:693> T002 ended after 842.130875ms : 25000 calls. qps=29686.597109980088
08:00:45 I periodic.go:693> T003 ended after 843.450958ms : 25000 calls. qps=29640.13469055779
08:00:45 I periodic.go:693> T000 ended after 843.5375ms : 25000 calls. qps=29637.093786583286
Ended after 843.547666ms : 100000 calls. qps=1.1855e+05
Aggregated Function Time : count 100000 avg 3.356944e-05 +/- 1.372e-05 min 1.0916e-05 max 0.000790291 sum 3.35694396
# range, mid point, percentile, count
>= 1.0916e-05 <= 0.000790291 , 0.000400604 , 100.00, 100000
# target 50% 0.0004006
# target 75% 0.000595445
# target 90% 0.000712353
# target 99% 0.000782497
# target 99.9% 0.000789512
Sockets used: 4 (for perfect no error run, would be 4)
Total Bytes sent: 2400000, received: 2400000
tcp OK : 100000 (100.0 %)
All done 100000 calls (plus 0 warmup) 0.034 ms avg, 118546.9 qps
UDP
单独启动 udp-echo 服务器并运行负载（使用tcp://前缀来进行负载测试，用于tcp echo服务器）。
$ fortio udp-echo &
[1] 52500
Fortio 1.23.0 udp-echo UDP server listening on [::]:8078
08:05:14 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
08:05:14 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
启动客户端测试一下：
$ fortio load -qps -1 -n 100000 udp://localhost:8078/
Fortio 1.23.0 running at -1 queries per second, 10->10 procs, for 100000 calls: udp://localhost:8078/
08:06:05 I udprunner.go:223> Starting udp test for udp://localhost:8078/ with 4 threads at -1.0 qps
Starting at max qps with 4 thread(s) [gomax 10] for exactly 100000 calls (25000 per thread + 0)
08:06:05 I periodic.go:693> T000 ended after 495.835667ms : 25000 calls. qps=50419.930763068725
08:06:05 I periodic.go:693> T001 ended after 496.026834ms : 25000 calls. qps=50400.4990988048
08:06:05 I periodic.go:693> T002 ended after 496.076084ms : 25000 calls. qps=50395.495381309294
08:06:05 I periodic.go:693> T003 ended after 497.298834ms : 25000 calls. qps=50271.58378577658
Ended after 497.309334ms : 100000 calls. qps=2.0108e+05
Aggregated Function Time : count 100000 avg 1.9739768e-05 +/- 1.144e-05 min 8.167e-06 max 0.000469792 sum 1.9739768
# range, mid point, percentile, count
>= 8.167e-06 <= 0.000469792 , 0.00023898 , 100.00, 100000
# target 50% 0.000238977
# target 75% 0.000354385
# target 90% 0.000423629
# target 99% 0.000465176
# target 99.9% 0.00046933
Sockets used: 4 (for perfect no error run, would be 4)
Total Bytes sent: 2400000, received: 2400000
udp OK : 100000 (100.0 %)
All done 100000 calls (plus 0 warmup) 0.020 ms avg, 201082.1 qps
gRPC
简单 gRPC ping
启动 grpc echo server:
$ fortio server -grpc
Fortio 1.23.0 tcp-echo TCP server listening on [::]:8078
Fortio 1.23.0 udp-echo UDP server listening on [::]:8078
Fortio 1.23.0 grpc 'ping' TCP server listening on [::]:8079
Fortio 1.23.0 https redirector TCP server listening on [::]:8081
Fortio 1.23.0 echo TCP server listening on [::]:8080
Data directory is /Users/sky
UI started - visit:
http://localhost:8080/fortio/
(or any host/ip reachable on this server)
08:12:48 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
08:12:48 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
运行 grpc ping 测试：
$ fortio grpcping -n 5 localhost
08:14:56 I pingsrv.go:151> Ping RTT 196666 (avg of 173000, 215000, 202000 ns) clock skew 25500
08:14:56 I pingsrv.go:151> Ping RTT 169666 (avg of 142000, 175000, 192000 ns) clock skew 20500
08:14:56 I pingsrv.go:151> Ping RTT 151666 (avg of 153000, 156000, 146000 ns) clock skew 10000
08:14:56 I pingsrv.go:151> Ping RTT 183000 (avg of 185000, 175000, 189000 ns) clock skew -500
08:14:56 I pingsrv.go:151> Ping RTT 154333 (avg of 160000, 161000, 142000 ns) clock skew 500
Clock skew histogram usec : count 5 avg 11.2 +/- 10.43 min -0.5 max 25.5 sum 56
# range, mid point, percentile, count
>= -0.5 <= 0 , -0.25 , 20.00, 1
> 0 <= 2 , 1 , 40.00, 1
> 8 <= 10 , 9 , 60.00, 1
> 18 <= 22 , 20 , 80.00, 1
> 22 <= 25.5 , 23.75 , 100.00, 1
# target 50% 9
RTT histogram usec : count 15 avg 171.06667 +/- 21.56 min 142 max 215 sum 2566
# range, mid point, percentile, count
>= 142 <= 160 , 151 , 40.00, 6
> 160 <= 180 , 170 , 66.67, 4
> 180 <= 200 , 190 , 86.67, 3
> 200 <= 215 , 207.5 , 100.00, 2
# target 50% 167.5
改变grpc的目标端口
在 grpcping 中指定一个主机名或IP地址时，会使用 -grpc-port 的值（默认为8079）。在 grpcping 的目标中添加 :port 来改变这种行为。
启动 grpc echo server，通过 -grpc-port 8018 指定 grpc echo 端口 :
$ fortio server -grpc -grpc-port 8018
Fortio 1.23.0 tcp-echo TCP server listening on [::]:8078
Fortio 1.23.0 udp-echo UDP server listening on [::]:8078
Fortio 1.23.0 grpc 'ping' TCP server listening on [::]:8018
Fortio 1.23.0 https redirector TCP server listening on [::]:8081
Fortio 1.23.0 echo TCP server listening on [::]:8080
Data directory is /Users/sky
UI started - visit:
http://localhost:8080/fortio/
(or any host/ip reachable on this server)
08:17:57 I fortio_main.go:283> Note: not using dynamic flag watching (use -config to set watch directory)
08:17:57 I fortio_main.go:291> All fortio 1.23.0 2022-03-25 02:08 8c28aec56c639807472392db3b0ebb3fd5d448ed go1.18 servers started!
运行 grpc ping 测试，通过在地址后面增加 :8018 来指定端口：
$ fortio grpcping -n 5 localhost:8018
08:19:28 I pingsrv.go:151> Ping RTT 120000 (avg of 121000, 117000, 122000 ns) clock skew 7500
08:19:28 I pingsrv.go:151> Ping RTT 122000 (avg of 118000, 128000, 120000 ns) clock skew 2000
08:19:28 I pingsrv.go:151> Ping RTT 118333 (avg of 131000, 114000, 110000 ns) clock skew 3000
08:19:28 I pingsrv.go:151> Ping RTT 136333 (avg of 134000, 140000, 135000 ns) clock skew -4000
08:19:28 I pingsrv.go:151> Ping RTT 145333 (avg of 106000, 163000, 167000 ns) clock skew 36500
Clock skew histogram usec : count 5 avg 9 +/- 14.23 min -4 max 36.5 sum 45
# range, mid point, percentile, count
>= -4 <= -4 , -4 , 20.00, 1
> 0 <= 2 , 1 , 40.00, 1
> 2 <= 4 , 3 , 60.00, 1
> 6 <= 8 , 7 , 80.00, 1
> 30 <= 36.5 , 33.25 , 100.00, 1
# target 50% 3
RTT histogram usec : count 15 avg 128.4 +/- 17.04 min 106 max 167 sum 1926
# range, mid point, percentile, count
>= 106 <= 110 , 108 , 13.33, 2
> 110 <= 120 , 115 , 40.00, 4
> 120 <= 140 , 130 , 86.67, 7
> 160 <= 167 , 163.5 , 100.00, 2
# target 50% 124.286
使用 TLS 进行 grpcping
TBD
GRPC到标准HTTPS服务
grpcping 可以通过在目的地前加上 https://，连接到一个非Fortio TLS服务器。
TBD：会报错
fortio grpcping https://fortio.io
08:23:17 I grpcrunner.go:280> stripping https scheme. grpc destination: fortio.io. grpc port: 443
08:23:17 E pingsrv.go:119> grpc error from Ping0 rpc error: code = Unavailable desc = connection error: desc = "transport: authentication handshake failed: EOF"
简单负载测试
负载（低默认qps/线程）测试：
$ fortio load http://cn.bing.com
Fortio 1.23.0 running at 8 queries per second, 10->10 procs, for 5s: http://cn.bing.com
08:25:38 I httprunner.go:87> Starting http test for http://cn.bing.com with 4 threads at 8.0 qps and parallel warmup
Starting at 8 qps with 4 thread(s) [gomax 10] for 5s : 10 calls each (total 40)
08:25:43 I periodic.go:693> T003 ended after 5.166413959s : 10 calls. qps=1.9355785423620175
08:25:43 I periodic.go:693> T001 ended after 5.183228s : 10 calls. qps=1.9292996565074894
08:25:43 I periodic.go:693> T002 ended after 5.187237542s : 10 calls. qps=1.9278083795145389
08:25:43 I periodic.go:693> T000 ended after 5.19214325s : 10 calls. qps=1.9259869226450945
Ended after 5.192197459s : 40 calls. qps=7.7039
Sleep times : count 36 avg 0.37322796 +/- 0.02494 min 0.238568277 max 0.393221374 sum 13.4362066
Aggregated Function Time : count 40 avg 0.18119194 +/- 0.02388 min 0.16124825 max 0.315697375 sum 7.24767762
# range, mid point, percentile, count
>= 0.161248 <= 0.18 , 0.170624 , 62.50, 25
> 0.18 <= 0.2 , 0.19 , 95.00, 13
> 0.2 <= 0.25 , 0.225 , 97.50, 1
> 0.3 <= 0.315697 , 0.307849 , 100.00, 1
# target 50% 0.176093
# target 75% 0.187692
# target 90% 0.196923
# target 99% 0.309418
# target 99.9% 0.315069
Sockets used: 4 (for perfect keepalive, would be 4)
Uniform: false, Jitter: false
Code 200 : 40 (100.0 %)
Response Header Sizes : count 40 avg 1855 +/- 0 min 1855 max 1855 sum 74200
Response Body/Total Sizes : count 40 avg 80185.625 +/- 21.12 min 80172 max 80239 sum 3207425
All done 40 calls (plus 4 warmup) 181.192 ms avg, 7.7 qps
远程触发的负载测试（服务器模式的rest API）。
从1.18开始，服务器有一个 fortio/rest/run 端点，类似于 form UI 在 fortio/ 中提交的启动运行。
- 加上
async查询参数或 json 值 “on” 将使运行成为异步的（只返回运行的 runid 而不是等待结果）。 - 加上从查询参数或 jsonPath 发布的信息中读取所有的运行配置
- 与 flagger 和其他 webhooks 兼容
- 1.22 版中的新功能：使用 headers json 数组来发送头信息（或多个&H=查询条件）。
示例：
TBD
gRPC 负载测试
使用 -s 来使用每个连接（-c）的多个（h2/grpc）流，请求击中 fortio ping grpc 端点，回复延迟 0.25 s，并有10字节的额外有效载荷，自动保存json结果。
$ fortio load -a -grpc -ping -grpc-ping-delay 0.25s -payload "01234567890" -c 2 -s 4 https://cn.bing.com
实现细节
Fortio 是用 Go 语言编写的，包括 stats.go 中的可扩展的半日志直方图和 periodic.go 中的周期性运行引擎，并对 http 和 grpc 进行了专门化。http/ 软件包包括一个非常高性能的专门的http 1.1客户端。你可能会发现fortio的记录器也很有用。
你可以在 histogram/ 中作为命令行独立运行直方图代码，在 echosrv/ 中运行基本的http echo 服务器，或者通过 fortio server 运行http echo 和 GRPC ping 服务器，fortio 的命令行界面位于这个顶级目录 fortio_main.go 中。
还有 fcurl/ 是 fortio curl 部分的代码（如果你需要一个没有grpc或服务器端的轻型http客户端）。一个匹配的小（2Mb压缩）docker镜像是 fortio/fortio.fcurl
1.2 - 资料收集
收集Fortio的各种资料