Struct goose::metrics::GooseMetrics

pub struct GooseMetrics {
    pub hash: u64,
    pub duration: usize,
    pub users: usize,
    pub requests: GooseRequestMetrics,
    pub tasks: GooseTaskMetrics,
    pub display_percentile: bool,
    pub display_status_codes: bool,
    pub display_metrics: bool,
}

Metrics collected during a Goose load test.

Example

use goose::prelude::*;

fn main() -> Result<(), GooseError> {
    let goose_metrics: GooseMetrics = GooseAttack::initialize()?
        .register_taskset(taskset!("ExampleUsers")
            .register_task(task!(example_task))
        )
        .execute()?;

    // It is now possible to do something with the metrics collected by Goose.
    // For now, we'll just pretty-print the entire object.
    println!("{:#?}", goose_metrics);

    Ok(())
}

async fn example_task(user: &GooseUser) -> GooseTaskResult {
    let _goose = user.get("/").await?;

    Ok(())
}

Fields

hash: u64

A hash of the load test, useful to verify if different metrics are from the same load test.

duration: usize

How many seconds the load test ran.

users: usize

Total number of users simulated during this load test.

requests: GooseRequestMetrics

Goose request metrics.

tasks: GooseTaskMetrics

Goose task metrics.

display_percentile: bool

Flag indicating whether or not to display percentile. Because we're deriving Default, this defaults to false.

display_status_codes: bool

Flag indicating whether or not to display status_codes. Because we're deriving Default, this defaults to false.

display_metrics: bool

Flag indicating whether or not to display metrics, set to false on Workers. This defaults to false because we're deriving Default.

Implementations

impl GooseMetrics

pub fn initialize_task_metrics(
    &mut self,
    task_sets: &[GooseTaskSet],
    config: &GooseConfiguration
)

pub fn print(&self)

Consumes and display all metrics from a completed load test.

Example

use goose::prelude::*;

fn main() -> Result<(), GooseError> {
    GooseAttack::initialize()?
        .register_taskset(taskset!("ExampleUsers")
            .register_task(task!(example_task))
        )
        .execute()?
        .print();

    Ok(())
}

async fn example_task(user: &GooseUser) -> GooseTaskResult {
    let _goose = user.get("/").await?;

    Ok(())
}

pub fn print_running(&self)

Consumes and displays metrics from a running load test.

pub fn fmt_requests(&self, fmt: &mut Formatter<'_>) -> Result

Optionally prepares a table of requests and fails.

pub fn fmt_tasks(&self, fmt: &mut Formatter<'_>) -> Result

Optionally prepares a table of tasks.

pub fn fmt_task_times(&self, fmt: &mut Formatter<'_>) -> Result

pub fn fmt_response_times(&self, fmt: &mut Formatter<'_>) -> Result

pub fn fmt_percentiles(&self, fmt: &mut Formatter<'_>) -> Result

pub fn fmt_status_codes(&self, fmt: &mut Formatter<'_>) -> Result

Trait Implementations

impl Clone for GooseMetrics

fn clone(&self) -> GooseMetrics

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GooseMetrics

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GooseMetrics

fn default() -> GooseMetrics

Returns the "default value" for a type.

impl Display for GooseMetrics

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.