#[non_exhaustive]pub struct DimensionGroup {
pub group: String,
pub dimensions: Option<Vec<String>>,
pub limit: Option<i32>,
}
Expand description
A logical grouping of Performance Insights metrics for a related subject area. For example, the db.sql
dimension group consists of the following dimensions:
-
db.sql.id
- The hash of a running SQL statement, generated by Performance Insights. -
db.sql.db_id
- Either the SQL ID generated by the database engine, or a value generated by Performance Insights that begins withpi-
. -
db.sql.statement
- The full text of the SQL statement that is running, for example,SELECT * FROM employees
. -
db.sql_tokenized.id
- The hash of the SQL digest generated by Performance Insights.
Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.group: String
The name of the dimension group. Valid values are as follows:
-
db
- The name of the database to which the client is connected. The following values are permitted:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Aurora MySQL
-
Amazon RDS MySQL
-
Amazon RDS MariaDB
-
Amazon DocumentDB
-
-
db.application
- The name of the application that is connected to the database. The following values are permitted:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Amazon DocumentDB
-
-
db.blocking_sql
- The SQL queries blocking the most DB load. -
db.blocking_session
- The sessions blocking the most DB load. -
db.blocking_object
- The object resources acquired by other sessions that are blocking the most DB load. -
db.host
- The host name of the connected client (all engines). -
db.plans
- The execution plans for the query (only Aurora PostgreSQL). -
db.query
- The query that is currently running (only Amazon DocumentDB). -
db.query_tokenized
- The digest query (only Amazon DocumentDB). -
db.session_type
- The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL). -
db.sql
- The text of the SQL statement that is currently running (all engines except Amazon DocumentDB). -
db.sql_tokenized
- The SQL digest (all engines except Amazon DocumentDB). -
db.user
- The user logged in to the database (all engines except Amazon DocumentDB). -
db.wait_event
- The event for which the database backend is waiting (all engines except Amazon DocumentDB). -
db.wait_event_type
- The type of event for which the database backend is waiting (all engines except Amazon DocumentDB). -
db.wait_state
- The event for which the database backend is waiting (only Amazon DocumentDB).
dimensions: Option<Vec<String>>
A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested, or are present in the response.
Valid values for elements in the Dimensions
array are:
-
db.application.name
- The name of the application that is connected to the database. Valid values are as follows:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Amazon DocumentDB
-
-
db.blocking_sql.id
- The ID for each of the SQL queries blocking the most DB load. -
db.blocking_sql.sql
- The SQL text for each of the SQL queries blocking the most DB load. -
db.blocking_session.id
- The ID for each of the sessions blocking the most DB load. -
db.blocking_object.id
- The ID for each of the object resources acquired by other sessions that are blocking the most DB load. -
db.blocking_object.type
- The object type for each of the object resources acquired by other sessions that are blocking the most DB load. -
db.blocking_object.value
- The value for each of the object resources acquired by other sessions that are blocking the most DB load. -
db.host.id
- The host ID of the connected client (all engines). -
db.host.name
- The host name of the connected client (all engines). -
db.name
- The name of the database to which the client is connected. Valid values are as follows:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Aurora MySQL
-
Amazon RDS MySQL
-
Amazon RDS MariaDB
-
Amazon DocumentDB
-
-
db.query.id
- The query ID generated by Performance Insights (only Amazon DocumentDB). -
db.query.db_id
- The query ID generated by the database (only Amazon DocumentDB). -
db.query.statement
- The text of the query that is being run (only Amazon DocumentDB). -
db.query.tokenized_id
-
db.query.tokenized.id
- The query digest ID generated by Performance Insights (only Amazon DocumentDB). -
db.query.tokenized.db_id
- The query digest ID generated by Performance Insights (only Amazon DocumentDB). -
db.query.tokenized.statement
- The text of the query digest (only Amazon DocumentDB). -
db.session_type.name
- The type of the current session (only Amazon DocumentDB). -
db.sql.id
- The hash of the full, non-tokenized SQL statement generated by Performance Insights (all engines except Amazon DocumentDB). -
db.sql.db_id
- Either the SQL ID generated by the database engine, or a value generated by Performance Insights that begins withpi-
(all engines except Amazon DocumentDB). -
db.sql.statement
- The full text of the SQL statement that is running, as inSELECT * FROM employees
(all engines except Amazon DocumentDB) -
db.sql.tokenized_id
- The hash of the SQL digest generated by Performance Insights (all engines except Amazon DocumentDB). Thedb.sql.tokenized_id
dimension fetches the value of thedb.sql_tokenized.id
dimension. Amazon RDS returnsdb.sql.tokenized_id
from thedb.sql
dimension group. -
db.sql_tokenized.id
- The hash of the SQL digest generated by Performance Insights (all engines except Amazon DocumentDB). In the console,db.sql_tokenized.id
is called the Support ID because Amazon Web Services Support can look at this data to help you troubleshoot database issues. -
db.sql_tokenized.db_id
- Either the native database ID used to refer to the SQL statement, or a synthetic ID such aspi-2372568224
that Performance Insights generates if the native database ID isn't available (all engines except Amazon DocumentDB). -
db.sql_tokenized.statement
- The text of the SQL digest, as inSELECT * FROM employees WHERE employee_id = ?
(all engines except Amazon DocumentDB) -
db.user.id
- The ID of the user logged in to the database (all engines except Amazon DocumentDB). -
db.user.name
- The name of the user logged in to the database (all engines except Amazon DocumentDB). -
db.wait_event.name
- The event for which the backend is waiting (all engines except Amazon DocumentDB). -
db.wait_event.type
- The type of event for which the backend is waiting (all engines except Amazon DocumentDB). -
db.wait_event_type.name
- The name of the event type for which the backend is waiting (all engines except Amazon DocumentDB). -
db.wait_state.name
- The event for which the backend is waiting (only Amazon DocumentDB).
limit: Option<i32>
The maximum number of items to fetch for this dimension group.
Implementations§
Source§impl DimensionGroup
impl DimensionGroup
Sourcepub fn group(&self) -> &str
pub fn group(&self) -> &str
The name of the dimension group. Valid values are as follows:
-
db
- The name of the database to which the client is connected. The following values are permitted:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Aurora MySQL
-
Amazon RDS MySQL
-
Amazon RDS MariaDB
-
Amazon DocumentDB
-
-
db.application
- The name of the application that is connected to the database. The following values are permitted:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Amazon DocumentDB
-
-
db.blocking_sql
- The SQL queries blocking the most DB load. -
db.blocking_session
- The sessions blocking the most DB load. -
db.blocking_object
- The object resources acquired by other sessions that are blocking the most DB load. -
db.host
- The host name of the connected client (all engines). -
db.plans
- The execution plans for the query (only Aurora PostgreSQL). -
db.query
- The query that is currently running (only Amazon DocumentDB). -
db.query_tokenized
- The digest query (only Amazon DocumentDB). -
db.session_type
- The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL). -
db.sql
- The text of the SQL statement that is currently running (all engines except Amazon DocumentDB). -
db.sql_tokenized
- The SQL digest (all engines except Amazon DocumentDB). -
db.user
- The user logged in to the database (all engines except Amazon DocumentDB). -
db.wait_event
- The event for which the database backend is waiting (all engines except Amazon DocumentDB). -
db.wait_event_type
- The type of event for which the database backend is waiting (all engines except Amazon DocumentDB). -
db.wait_state
- The event for which the database backend is waiting (only Amazon DocumentDB).
Sourcepub fn dimensions(&self) -> &[String]
pub fn dimensions(&self) -> &[String]
A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested, or are present in the response.
Valid values for elements in the Dimensions
array are:
-
db.application.name
- The name of the application that is connected to the database. Valid values are as follows:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Amazon DocumentDB
-
-
db.blocking_sql.id
- The ID for each of the SQL queries blocking the most DB load. -
db.blocking_sql.sql
- The SQL text for each of the SQL queries blocking the most DB load. -
db.blocking_session.id
- The ID for each of the sessions blocking the most DB load. -
db.blocking_object.id
- The ID for each of the object resources acquired by other sessions that are blocking the most DB load. -
db.blocking_object.type
- The object type for each of the object resources acquired by other sessions that are blocking the most DB load. -
db.blocking_object.value
- The value for each of the object resources acquired by other sessions that are blocking the most DB load. -
db.host.id
- The host ID of the connected client (all engines). -
db.host.name
- The host name of the connected client (all engines). -
db.name
- The name of the database to which the client is connected. Valid values are as follows:-
Aurora PostgreSQL
-
Amazon RDS PostgreSQL
-
Aurora MySQL
-
Amazon RDS MySQL
-
Amazon RDS MariaDB
-
Amazon DocumentDB
-
-
db.query.id
- The query ID generated by Performance Insights (only Amazon DocumentDB). -
db.query.db_id
- The query ID generated by the database (only Amazon DocumentDB). -
db.query.statement
- The text of the query that is being run (only Amazon DocumentDB). -
db.query.tokenized_id
-
db.query.tokenized.id
- The query digest ID generated by Performance Insights (only Amazon DocumentDB). -
db.query.tokenized.db_id
- The query digest ID generated by Performance Insights (only Amazon DocumentDB). -
db.query.tokenized.statement
- The text of the query digest (only Amazon DocumentDB). -
db.session_type.name
- The type of the current session (only Amazon DocumentDB). -
db.sql.id
- The hash of the full, non-tokenized SQL statement generated by Performance Insights (all engines except Amazon DocumentDB). -
db.sql.db_id
- Either the SQL ID generated by the database engine, or a value generated by Performance Insights that begins withpi-
(all engines except Amazon DocumentDB). -
db.sql.statement
- The full text of the SQL statement that is running, as inSELECT * FROM employees
(all engines except Amazon DocumentDB) -
db.sql.tokenized_id
- The hash of the SQL digest generated by Performance Insights (all engines except Amazon DocumentDB). Thedb.sql.tokenized_id
dimension fetches the value of thedb.sql_tokenized.id
dimension. Amazon RDS returnsdb.sql.tokenized_id
from thedb.sql
dimension group. -
db.sql_tokenized.id
- The hash of the SQL digest generated by Performance Insights (all engines except Amazon DocumentDB). In the console,db.sql_tokenized.id
is called the Support ID because Amazon Web Services Support can look at this data to help you troubleshoot database issues. -
db.sql_tokenized.db_id
- Either the native database ID used to refer to the SQL statement, or a synthetic ID such aspi-2372568224
that Performance Insights generates if the native database ID isn't available (all engines except Amazon DocumentDB). -
db.sql_tokenized.statement
- The text of the SQL digest, as inSELECT * FROM employees WHERE employee_id = ?
(all engines except Amazon DocumentDB) -
db.user.id
- The ID of the user logged in to the database (all engines except Amazon DocumentDB). -
db.user.name
- The name of the user logged in to the database (all engines except Amazon DocumentDB). -
db.wait_event.name
- The event for which the backend is waiting (all engines except Amazon DocumentDB). -
db.wait_event.type
- The type of event for which the backend is waiting (all engines except Amazon DocumentDB). -
db.wait_event_type.name
- The name of the event type for which the backend is waiting (all engines except Amazon DocumentDB). -
db.wait_state.name
- The event for which the backend is waiting (only Amazon DocumentDB).
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .dimensions.is_none()
.
Source§impl DimensionGroup
impl DimensionGroup
Sourcepub fn builder() -> DimensionGroupBuilder
pub fn builder() -> DimensionGroupBuilder
Creates a new builder-style object to manufacture DimensionGroup
.
Trait Implementations§
Source§impl Clone for DimensionGroup
impl Clone for DimensionGroup
Source§fn clone(&self) -> DimensionGroup
fn clone(&self) -> DimensionGroup
1.0.0 · Source§const fn clone_from(&mut self, source: &Self)
const fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for DimensionGroup
impl Debug for DimensionGroup
Source§impl PartialEq for DimensionGroup
impl PartialEq for DimensionGroup
impl StructuralPartialEq for DimensionGroup
Auto Trait Implementations§
impl Freeze for DimensionGroup
impl RefUnwindSafe for DimensionGroup
impl Send for DimensionGroup
impl Sync for DimensionGroup
impl Unpin for DimensionGroup
impl UnwindSafe for DimensionGroup
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);