Home

Awesome

Typhoon

<p align="center"> <img align="left" width="200" src="docs/img/typhoon.png"> <ul> <br/> <li><strong>Source</strong>: https://github.com/zalando/typhoon <li><strong>Issues</strong>: https://github.com/zalando/typhoon/issues <li><strong>Mailing List</strong>: <a href="https://groups.google.com/d/forum/typhoon-users">typhoon-users@googlegroups.com</a> <li><strong>Philosophy</strong>: <a href="https://tech.zalando.de/blog/end-to-end-latency-challenges-for-microservices/">Latency challenge</a> </ul> <br/><br/><br/><br/> <strong>Makes latency assessments of distributed systems build from microservices.</strong> </p>

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:

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 ["typhoon@172.17.0.2"]. 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 "EK_SEED=typhoon@172.17.0.2" registry.opensource.zalan.do/hunt/typhoon:latest
docker run -d -p 8080 -e "EK_SEED=typhoon@172.17.0.2" 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 ["typhoon@172.17.0.2","typhoon@172.17.0.3","typhoon@172.17.0.4"].

Next steps

Contributing/Bugs

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

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.

Contacts

Changelog

Typhoon uses semantic versions to identify stable releases.

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.