Documentation ¶
Index ¶
- Constants
- Variables
- func GetCurrentCPUUsage() float64
- func MD5(slice ...string) string
- func Now() int64
- func RecordFailure(requestType, name string, responseTime int64, exception string)
- func RecordSuccess(requestType, name string, responseTime int64, responseLength int64)
- func Run(tasks ...*Task)
- func StartCPUProfile(file string, duration time.Duration) (err error)
- func StartMemoryProfile(file string, duration time.Duration) (err error)
- type Boomer
- func (b *Boomer) AddOutput(o Output)
- func (b *Boomer) EnableCPUProfile(cpuProfile string, duration time.Duration)
- func (b *Boomer) EnableMemoryProfile(memoryProfile string, duration time.Duration)
- func (b *Boomer) Quit()
- func (b *Boomer) RecordFailure(requestType, name string, responseTime int64, exception string)
- func (b *Boomer) RecordSuccess(requestType, name string, responseTime int64, responseLength int64)
- func (b *Boomer) Run(tasks ...*Task)
- func (b *Boomer) SetMode(mode Mode)
- func (b *Boomer) SetRateLimiter(rateLimiter RateLimiter)
- type ConsoleOutput
- type Mode
- type Output
- type PrometheusPusherOutput
- type RampUpRateLimiter
- type RateLimiter
- type StableRateLimiter
- type Task
- type TaskSet
- type WeighingTaskSet
Constants ¶
const ( EVENT_SPAWN = "boomer:spawn" EVENT_STOP = "boomer:stop" EVENT_QUIT = "boomer:quit" )
Variables ¶
var ErrParsingRampUpRate = errors.New("ratelimiter: invalid format of rampUpRate, try \"1\" or \"1/1s\"")
ErrParsingRampUpRate is the error returned if the format of rampUpRate is invalid.
var Events = EventBus.New()
Events is the global event bus instance.
Functions ¶
func GetCurrentCPUUsage ¶
func GetCurrentCPUUsage() float64
GetCurrentCPUUsage get current CPU usage
func RecordFailure ¶
RecordFailure reports a failure. It's a convenience function to use the defaultBoomer.
func RecordSuccess ¶
RecordSuccess reports a success. It's a convenience function to use the defaultBoomer.
func Run ¶
func Run(tasks ...*Task)
Run accepts a slice of Task and connects to a locust master. It's a convenience function to use the defaultBoomer.
func StartCPUProfile ¶
StartCPUProfile starts cpu profiling and save the results in file.
Types ¶
type Boomer ¶
type Boomer struct {
// contains filtered or unexported fields
}
A Boomer is used to run tasks. This type is exposed, so users can create and control a Boomer instance programmatically.
func NewStandaloneBoomer ¶
NewStandaloneBoomer returns a new Boomer, which can run without master.
func (*Boomer) EnableCPUProfile ¶
EnableCPUProfile will start cpu profiling after run.
func (*Boomer) EnableMemoryProfile ¶
EnableMemoryProfile will start memory profiling after run.
func (*Boomer) RecordFailure ¶
RecordFailure reports a failure.
func (*Boomer) RecordSuccess ¶
RecordSuccess reports a success.
func (*Boomer) SetRateLimiter ¶
func (b *Boomer) SetRateLimiter(rateLimiter RateLimiter)
SetRateLimiter allows user to use their own rate limiter. It must be called before the test is started.
type ConsoleOutput ¶
type ConsoleOutput struct { }
ConsoleOutput is the default output for standalone mode.
func NewConsoleOutput ¶
func NewConsoleOutput() *ConsoleOutput
NewConsoleOutput returns a ConsoleOutput.
func (*ConsoleOutput) OnEvent ¶
func (o *ConsoleOutput) OnEvent(data map[string]interface{})
OnEvent will print to the console.
func (*ConsoleOutput) OnStart ¶
func (o *ConsoleOutput) OnStart()
OnStart of ConsoleOutput has nothing to do.
func (*ConsoleOutput) OnStop ¶
func (o *ConsoleOutput) OnStop()
OnStop of ConsoleOutput has nothing to do.
type Mode ¶
type Mode int
Mode is the running mode of boomer, both standalone and distributed are supported.
type Output ¶
type Output interface { // OnStart will be call before the test starts. OnStart() // By default, each output receive stats data from runner every three seconds. // OnEvent is responsible for dealing with the data. OnEvent(data map[string]interface{}) // OnStop will be called before the test ends. OnStop() }
Output is primarily responsible for printing test results to different destinations such as consoles, files. You can write you own output and add to boomer. When running in standalone mode, the default output is ConsoleOutput, you can add more. When running in distribute mode, test results will be reported to master with or without an output. All the OnXXX function will be call in a separated goroutine, just in case some output will block. But it will wait for all outputs return to avoid data lost.
type PrometheusPusherOutput ¶
type PrometheusPusherOutput struct {
// contains filtered or unexported fields
}
PrometheusPusherOutput pushes boomer stats to Prometheus Pushgateway.
func NewPrometheusPusherOutput ¶
func NewPrometheusPusherOutput(gatewayURL, jobName string) *PrometheusPusherOutput
NewPrometheusPusherOutput returns a PrometheusPusherOutput.
func (*PrometheusPusherOutput) OnEvent ¶
func (o *PrometheusPusherOutput) OnEvent(data map[string]interface{})
OnEvent will push metric to Prometheus Pushgataway
func (*PrometheusPusherOutput) OnStart ¶
func (o *PrometheusPusherOutput) OnStart()
OnStart will register all prometheus metric collectors
func (*PrometheusPusherOutput) OnStop ¶
func (o *PrometheusPusherOutput) OnStop()
OnStop of PrometheusPusherOutput has nothing to do.
type RampUpRateLimiter ¶
type RampUpRateLimiter struct {
// contains filtered or unexported fields
}
A RampUpRateLimiter uses the token bucket algorithm. the threshold is updated according to the warm up rate. the bucket is refilled according to the refill period, no burst is allowed.
func NewRampUpRateLimiter ¶
func NewRampUpRateLimiter(maxThreshold int64, rampUpRate string, refillPeriod time.Duration) (rateLimiter *RampUpRateLimiter, err error)
NewRampUpRateLimiter returns a RampUpRateLimiter. Valid formats of rampUpRate are "1", "1/1s".
func (*RampUpRateLimiter) Acquire ¶
func (limiter *RampUpRateLimiter) Acquire() (blocked bool)
Acquire a token from the bucket, returns true if the bucket is exhausted.
func (*RampUpRateLimiter) Start ¶
func (limiter *RampUpRateLimiter) Start()
Start to refill the bucket periodically.
type RateLimiter ¶
type RateLimiter interface { // Start is used to enable the rate limiter. // It can be implemented as a noop if not needed. Start() // Acquire() is called before executing a task.Fn function. // If Acquire() returns true, the task.Fn function will be executed. // If Acquire() returns false, the task.Fn function won't be executed this time, but Acquire() will be called very soon. // It works like: // for { // blocked := rateLimiter.Acquire() // if !blocked { // task.Fn() // } // } // Acquire() should block the caller until execution is allowed. Acquire() bool // Stop is used to disable the rate limiter. // It can be implemented as a noop if not needed. Stop() }
RateLimiter is used to put limits on task executions.
type StableRateLimiter ¶
type StableRateLimiter struct {
// contains filtered or unexported fields
}
A StableRateLimiter uses the token bucket algorithm. the bucket is refilled according to the refill period, no burst is allowed.
func NewStableRateLimiter ¶
func NewStableRateLimiter(threshold int64, refillPeriod time.Duration) (rateLimiter *StableRateLimiter)
NewStableRateLimiter returns a StableRateLimiter.
func (*StableRateLimiter) Acquire ¶
func (limiter *StableRateLimiter) Acquire() (blocked bool)
Acquire a token from the bucket, returns true if the bucket is exhausted.
func (*StableRateLimiter) Start ¶
func (limiter *StableRateLimiter) Start()
Start to refill the bucket periodically.
type Task ¶
type Task struct { // The weight is used to distribute goroutines over multiple tasks. Weight int // Fn is called by the goroutines allocated to this task, in a loop. Fn func() Name string }
Task is like the "Locust object" in locust, the python version. When boomer receives a start message from master, it will spawn several goroutines to run Task.Fn. But users can keep some information in the python version, they can't do the same things in boomer. Because Task.Fn is a pure function.
type TaskSet ¶
type TaskSet interface { // Add a Task to the TaskSet. AddTask(task *Task) // Set the weight of the TaskSet. SetWeight(weight int) // Get the weight of the TaskSet. GetWeight() (weight int) // Run will pick up a Task from the TaskSet and run. Run() }
TaskSet is an experimental feature, the API is not stabilized. It needs to be more considered and tested.
type WeighingTaskSet ¶
type WeighingTaskSet struct {
// contains filtered or unexported fields
}
WeighingTaskSet is a implementation of the TaskSet interface. When a Task is added to WeighingTaskSet, it's weight is used to calculate the probability to be called.
func NewWeighingTaskSet ¶
func NewWeighingTaskSet() *WeighingTaskSet
NewWeighingTaskSet returns a new WeighingTaskSet.
func (*WeighingTaskSet) AddTask ¶
func (ts *WeighingTaskSet) AddTask(task *Task)
AddTask add a Task to the Weighing TaskSet. If the task's weight is <=0, it will be ignored.
func (*WeighingTaskSet) GetTask ¶
func (ts *WeighingTaskSet) GetTask(roll int) (task *Task)
GetTask returns a task in the task set.
func (*WeighingTaskSet) GetWeight ¶
func (ts *WeighingTaskSet) GetWeight() (weight int)
GetWeight returns the weight of the task set.
func (*WeighingTaskSet) Run ¶
func (ts *WeighingTaskSet) Run()
Run will pick up a task in the task set randomly and run. It can is used as a Task.Fn.
func (*WeighingTaskSet) SetWeight ¶
func (ts *WeighingTaskSet) SetWeight(weight int)
SetWeight sets the weight of the task set.