Giter Club home page Giter Club logo

disturbance's Introduction

Disturbance

Crate Build Status

Monitor disturbances in a web service's behaviour.

You may use disturbance as a monitoring utility which is up over an extended period of time to know if a service ever went down/unhealthy. Eg: Uptime during a deployment.

Usage

USAGE:
    disturbance [OPTIONS] <url>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -e, --excludes <excludes>          Response should not match
    -m, --matches <matches>            Response should match
    -p, --parallelism <parallelism>    Parallelism [default: 2]
    -t, --timeout <timeout>            Request timeout in seconds [default: 5]
    -w, --wait <wait>                  Wait time (in ms) between requests per worker. [default: 100]

ARGS:
    <url>    The web service's URL to monitor``

Example

  • Check a website's response distribution to simple GET requets.

    $ disturbance https://example.com/
    Success(200) => 14
    
  • Check a website while also requring a pattern to be present.
    With a pattern that isn't present in the responses:

    $ disturbance https://example.com/ -m test
    DoesNotMatch => 407
    

    With intermittent matches (potentially unstable website):

    $ disturbance https://example.com/ -m true
    Success(200) => 64, DoesNotMatch => 10
    
  • Use an exlusion pattern, to ensure that responses never contain the string that you paas.

    $ disturbance https://example.com/ -e '"success":false'
    DoesNotExclude => 12
    

    Or a good service:

    $ disturbance https://example.com/ -e '"success":true'
    Success(200) => 18
    
  • Configure parallelism to control the number of parallel workers (defaults to 2).

    $ disturbance https://example.com/ -p 4
    Success(200) => 128
    
  • Set a custom timeout in seconds (default 5)

    $ disturbance https://example.com/ -t 1
    ErrorResponse("https://example.com/: timed out") => 4
    
  • Set a custom wait time between requests (default: 100 ms), per worker. If you want

    $ disturbance https://example.com/ -t 1 -w 500
    ErrorResponse("https://example.com/: timed out") => 4
    

disturbance's People

Contributors

crodjer avatar dependabot[bot] avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  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.