Struct PollTraffic 

pub struct PollTraffic {

    pub schema_version: u32,
    pub written_at: DateTime<Utc>,
    pub idle_interval_secs: u16,
    pub active_interval_secs: u16,
    pub pace: String,
    pub targets_idle: u32,
    pub targets_total: u32,
    pub throttled_because: Option<String>,
    pub observed_minutes: u32,
    pub full: u32,
    pub not_modified: u32,
    pub failed: u32,
    pub peak_requests_per_minute: u32,
    pub rate_limit_limit: Option<u64>,
    pub rate_limit_remaining: Option<u64>,
    pub rate_limit_used: Option<u64>,
    pub rate_limit_reset: Option<DateTime<Utc>>,
    pub demand_reads: u64,
    pub demand_unchanged_reads: u64,
    pub demand_shared_reads: u64,
    pub demand_suppressed: u64,
}

What one daemon measured about its own polling, host-wide.

Every count covers the last hour at most; Self::observed_minutes says how much of it. The rate-limit fields are the account’s quota as GitHub last reported it, which every host signed in as the same user shares.

Fields

schema_version: u32

written_at: DateTime<Utc>

idle_interval_secs: u16

The intervals the daemon is polling at.

active_interval_secs: u16

pace: String

The most severe pace any target loop is running at: idle, nominal, or a slowdown (stretched_low_budget, rate_limited_secondary, …).

targets_idle: u32

Targets polling at the idle interval, and at any other pace.

targets_total: u32

throttled_because: Option<String>

Why polling is slower than configured, when it is.

observed_minutes: u32

full: u32

2xx responses: charged against the primary limit.

not_modified: u32

304 responses: free against the primary limit.

failed: u32

Error responses: charged, not data.

peak_requests_per_minute: u32

This host’s busiest minute, every response counted.

rate_limit_limit: Option<u64>

rate_limit_remaining: Option<u64>

rate_limit_used: Option<u64>

rate_limit_reset: Option<DateTime<Utc>>

demand_reads: u64

Repository readings fetched, and how many of those were all 304.

demand_unchanged_reads: u64

demand_shared_reads: u64

Readings handed to a second target instead of being fetched again.

demand_suppressed: u64

Polls withheld inside a rate-limit quiet period.

Implementations

impl PollTraffic

pub fn new(written_at: DateTime<Utc>) -> Self

A record carrying the current schema version; the caller fills the rest.

pub const fn total(&self) -> u32

Every response counted.

pub fn per_hour(&self, count: u32) -> u32

count, scaled from the observed minutes to an hour.

pub fn not_modified_percent(&self) -> Option<u32>

The share of responses that were 304, in whole percent.

pub const fn is_throttled(&self) -> bool

Whether polling is slower than configured.

Trait Implementations

impl Clone for PollTraffic

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PollTraffic

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

Formats the value using the given formatter.

impl Default for PollTraffic

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PollTraffic

where PollTraffic: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PollTraffic

impl PartialEq for PollTraffic

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for PollTraffic

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PollTraffic