circuit_build_times_t Struct Reference

#include <circuitstats.h>

Data Fields
build_time_t	circuit_build_times [CBT_NCIRCUITS_TO_OBSERVE]
int	build_times_idx
int	total_build_times
network_liveness_t	liveness
time_t	last_circ_at
build_time_t	Xm
double	alpha
int	have_computed_timeout
double	timeout_ms
double	close_ms
uint32_t	num_circ_succeeded
uint32_t	num_circ_timeouts
uint32_t	num_circ_closed

Detailed Description

Structure for circuit build times history

Definition at line 178 of file circuitstats.h.

Field Documentation

alpha

double alpha

alpha exponent for pareto dist.

Definition at line 192 of file circuitstats.h.

Referenced by circuit_build_times_calculate_timeout(), circuit_build_times_set_timeout(), and circuit_build_times_update_alpha().

build_times_idx

int build_times_idx

Current index in the circuit_build_times circular array

Definition at line 182 of file circuitstats.h.

Referenced by circuit_build_times_add_time(), and circuit_build_times_reset().

circuit_build_times

build_time_t circuit_build_times[CBT_NCIRCUITS_TO_OBSERVE]

The circular array of recorded build times in milliseconds

Definition at line 180 of file circuitstats.h.

Referenced by circuit_build_times_add_time(), circuit_build_times_close_rate(), circuit_build_times_create_histogram(), circuit_build_times_max(), circuit_build_times_parse_state(), circuit_build_times_reset(), circuit_build_times_timeout_rate(), circuit_build_times_update_alpha(), and circuit_build_times_update_state().

close_ms

double close_ms

How long we wait before actually closing the circuit.

Definition at line 199 of file circuitstats.h.

Referenced by circuit_build_times_count_close(), circuit_build_times_count_timeout(), circuit_build_times_init(), circuit_build_times_network_check_changed(), circuit_build_times_set_timeout(), circuit_build_times_set_timeout_worker(), and get_circuit_build_close_time_ms().

have_computed_timeout

int have_computed_timeout

Have we computed a timeout?

Definition at line 194 of file circuitstats.h.

Referenced by circuit_build_times_get_xm(), circuit_build_times_reset(), and circuit_build_times_set_timeout_worker().

last_circ_at

time_t last_circ_at

Last time we built a circuit. Used to decide to build new test circs

Definition at line 188 of file circuitstats.h.

Referenced by circuit_build_times_needs_circuits_now().

liveness

network_liveness_t liveness

Information about the state of our local network connection

Definition at line 186 of file circuitstats.h.

Referenced by circuit_build_times_free_timeouts(), circuit_build_times_init(), circuit_build_times_network_check_changed(), circuit_build_times_network_check_live(), circuit_build_times_network_circ_success(), circuit_build_times_network_close(), circuit_build_times_network_is_live(), circuit_build_times_network_timeout(), and circuit_build_times_new_consensus_params().

num_circ_closed

uint32_t num_circ_closed

Total closed counts. Old measurements may be scaled downward if we've seen a lot of circuits.

Definition at line 208 of file circuitstats.h.

Referenced by circuit_build_times_network_close(), circuit_build_times_reset(), and circuit_build_times_scale_circ_counts().

num_circ_succeeded

uint32_t num_circ_succeeded

Total succeeded counts. Old measurements may be scaled downward if we've seen a lot of circuits.

Definition at line 202 of file circuitstats.h.

Referenced by circuit_build_times_network_circ_success(), circuit_build_times_reset(), and circuit_build_times_scale_circ_counts().

num_circ_timeouts

uint32_t num_circ_timeouts

Total timeout counts. Old measurements may be scaled downward if we've seen a lot of circuits.

Definition at line 205 of file circuitstats.h.

Referenced by circuit_build_times_network_timeout(), circuit_build_times_reset(), and circuit_build_times_scale_circ_counts().

timeout_ms

double timeout_ms

The exact value for that timeout in milliseconds. Stored as a double to maintain precision from calculations to and from quantile value.

Definition at line 197 of file circuitstats.h.

Referenced by circuit_build_times_count_close(), circuit_build_times_count_timeout(), circuit_build_times_get_xm(), circuit_build_times_init(), circuit_build_times_network_check_changed(), circuit_build_times_set_timeout(), circuit_build_times_set_timeout_worker(), circuit_build_times_timeout_rate(), and get_circuit_build_timeout_ms().

total_build_times

int total_build_times

Total number of build times accumulated. Max CBT_NCIRCUITS_TO_OBSERVE

Definition at line 184 of file circuitstats.h.

Referenced by circuit_build_times_add_time(), circuit_build_times_close_rate(), circuit_build_times_enough_to_compute(), circuit_build_times_get_xm(), circuit_build_times_network_check_changed(), circuit_build_times_parse_state(), circuit_build_times_reset(), circuit_build_times_set_timeout(), circuit_build_times_timeout_rate(), circuit_build_times_update_alpha(), and circuit_build_times_update_state().

Xm

build_time_t Xm

"Minimum" value of our pareto distribution (actually mode)

Definition at line 190 of file circuitstats.h.

Referenced by circuit_build_times_calculate_timeout(), circuit_build_times_set_timeout(), and circuit_build_times_update_alpha().

---

The documentation for this struct was generated from the following file:

• core/or/circuitstats.h