#[non_exhaustive]pub struct AgentConfigurationBuilder { /* private fields */ }
Expand description
A builder for AgentConfiguration
.
Implementations§
Source§impl AgentConfigurationBuilder
impl AgentConfigurationBuilder
Sourcepub fn should_profile(self, input: bool) -> Self
pub fn should_profile(self, input: bool) -> Self
A Boolean
that specifies whether the profiling agent collects profiling data or not. Set to true
to enable profiling.
Sourcepub fn set_should_profile(self, input: Option<bool>) -> Self
pub fn set_should_profile(self, input: Option<bool>) -> Self
A Boolean
that specifies whether the profiling agent collects profiling data or not. Set to true
to enable profiling.
Sourcepub fn get_should_profile(&self) -> &Option<bool>
pub fn get_should_profile(&self) -> &Option<bool>
A Boolean
that specifies whether the profiling agent collects profiling data or not. Set to true
to enable profiling.
Sourcepub fn period_in_seconds(self, input: i32) -> Self
pub fn period_in_seconds(self, input: i32) -> Self
How long a profiling agent should send profiling data using ConfigureAgent
. For example, if this is set to 300, the profiling agent calls ConfigureAgent
every 5 minutes to submit the profiled data collected during that period.
Sourcepub fn set_period_in_seconds(self, input: Option<i32>) -> Self
pub fn set_period_in_seconds(self, input: Option<i32>) -> Self
How long a profiling agent should send profiling data using ConfigureAgent
. For example, if this is set to 300, the profiling agent calls ConfigureAgent
every 5 minutes to submit the profiled data collected during that period.
Sourcepub fn get_period_in_seconds(&self) -> &Option<i32>
pub fn get_period_in_seconds(&self) -> &Option<i32>
How long a profiling agent should send profiling data using ConfigureAgent
. For example, if this is set to 300, the profiling agent calls ConfigureAgent
every 5 minutes to submit the profiled data collected during that period.
Sourcepub fn agent_parameters(
self,
k: AgentParameterField,
v: impl Into<String>,
) -> Self
pub fn agent_parameters( self, k: AgentParameterField, v: impl Into<String>, ) -> Self
Adds a key-value pair to agent_parameters
.
To override the contents of this collection use set_agent_parameters
.
Parameters used by the profiler. The valid parameters are:
-
MaxStackDepth
- The maximum depth of the stacks in the code that is represented in the profile. For example, if CodeGuru Profiler finds a methodA
, which calls methodB
, which calls methodC
, which calls methodD
, then the depth is 4. If themaxDepth
is set to 2, then the profiler evaluatesA
andB
. -
MemoryUsageLimitPercent
- The percentage of memory that is used by the profiler. -
MinimumTimeForReportingInMilliseconds
- The minimum time in milliseconds between sending reports. -
ReportingIntervalInMilliseconds
- The reporting interval in milliseconds used to report profiles. -
SamplingIntervalInMilliseconds
- The sampling interval in milliseconds that is used to profile samples.
Sourcepub fn set_agent_parameters(
self,
input: Option<HashMap<AgentParameterField, String>>,
) -> Self
pub fn set_agent_parameters( self, input: Option<HashMap<AgentParameterField, String>>, ) -> Self
Parameters used by the profiler. The valid parameters are:
-
MaxStackDepth
- The maximum depth of the stacks in the code that is represented in the profile. For example, if CodeGuru Profiler finds a methodA
, which calls methodB
, which calls methodC
, which calls methodD
, then the depth is 4. If themaxDepth
is set to 2, then the profiler evaluatesA
andB
. -
MemoryUsageLimitPercent
- The percentage of memory that is used by the profiler. -
MinimumTimeForReportingInMilliseconds
- The minimum time in milliseconds between sending reports. -
ReportingIntervalInMilliseconds
- The reporting interval in milliseconds used to report profiles. -
SamplingIntervalInMilliseconds
- The sampling interval in milliseconds that is used to profile samples.
Sourcepub fn get_agent_parameters(
&self,
) -> &Option<HashMap<AgentParameterField, String>>
pub fn get_agent_parameters( &self, ) -> &Option<HashMap<AgentParameterField, String>>
Parameters used by the profiler. The valid parameters are:
-
MaxStackDepth
- The maximum depth of the stacks in the code that is represented in the profile. For example, if CodeGuru Profiler finds a methodA
, which calls methodB
, which calls methodC
, which calls methodD
, then the depth is 4. If themaxDepth
is set to 2, then the profiler evaluatesA
andB
. -
MemoryUsageLimitPercent
- The percentage of memory that is used by the profiler. -
MinimumTimeForReportingInMilliseconds
- The minimum time in milliseconds between sending reports. -
ReportingIntervalInMilliseconds
- The reporting interval in milliseconds used to report profiles. -
SamplingIntervalInMilliseconds
- The sampling interval in milliseconds that is used to profile samples.
Sourcepub fn build(self) -> Result<AgentConfiguration, BuildError>
pub fn build(self) -> Result<AgentConfiguration, BuildError>
Consumes the builder and constructs a AgentConfiguration
.
This method will fail if any of the following fields are not set:
Trait Implementations§
Source§impl Clone for AgentConfigurationBuilder
impl Clone for AgentConfigurationBuilder
Source§fn clone(&self) -> AgentConfigurationBuilder
fn clone(&self) -> AgentConfigurationBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for AgentConfigurationBuilder
impl Debug for AgentConfigurationBuilder
Source§impl Default for AgentConfigurationBuilder
impl Default for AgentConfigurationBuilder
Source§fn default() -> AgentConfigurationBuilder
fn default() -> AgentConfigurationBuilder
impl StructuralPartialEq for AgentConfigurationBuilder
Auto Trait Implementations§
impl Freeze for AgentConfigurationBuilder
impl RefUnwindSafe for AgentConfigurationBuilder
impl Send for AgentConfigurationBuilder
impl Sync for AgentConfigurationBuilder
impl Unpin for AgentConfigurationBuilder
impl UnwindSafe for AgentConfigurationBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);