Code Monkey home page Code Monkey logo

squash's Introduction

squash
Debugger for microservices

Debug your microservice applications from your terminal or IDE while they run in Kubernetes.


Installation   |   Documentation   |   Blog   |   Slack   |   Twitter

Debugging microservices applications is a difficult task. The state of an application is spread across multiple processes, often on different nodes. It is hard to get the holistic view of an application's state. Certain tools exist for troubleshooting microservice issues. OpenTracing can be used to produce transaction or workflow logs for post-mortem analysis. Service meshes like Istio can be used to monitor the network to identify latency problems. Unfortunately, these tools are passive, the feedback loop is slow, and they do not allow you to monitor and alter the application during run time.

In contrast, "traditional" debuggers for monolithic applications provide devs with powerful real-time investigation features. A developer working with monolithic applications has the powerful ability to set breakpoints throughout the application, follow variable values on the fly, step through the code, and change values during run time.

Squash brings the power of modern debuggers to developers of microservice apps. Squash bridges between the apps running in a Kubernetes environment (without modifying them) and the IDE. Users are free to choose which containers, pods, services or images they are interested in debugging, and are allowed to set breakpoints in their codes, follow values of their variables on the fly, step through the code while jumping between microservices, and change these values during run time.

Squash is built to be easily extensible. It is easy to add support for more languages, debuggers and IDEs.

To learn more about the motivation behind project squash, read our blog post or watch session (slides). We also encourage you to read squash technical overview blog.

To stay up-to-date with Squash, follow us @soloio_inc and join us on our slack channel.

Official website

With Squash, you can:

  • Debug running microservices
  • Debug container in a pod
  • Debug a service
  • Set breakpoints
  • Step through code
  • View and modify values of variables
  • ...anything you could do with a regular debugger, and more!

Demo

In the following demo we debug an application that adds two numbers. As you can see, it currently fails miserably at adding 9 to 99. The application is composed of two microservices. We set breakpoints in both, then step through the application, while monitoring its variables. At some point we identify the problem, and test it by changing the value of the variable isadd before resuming the execution of the application.

Squash Demo

An annotated version of this demo can be found here.

Documentation

Please visit squash.solo.io for documentation.

Supported debuggers:

Supported platforms:

Supported IDEs:

Roadmap:

Service Mesh

  • Squash integrates with Envoy. Read about the Squash HTTP filter, now part of Envoy here. This allows Squash to open debug sessions as a request flows through a microservice. Support for Istio will be added in 2019.

Debuggers

  • We will be adding support to several additional debuggers in early 2019, including gdb, nodejs, and python.

IDEs

  • We have simplified the squashctl --machine interface so it is easier to add support for additional IDEs. We will be updating our Intellij extension in early 2019.

We welcome community support for enabling more debuggers and IDEs.

Squash is under active development. APIs and compatibility are subject to change. We welcome community participation to help identify potential bugs and compatibility issues. Please open a Github issue for any problems you may experience, and join us on our slack channel


Thanks

Squash would not be possible without the valuable open-source work of projects in the community. We would like to extend a special thank-you to Kubernetes, gdb and dlv.

squash's People

Contributors

anton-st avatar arindam-bandyopadhyay avatar axhixh avatar briandealwis avatar dalebingham avatar ericmand avatar harwayne avatar hgword avatar hugocortes avatar ilevine avatar ingve avatar mitchdraft avatar mjbright avatar pavius avatar rettori avatar roblourens avatar sanha avatar scranton avatar sleyzerzon avatar tals avatar yuval-k avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.