Skip to content

fogfish/typhoon

Repository files navigation

Typhoon





Makes latency assessments of distributed systems build from microservices.

Build Status GitHub release

Typhoon is a stress and load testing tool for distributed systems that simulates traffic from a test cluster toward a system-under-test (SUT) and visualizes infrastructure-, protocol- and application-related latencies. It provides an out-of-the-box, cross-platform solution for investigating protocols and microservices latencies, and is operable as a standalone application. For scalability and accuracy, its runtime environment is Erlang.

Key Features and Functionality

Typhoon uses Cubism.js to visualize latencies. The visualizations help you to make quick decisions on optimal software configuration, the number of servers and concurrent connections you need, and other short-term considerations. Long-term, they can inform how you develop and extend your data and service architecture, choose new technologies, etc.

Typhoon also:

  • provides a REST API.
  • uses pure functional expressions to define workload scenarios that don't require any compilation or native package builds; read more here.
  • scales up to dozens of individual nodes hosted in any cloud environment.
  • uses peer-to-peer clustering, based on consistent hashing, to assemble and orchestrate load toward SUT. It helps to deal with possible network failures, and provides high availability for synthetic load and telemetry collections.
  • approximates network delay, round-trip time, TLS handshakes, Time to First Byte and Time to Meaningful Response.
  • evaluates protocol overhead by approximating packet metrics.
  • estimates application performance.
  • validates system performance and scalability while spawning a huge number of concurrent sessions.
  • acceptance testing; read more here.

You can read more about Typhoon's features in this blog post.

Inspiration

Typhoon's architecture and design reflect the principles of incremental scalability, decentralization and optimistic replication. It derives inspiration from related efforts driven by Nokia (latency analysis on cellular networks), Google (web protocol enhancement and evolution), and other companies working in the mobile app space.

Getting Started

Typhoon supplies pre-built releases for Linux/x86_64, MacOS/10.10.x and Docker platforms. Instructions for using these binaries are on the GitHub releases page.

Build the latest version of Typhoon from the master branch. The build process requires Erlang/OTP version 18.0 or later. All development, including new features and bug fixes, take place on the master branch using forking and pull requests as described in these contribution guidelines.

Install directions with AWS-related details are here.

Running Typhoon

The easiest way to run a standalone instance is with the Docker container. The option is viable only if you've configured either Docker Toolbox or the Docker daemon. Use the latest release version:

docker run -it --name typhoon --rm -p 8080:8080 registry.opensource.zalan.do/hunt/typhoon:latest

This A) starts a single Typhoon node as a Docker container and B) exposes services using the REST API on port 8080. By default it is bound to localhost IP address on Mac OS and Linux. If you're using a different platform, please check your Docker configuration.

You can also spawn Typhoon using native platform binaries. See the installation instructions on the GitHub releases page:

/usr/local/typhoon-x.y.z foreground

This brings Typhoon up and running. The application uses local IP address 127.0.0.1 and port 8080 to offer services. Open the Typhoon dashboard http://localhost:8080 in your web browser to manage the workload and analyze the results.

Next, define a simple workload scenario and publish it to Typhoon:

docker exec -it typhoon tyrl \
   -i example \
   -H "Connection: keep-alive" \
   http://localhost:8080/health/peer

Open Typhoon dashboard at web browser http://localhost:8080 to analyze measurements: network delay, roundtrip time, TLS handshake, Time to First Byte, and Time to Meaningful Response. It also evaluates protocol overhead at this time by approximating packet metrics, and estimates application performance.

Congrats! You have successfully started a Typhoon, written a stress test scenario, deployed it to a cluster and analyzed your system's behavior.

Running a local Typhoon cluster

Use docker containers to spawn three node cluster on local environment. The following examples shows how to spawn cluster seeder and other nodes. Use the latest release version

Let's spawn a seeder node, this node is used by other Typhoon peers to discover each other.

docker run -d --name typhoon --rm -p 8080:8080 registry.opensource.zalan.do/hunt/typhoon:latest

Next, the identity of seeder node is needed to spawn other peers. We can use health check api for this

curl http://localhost:8080/health/peer

The application should return list of cluster peers ["[email protected]"]. This identity shall be passed to other containers within EK_SEED environment variable. The following example spawn more cluster peers:

docker run -d -p 8080 -e "[email protected]" registry.opensource.zalan.do/hunt/typhoon:latest
docker run -d -p 8080 -e "[email protected]" registry.opensource.zalan.do/hunt/typhoon:latest

We can validate that all peers joins the cluster using health check api

curl http://localhost:8080/health/peer

The application should return list of cluster peers ["[email protected]","[email protected]","[email protected]"].

Next steps

Contributing/Bugs

Typhoon is Apache 2.0 licensed and accepts contributions via GitHub pull requests:

  • Fork the repository on GitHub
  • Read the README.md for build instructions

commit message

The commit message helps us to write a good release note, speed-up review process. The message should address two question what changed and why. The project follows the template defined by chapter Contributing to a Project of Git book.

Short (50 chars or less) summary of changes

More detailed explanatory text, if necessary. Wrap it to about 72 characters or so. In some contexts, the first line is treated as the subject of an email and the rest of the text as the body. The blank line separating the summary from the body is critical (unless you omit the body entirely); tools like rebase can get confused if you run the two together.

Further paragraphs come after blank lines.

Bullet points are okay, too

Typically a hyphen or asterisk is used for the bullet, preceded by a single space, with blank lines in between, but conventions vary here

bugs

If you experience any issues with Typhoon, please let us know via GitHub issues. We appreciate detailed and accurate reports that help us to identity and replicate the issue.

  • Specify the configuration of your environment. Include which operating system you use and the versions of runtime environments.

  • Attach logs, screenshots and exceptions, in possible.

  • Reveal the steps you took to reproduce the problem.

Contacts

Changelog

Typhoon uses semantic versions to identify stable releases.

  • 1.0.0 - Simplify scenario format, New Single Page Application
  • 0.8.0 - hackweek UI improvments and bug fixes
  • 0.7.3 - support local clustering

License

Copyright 2015 Zalando SE

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.