Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

ghz

ghz.sh

  • Free plan
  • Linux
  • API
  • Self-hosted
7.4 Club score Visit ghz.sh

What ghz is

ghz is a free command-line utility and Go package for load testing and benchmarking gRPC services. It can support local debugging and performance regression checks in automated CI environments. Tests can define a service with a .proto file, a compiled protoset bundle, or server reflection, and can exercise unary, streaming, or duplex calls using JSON or binary data. Request rates can follow constant, step, or linear schedules. Go templates can generate request data and metadata for each call using variables such as worker ID, request number, method name, and timestamps. The CLI can emit summary, CSV, HTML, JSON, Prometheus text exposition, and InfluxDB line protocol results. Its complementary ghz-web tool is a beta server and web application for storing and comparing reports over time. Reports can be grouped into projects, and the web app supports SQLite, MySQL, and PostgreSQL. Installation options include prebuilt executables, Homebrew, or building from source.

Who it suits

ghz suits developers and teams who need to exercise gRPC services locally or include performance checks in CI. Its beta web companion can help teams keep and compare test reports over time.

Good to know, and what to watch

  • Tests unary, streaming, and duplex calls.
  • Supports server reflection and proto-based definitions.
  • Load rates can use constant, step, or linear schedules.
  • CLI offers several report output formats.
  • The ghz-web companion is labeled beta.
  • The web application is self-hosted.
  • Some TLS options allow skipping verification or using plaintext.

ghz

Free

Free plan

The Club's review

ghz is a free command-line tool and Go package for putting gRPC services under controlled load. It suits developers and platform teams running local diagnostics, benchmark work, and repeatable performance checks in CI. Its testing engine is unusually configurable for an open-source utility, while result tracking requires the separately deployed beta ghz-web companion.

The practical choice is straightforward: use ghz when programmable load generation and automation matter more than a polished desktop interface; look elsewhere if you need a finished hosted workspace.

Overview

ghz focuses on gRPC load testing and benchmarking rather than general API exploration. It can be used directly from the CLI or embedded as a Go package, which makes it suitable for scripts, regression gates, and custom tooling. The Apache-2.0 license and self-hosted deployment model are well suited to teams that need control over execution and data.

ghz-web adds a server and web application for storing, viewing, comparing, and tracking reports. It is explicitly beta, so it is better treated as an operational add-on than as a mature hosted service. Teams must deploy and maintain it themselves.

Key features

Service definitions can come from a .proto file, a compiled protoset bundle, or server reflection. That covers repositories with source definitions, pipelines that publish descriptor bundles, and endpoints where reflection is enabled. ghz exercises unary, streaming, and duplex RPCs with either JSON or binary payloads, giving it reach beyond simple request-response tests.

Constant, step, and linear schedules control how request rates change. These patterns support steady-state checks, ramps, and staged pressure, but realistic scenarios still depend on the author choosing appropriate rates and durations. Go template actions can generate request data and metadata for every request, with values such as worker ID, request number, method name, and timestamps. This enables varied, reproducible inputs while leaving workload modeling responsibility with the test author.

Reports can be emitted as summary, CSV, HTML, JSON, pretty JSON, Prometheus text exposition, or InfluxDB line protocol. The documented Grafana dashboards and InfluxDB workflow make the CLI usable with existing observability systems, and Prototool usage is also covered. TLS configuration includes CA certificates, client certificates and keys, and server-name override; plaintext and skipped certificate verification are available for controlled environments but require care.

Installation is flexible: use a prebuilt executable, Homebrew, or build with make or Go. ghz-web is likewise distributed as a prebuilt executable and accepts environment-variable or configuration-file settings.

Pricing

The ghz plan costs free. It includes the open-source gRPC load-testing CLI and Go package without a paid tier or stated trial restriction. The web companion is complementary rather than a separately priced hosted service, so teams choosing it should budget for their own deployment and operations.

Platforms

ghz is available for Linux and is designed for API and self-hosted use. Its executable and source-build options fit developer workstations and CI runners. ghz-web can run as a self-hosted server with SQLite, MySQL, or PostgreSQL, configured through environment variables or YAML, TOML, or JSON.

Who it's for

Choose ghz for engineers who need repeatable gRPC performance checks, local debugging, or automated CI regression testing. It is especially appropriate for Go teams that want a package as well as a command-line workflow, and for organizations already operating Prometheus, InfluxDB, or Grafana.

It is less suitable for users seeking a point-and-click client, a managed results service, or a finished collaboration portal. The templating and schedule controls are powerful, but they reward engineers comfortable designing and maintaining test scenarios.

Pros and cons

Pros

  • Broad gRPC coverage: unary, streaming, and duplex calls work with JSON or binary data.
  • Flexible test inputs: proto files, protosets, and reflection accommodate different service-definition workflows.
  • Programmable load: constant, step, and linear schedules plus per-request Go templates support varied traffic models.
  • Automation-friendly outputs: structured formats and Prometheus or InfluxDB protocols fit CI and monitoring pipelines.
  • Open deployment: Apache-2.0 licensing and self-hosting avoid vendor lock-in.

Cons

  • Web interface is beta: ghz-web is not a finished hosted product and must be operated by the customer.
  • Scenario design is manual: realistic dynamic data and load rates require engineering judgment.
  • Security options demand discipline: plaintext and skipped TLS verification can weaken protection if misused.

Alternatives

For a broader directory of gRPC utilities, browse gRPC Tools.

Kreya is the better pick for a cross-platform graphical client with a free individual plan, though its free tier keeps only the latest request in history and it is not open source.

Choose protoc-gen-doc when the goal is generating documentation from Protocol Buffers rather than driving load tests.

Sabledocs suits teams wanting an open-source static documentation generator that requires Python 3.11+ and a Protobuf descriptor file.

FintX is a better fit for interactive gRPC client work, offering unlimited clients, request saving, projects, and method tabs on its free open-source plan.

grpcmd is appropriate for sending requests, starting a server, reflection, and JavaScript scripting from a CLI; its grpcmd-script plan costs $9 a year.

gRPC CLI is a minimal free option for building from source and making unary RPC calls.

grpcmock-go is aimed at Go developers needing gRPC testing utilities rather than a load-generation workflow.

ProtoCall offers a free app with GitHub imports and manually created workspaces when a web and desktop-oriented client is preferable.

Verdict

ghz is the right choice for developers and infrastructure teams that want free, scriptable gRPC load testing with configurable traffic, dynamic payloads, and CI-ready reports. Its main reason to choose it is the combination of protocol coverage and automation-friendly output. Look elsewhere if you need a polished GUI or managed result storage; ghz-web is beta and self-hosted, not a turnkey service.

The verdict

ghz provides a free CLI and Go package with flexible gRPC test inputs, call types, and load patterns. Treat ghz-web as a beta companion rather than a finished hosted service.

What the maker publishes

API
ghz-web provides ingest endpoints for raw JSON reports, including an endpoint that creates a project automatically. source
Call types
The maker says ghz can test unary, streaming, and duplex calls using JSON or binary data. source
Custom request data
Request data and metadata can use Go template actions evaluated for every request, with variables such as worker ID, request number, method name, and timestamps. source
Dynamic data
Go templates and template functions can generate request data and metadata for each request. source
Ingest API
The web server provides POST /api/ingest to create a project and ingest a report, or POST /api/projects/:id/ingest to add a report to an existing project. source
Installation
The maker documents prebuilt executable downloads, Homebrew installation, and building from source with make or Go. source
Installation
The maker documents downloadable operating-system binaries, Homebrew, source builds, and Docker installation. source
Integrations
The documentation includes prebuilt Grafana dashboards and describes InfluxDB output and use with Prototool. source
License
The GitHub repository identifies the project license as Apache-2.0. source
Load patterns
Load options include constant, step, and linear request rates. source
Load schedules
Load can use constant, step, or line schedules to control request rates. source
Output formats
Results can be emitted as summary, CSV, JSON, pretty JSON, HTML, Prometheus text, or InfluxDB line protocol. source
Pricing and trial
The maker's opened pages describe ghz as a complementary tool and do not state a price or trial offer. source
Protocol definitions
Tests can use a .proto file, a compiled protoset bundle, or server reflection. source
Protocol inputs
ghz can use a proto file, a prebuilt protoset bundle, or server reflection. source
Purpose
ghz is a command line utility and Go package for load testing and benchmarking gRPC services, including local debugging and performance regression testing in automated CI environments. source
Report formats
The CLI documents summary, CSV, HTML, JSON, Prometheus text exposition, and InfluxDB line protocol output formats. source
RPC patterns
ghz supports unary, streaming, and duplex calls using JSON or binary data. source
Security options
The CLI documents CA certificates, client certificates and keys, server-name override, and options to skip TLS verification or use plaintext connections. source
Self-hosted storage
ghz-web supports SQLite, MySQL, and PostgreSQL databases and can be configured with environment variables or a YAML, TOML, or JSON file. source
Support
The site links to the guide, Go documentation, GitHub repository, and a community support link labeled “Say Thanks!”. source
Web application
The beta ghz-web companion stores, displays, compares, and tracks test results over time. source
Web companion
ghz-web is a complementary server and web application for storing, viewing, and comparing ghz test results; the maker labels it beta. source
Web report status
Reports and projects have OK or FAIL status, and a project reflects the status of its latest report. source

Checked against the maker's pages on 4 Oct 2026.