metrics

type Metrics interface {
	// SetProperty creates or modifies a string key-value property pair.
	//
	// Properties are top-level fields in the JSON log message. A few properties are generated by the metrics instance
	// and cannot be overridden:
	//   - startTime: epoch millisecond for machine parsing
	//   - endTime: http.TimeFormat for human readability
	//   - time: latency from metrics' creation to when it's logged - in milliseconds
	//   - timings: generic latencies - in milliseconds
	//   - counters (int64) and floaters (float64)
	//
	// If called multiples on the same key, the last one wins.
	//
	// Returns self for chaining.
	SetProperty(key, value string) Metrics
	// SetInt64Property is a variant of SetProperty for int64 values.
	SetInt64Property(key string, value int64) Metrics
	// SetFloat64Property is a variant of SetProperty for float64 values.
	SetFloat64Property(key string, value float64) Metrics
	// SetJSONProperty is a variant of SetProperty for values that don't fit the other variants.
	// If the value fails to be serialised, the error message will be used in its stead.
	// See zerolog.Event's Interface method.
	SetJSONProperty(key string, v interface{}) Metrics
	// SetCount sets the integer counter of the specified key to a value.
	// Additional names can be given to ensure they exist with the initial value (0) unless they've already been set.
	// Returns self for chaining.
	SetCount(key string, value int64, ensureExist ...string) Metrics

	// AddCount increases the integer counter of the specified key by a delta.
	// Additional names can be given to ensure they exist with the initial value (0) unless they've already been set.
	// Use IncrementCount if you need to increase by 1.
	// Returns self for chaining.
	AddCount(key string, delta int64, ensureExist ...string) Metrics
	// IncrementCount is a convenient method to increase the integer counter of the specified key by 1.
	// Returns self for chaining.
	IncrementCount(key string) Metrics
	// Faulted is a convenient method to increase the integer counter named CounterKeyFault by 1.
	// Returns self for chaining.
	Faulted() Metrics
	// Panicked is a convenient method to increase the integer counter named CounterKeyPanicked by 1.
	// Returns self for chaining.
	Panicked() Metrics

	// SetFloat sets the float counter of the specified key to a value.
	// Additional names can be given to ensure they exist with the initial value (0) unless they've already been set.
	// Returns self for chaining.
	SetFloat(key string, value float64, ensureExist ...string) Metrics
	// AddFloat increases the float counter of the specified key by a delta.
	// Additional names can be given to ensure they exist with the initial value (0) unless they've already been set.
	// Returns self for chaining.
	AddFloat(key string, delta float64, ensureExist ...string) Metrics

	// SetTiming sets a timing metric of the specified key to a duration.
	// Returns self for chaining.
	SetTiming(key string, duration time.Duration) Metrics
	// AddTiming increases a timing metric of the specified key by a delta.
	// Returns self for chaining.
	AddTiming(key string, delta time.Duration) Metrics

	// SetStatusCode sets a "statusCode" property and start additional status code counters (StatusCodeCommon).
	// Use SetStatusCodeWithFlags to customise which status code counter is not printed.
	// Returns self for chaining.
	SetStatusCode(statusCode int) Metrics
	// SetStatusCodeWithFlag emits a "statusCode" property and additional counters controlled by flag.
	// If flag is 0, only the yxx counter matching the given status code is set to 1. Otherwise, whichever
	// status code flag is specified (StatusCode1xx, StatusCode3xx, StatusCodeCommon, StatusCodeAll, etc.) get a
	// 0-value metric.
	// Returns self for chaining.
	SetStatusCodeWithFlag(statusCode int, flag int) Metrics

	// Log uses the given logger to write the metrics contents.
	Log(*zerolog.Logger)
	// LogWithEndTime is a variant of Log that receives an explicit end time.
	LogWithEndTime(*zerolog.Logger, time.Time)
}

type NullMetrics struct {
}

type Option func(*clientSideMetricsMiddleware)

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

type TimingStats struct {
	Sum time.Duration
	Min time.Duration
	Max time.Duration
	N   int64
}