Struct ExperimentalTracingV2Config 

pub struct ExperimentalTracingV2Config {
    pub use_v2_probability_percent: Option<u32>,
    pub chunk_size_options: Vec<ChunkSizeOption>,
    pub drain_occupancy_percent: Option<i32>,
}

Experimental. Lets the producer write this data source through the tracing v2 ring buffer.

• Selecting v2 requires a TRACE_BUFFER_V2 target buffer and support from the producer and data source.
• Instances that do not select v2 use v1 only if the connection permits it. If neither transport is available, writers discard their data.
• If the producer cannot create or attach the ring buffer, selected instances discard their data and do not fall back to v1.

Fields

use_v2_probability_percent: Option<u32>

Percent of instances that use v2, from 0 (the default) to 100. The service rejects a nonzero use_v2_probability_percent and a ProtoVM data source on the same buffer.

chunk_size_options: Vec<ChunkSizeOption>

The producer chooses one option at random, by weight, when it creates the ring buffer. With no option, or with all weights 0, it uses 256 bytes.

The first instance that selects v2 chooses the size for the connection, and the options of later instances have no effect.

drain_occupancy_percent: Option<i32>

When the writers ask the service to drain the ring buffer. After each publication, a writer counts the ring buffer positions that wait for the reader, and asks for a drain when the count reaches:

• 0 or absent: 25% of the positions.
• 1 to 100: this percent of the positions, and at least one.
• -1: one position, so it asks after every publication. Flushes and full ring buffers still ask for a drain at once. The service rejects other values.

As for chunk_size_options, the first instance that selects v2 sets it for the connection, and the values of later instances have no effect.

Implementations

impl ExperimentalTracingV2Config

pub fn use_v2_probability_percent(&self) -> u32

Returns the value of use_v2_probability_percent, or the default value if use_v2_probability_percent is unset.

pub fn drain_occupancy_percent(&self) -> i32

Returns the value of drain_occupancy_percent, or the default value if drain_occupancy_percent is unset.

Trait Implementations

impl Clone for ExperimentalTracingV2Config

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 ExperimentalTracingV2Config

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

Formats the value using the given formatter.

impl Default for ExperimentalTracingV2Config

fn default() -> Self

Returns the “default value” for a type.

impl Message for ExperimentalTracingV2Config

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for ExperimentalTracingV2Config

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ExperimentalTracingV2Config