stress

Documentation

Index

• Constants
• func CreateTextStressSummary(reqStatSummary RequestStatSummary) string
• func InitCmd(watchCmd *cobra.Command)
• func RunStress(s StressConfig, w io.Writer) ([][]RequestStat, error)
• type RequestStat
• type RequestStatSummary
  • func CreateRequestsStats(requestStats []RequestStat) RequestStatSummary
• type StressConfig
  • func NewStressConfig() (s *StressConfig)
• type Target

Constants

const (
	DefaultURL         = "http://localhost"
	DefaultTimeout     = "10s"
	DefaultMethod      = "GET"
	DefaultUserAgent   = "stress"
	DefaultCount       = 10
	DefaultConcurrency = 1
)

Reasonable default values for a target

Functions

func CreateTextStressSummary

func CreateTextStressSummary(reqStatSummary RequestStatSummary) string

CreateTextStressSummary creates a human friendly summary of entire stress test

func InitCmd

func InitCmd(watchCmd *cobra.Command)

func RunStress

func RunStress(s StressConfig, w io.Writer) ([][]RequestStat, error)

RunStress starts the stress tests with the provided StressConfig. Throughout the test, data is sent to w, useful for live updates.

Types

type RequestStat

type RequestStat struct {
	Proto     string
	URL       string
	Method    string
	StartTime time.Time `json:"startTime"`
	EndTime   time.Time `json:"endTime"`
	//equivalent to the difference between StartTime and EndTime
	Duration time.Duration `json:"duration"`
	//HTTP Status Code, e.g. 200, 404, 503
	StatusCode      int   `json:"statusCode"`
	Error           error `json:"error"`
	DataTransferred int   //bytes
}

RequestStat is the saved information about an individual completed HTTP request

type RequestStatSummary

type RequestStatSummary struct {
	// contains filtered or unexported fields
}

RequestStatSummary is an aggregate statistical summary of a set of RequestStats

func CreateRequestsStats

func CreateRequestsStats(requestStats []RequestStat) RequestStatSummary

CreateRequestsStats creates a statistical summary out of the individual RequestStats

type StressConfig

type StressConfig struct {
	Verbose bool
	Quiet   bool

	// Count is how many total requests to make for each Target
	Count int
	// Concurrency is how many requests can be happening simultaneously for each Target
	Concurrency int
	Targets     []Target

	DNSPrefetch     bool
	Timeout         string
	Method          string
	Body            string
	BodyFilename    string
	Headers         string
	Cookies         string
	UserAgent       string
	BasicAuth       string
	Compress        bool
	KeepAlive       bool
	FollowRedirects bool
	NoHTTP2         bool
	EnforceSSL      bool
}

StressConfig is the top level struct that contains the configuration for a stress test

func NewStressConfig

func NewStressConfig() (s *StressConfig)

NewStressConfig creates a new StressConfig with package defaults

type Target

type Target struct {
	URL string
	//Whether or not to interpret the URL as a regular expression string
	//and generate actual target URLs from that
	RegexURL bool
	//whether or not to resolve hostname to IP address before making request,
	//eliminating that aspect of timing
	DNSPrefetch bool
	Timeout     string
	//A valid HTTP method: GET, HEAD, POST, etc.
	Method string
	//String that is the content of the HTTP body. Empty string is no body.
	Body string
	//A location on disk to read the HTTP body from. Empty string means it will not be read.
	BodyFilename    string
	Headers         string
	Cookies         string
	UserAgent       string
	BasicAuth       string
	Compress        bool
	KeepAlive       bool
	FollowRedirects bool
	NoHTTP2         bool
	EnforceSSL      bool
}

Target is location of where send the HTTP request and how to send it.