2022/03/04 - Amazon DevOps Guru - 2 new4 updated api methods
Changes Amazon DevOps Guru now integrates with Amazon CodeGuru Profiler. You can view CodeGuru Profiler recommendations for your AWS Lambda function in DevOps Guru. This feature is enabled by default for new customers as of 3/4/2022. Existing customers can enable this feature with UpdateEventSourcesConfig.
Updates the event source configuration.
See also: AWS API Documentation
Request Syntax
client.update_event_sources_config(
EventSources={
'AmazonCodeGuruProfiler': {
'Status': 'ENABLED'|'DISABLED'
}
}
)
dict
The name of the event source.
AmazonCodeGuruProfiler (dict) --
Status (string) --
The status of the CodeGuru Profiler integration.
dict
Response Syntax
{}
Response Structure
(dict) --
This operation lists details about a DevOps Guru event source that is shared with your account.
See also: AWS API Documentation
Request Syntax
client.describe_event_sources_config()
dict
Response Syntax
{
'EventSources': {
'AmazonCodeGuruProfiler': {
'Status': 'ENABLED'|'DISABLED'
}
}
}
Response Structure
(dict) --
EventSources (dict) --
The name of the event source.
AmazonCodeGuruProfiler (dict) --
Status (string) --
The status of the CodeGuru Profiler integration.
{'ProactiveAnomaly': {'AnomalyResources': [{'Name': 'string',
'Type': 'string'}],
'SourceMetadata': {'Source': 'string',
'SourceResourceName': 'string',
'SourceResourceType': 'string'}}}
Returns details about an anomaly that you specify using its ID.
See also: AWS API Documentation
Request Syntax
client.describe_anomaly(
Id='string',
AccountId='string'
)
string
[REQUIRED]
The ID of the anomaly.
string
The ID of the member account.
dict
Response Syntax
{
'ProactiveAnomaly': {
'Id': 'string',
'Severity': 'LOW'|'MEDIUM'|'HIGH',
'Status': 'ONGOING'|'CLOSED',
'UpdateTime': datetime(2015, 1, 1),
'AnomalyTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'AnomalyReportedTimeRange': {
'OpenTime': datetime(2015, 1, 1),
'CloseTime': datetime(2015, 1, 1)
},
'PredictionTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'SourceDetails': {
'CloudWatchMetrics': [
{
'MetricName': 'string',
'Namespace': 'string',
'Dimensions': [
{
'Name': 'string',
'Value': 'string'
},
],
'Stat': 'Sum'|'Average'|'SampleCount'|'Minimum'|'Maximum'|'p99'|'p90'|'p50',
'Unit': 'string',
'Period': 123,
'MetricDataSummary': {
'TimestampMetricValuePairList': [
{
'Timestamp': datetime(2015, 1, 1),
'MetricValue': 123.0
},
],
'StatusCode': 'Complete'|'InternalError'|'PartialData'
}
},
],
'PerformanceInsightsMetrics': [
{
'MetricDisplayName': 'string',
'Unit': 'string',
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
},
'ReferenceData': [
{
'Name': 'string',
'ComparisonValues': {
'ReferenceScalar': {
'Value': 123.0
},
'ReferenceMetric': {
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
}
}
}
},
],
'StatsAtAnomaly': [
{
'Type': 'string',
'Value': 123.0
},
],
'StatsAtBaseline': [
{
'Type': 'string',
'Value': 123.0
},
]
},
]
},
'AssociatedInsightId': 'string',
'ResourceCollection': {
'CloudFormation': {
'StackNames': [
'string',
]
},
'Tags': [
{
'AppBoundaryKey': 'string',
'TagValues': [
'string',
]
},
]
},
'Limit': 123.0,
'SourceMetadata': {
'Source': 'string',
'SourceResourceName': 'string',
'SourceResourceType': 'string'
},
'AnomalyResources': [
{
'Name': 'string',
'Type': 'string'
},
]
},
'ReactiveAnomaly': {
'Id': 'string',
'Severity': 'LOW'|'MEDIUM'|'HIGH',
'Status': 'ONGOING'|'CLOSED',
'AnomalyTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'AnomalyReportedTimeRange': {
'OpenTime': datetime(2015, 1, 1),
'CloseTime': datetime(2015, 1, 1)
},
'SourceDetails': {
'CloudWatchMetrics': [
{
'MetricName': 'string',
'Namespace': 'string',
'Dimensions': [
{
'Name': 'string',
'Value': 'string'
},
],
'Stat': 'Sum'|'Average'|'SampleCount'|'Minimum'|'Maximum'|'p99'|'p90'|'p50',
'Unit': 'string',
'Period': 123,
'MetricDataSummary': {
'TimestampMetricValuePairList': [
{
'Timestamp': datetime(2015, 1, 1),
'MetricValue': 123.0
},
],
'StatusCode': 'Complete'|'InternalError'|'PartialData'
}
},
],
'PerformanceInsightsMetrics': [
{
'MetricDisplayName': 'string',
'Unit': 'string',
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
},
'ReferenceData': [
{
'Name': 'string',
'ComparisonValues': {
'ReferenceScalar': {
'Value': 123.0
},
'ReferenceMetric': {
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
}
}
}
},
],
'StatsAtAnomaly': [
{
'Type': 'string',
'Value': 123.0
},
],
'StatsAtBaseline': [
{
'Type': 'string',
'Value': 123.0
},
]
},
]
},
'AssociatedInsightId': 'string',
'ResourceCollection': {
'CloudFormation': {
'StackNames': [
'string',
]
},
'Tags': [
{
'AppBoundaryKey': 'string',
'TagValues': [
'string',
]
},
]
},
'Type': 'CAUSAL'|'CONTEXTUAL',
'Name': 'string',
'Description': 'string',
'CausalAnomalyId': 'string',
'AnomalyResources': [
{
'Name': 'string',
'Type': 'string'
},
]
}
}
Response Structure
(dict) --
ProactiveAnomaly (dict) --
A ProactiveAnomaly object that represents the requested anomaly.
Id (string) --
The ID of a proactive anomaly.
Severity (string) --
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
Status (string) --
The status of a proactive anomaly.
UpdateTime (datetime) --
The time of the anomaly's most recent update.
AnomalyTimeRange (dict) --
A time range that specifies when the observed unusual behavior in an anomaly started and ended. This is different from AnomalyReportedTimeRange, which specifies the time range when DevOps Guru opens and then closes an anomaly.
StartTime (datetime) --
The time when the anomalous behavior started.
EndTime (datetime) --
The time when the anomalous behavior ended.
AnomalyReportedTimeRange (dict) --
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened and the time when it is closed.
OpenTime (datetime) --
The time when an anomaly is opened.
CloseTime (datetime) --
The time when an anomaly is closed.
PredictionTimeRange (dict) --
The time range during which anomalous behavior in a proactive anomaly or an insight is expected to occur.
StartTime (datetime) --
The time range during which a metric limit is expected to be exceeded. This applies to proactive insights only.
EndTime (datetime) --
The time when the behavior in a proactive insight is expected to end.
SourceDetails (dict) --
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
CloudWatchMetrics (list) --
An array of CloudWatchMetricsDetail objects that contain information about analyzed CloudWatch metrics that show anomalous behavior.
(dict) --
Information about an Amazon CloudWatch metric.
MetricName (string) --
The name of the CloudWatch metric.
Namespace (string) --
The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
Dimensions (list) --
An array of CloudWatch dimensions associated with
(dict) --
The dimension of am Amazon CloudWatch metric that is used when DevOps Guru analyzes the resources in your account for operational problems and anomalous behavior. A dimension is a name/value pair that is part of the identity of a metric. A metric can have up to 10 dimensions. For more information, see Dimensions in the Amazon CloudWatch User Guide.
Name (string) --
The name of the CloudWatch dimension.
Value (string) --
The value of the CloudWatch dimension.
Stat (string) --
The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
Unit (string) --
The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds, Count, and Percent.
Period (integer) --
The length of time associated with the CloudWatch metric in number of seconds.
MetricDataSummary (dict) --
This object returns anomaly metric data.
TimestampMetricValuePairList (list) --
This is a list of Amazon CloudWatch metric values at given timestamp.
(dict) --
A pair that contains metric values at the respective timestamp.
Timestamp (datetime) --
A Timestamp that specifies the time the event occurred.
MetricValue (float) --
Value of the anomalous metric data point at respective Timestamp.
StatusCode (string) --
This is an enum of the status showing whether the metric value pair list has partial or complete data, or if there was an error.
PerformanceInsightsMetrics (list) --
An array of PerformanceInsightsMetricsDetail objects that contain information about analyzed Performance Insights metrics that show anomalous behavior.
(dict) --
Details about Performance Insights metrics.
Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.
To learn more about Performance Insights and Amazon Aurora DB instances, go to the Amazon Aurora User Guide.
To learn more about Performance Insights and Amazon RDS DB instances, go to the Amazon RDS User Guide.
MetricDisplayName (string) --
The name used for a specific Performance Insights metric.
Unit (string) --
The unit of measure for a metric. For example, a session or a process.
MetricQuery (dict) --
A single query to be processed for the metric. For more information, see ``PerformanceInsightsMetricQuery ``.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
ReferenceData (list) --
For more information, see ``PerformanceInsightsReferenceData ``.
(dict) --
Reference data used to evaluate Performance Insights to determine if its performance is anomalous or not.
Name (string) --
The name of the reference data.
ComparisonValues (dict) --
The specific reference values used to evaluate the Performance Insights. For more information, see ``PerformanceInsightsReferenceComparisonValues ``.
ReferenceScalar (dict) --
A scalar value DevOps Guru for a metric that DevOps Guru compares to actual metric values. This reference value is used to determine if an actual metric value should be considered anomalous.
Value (float) --
The reference value.
ReferenceMetric (dict) --
A metric that DevOps Guru compares to actual metric values. This reference metric is used to determine if an actual metric should be considered anomalous.
MetricQuery (dict) --
A query to be processed on the metric.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
StatsAtAnomaly (list) --
The metric statistics during the anomalous period detected by DevOps Guru;
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
StatsAtBaseline (list) --
Typical metric statistics that are not considered anomalous. When DevOps Guru analyzes metrics, it compares them to StatsAtBaseline to help determine if they are anomalous.
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
AssociatedInsightId (string) --
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection (dict) --
A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
CloudFormation (dict) --
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
StackNames (list) --
An array of CloudFormation stack names.
(string) --
Tags (list) --
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
(dict) --
A collection of Amazon Web Services stags.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
AppBoundaryKey (string) --
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
TagValues (list) --
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example, 111122223333, Production, or a team name). The key and value are the tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
(string) --
Limit (float) --
A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
SourceMetadata (dict) --
The metadata for the anomaly.
Source (string) --
The source of the anomaly.
SourceResourceName (string) --
The name of the anomaly's resource.
SourceResourceType (string) --
The anomaly's resource type.
AnomalyResources (list) --
Information about a resource in which DevOps Guru detected anomalous behavior.
(dict) --
The Amazon Web Services resources in which DevOps Guru detected unusual behavior that resulted in the generation of an anomaly. When DevOps Guru detects multiple related anomalies, it creates and insight with details about the anomalous behavior and suggestions about how to correct the problem.
Name (string) --
The name of the Amazon Web Services resource.
Type (string) --
The type of the Amazon Web Services resource.
ReactiveAnomaly (dict) --
A ReactiveAnomaly object that represents the requested anomaly.
Id (string) --
The ID of the reactive anomaly.
Severity (string) --
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
Status (string) --
The status of the anomaly.
AnomalyTimeRange (dict) --
A time range that specifies when the observed unusual behavior in an anomaly started and ended. This is different from AnomalyReportedTimeRange, which specifies the time range when DevOps Guru opens and then closes an anomaly.
StartTime (datetime) --
The time when the anomalous behavior started.
EndTime (datetime) --
The time when the anomalous behavior ended.
AnomalyReportedTimeRange (dict) --
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened and the time when it is closed.
OpenTime (datetime) --
The time when an anomaly is opened.
CloseTime (datetime) --
The time when an anomaly is closed.
SourceDetails (dict) --
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
CloudWatchMetrics (list) --
An array of CloudWatchMetricsDetail objects that contain information about analyzed CloudWatch metrics that show anomalous behavior.
(dict) --
Information about an Amazon CloudWatch metric.
MetricName (string) --
The name of the CloudWatch metric.
Namespace (string) --
The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
Dimensions (list) --
An array of CloudWatch dimensions associated with
(dict) --
The dimension of am Amazon CloudWatch metric that is used when DevOps Guru analyzes the resources in your account for operational problems and anomalous behavior. A dimension is a name/value pair that is part of the identity of a metric. A metric can have up to 10 dimensions. For more information, see Dimensions in the Amazon CloudWatch User Guide.
Name (string) --
The name of the CloudWatch dimension.
Value (string) --
The value of the CloudWatch dimension.
Stat (string) --
The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
Unit (string) --
The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds, Count, and Percent.
Period (integer) --
The length of time associated with the CloudWatch metric in number of seconds.
MetricDataSummary (dict) --
This object returns anomaly metric data.
TimestampMetricValuePairList (list) --
This is a list of Amazon CloudWatch metric values at given timestamp.
(dict) --
A pair that contains metric values at the respective timestamp.
Timestamp (datetime) --
A Timestamp that specifies the time the event occurred.
MetricValue (float) --
Value of the anomalous metric data point at respective Timestamp.
StatusCode (string) --
This is an enum of the status showing whether the metric value pair list has partial or complete data, or if there was an error.
PerformanceInsightsMetrics (list) --
An array of PerformanceInsightsMetricsDetail objects that contain information about analyzed Performance Insights metrics that show anomalous behavior.
(dict) --
Details about Performance Insights metrics.
Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.
To learn more about Performance Insights and Amazon Aurora DB instances, go to the Amazon Aurora User Guide.
To learn more about Performance Insights and Amazon RDS DB instances, go to the Amazon RDS User Guide.
MetricDisplayName (string) --
The name used for a specific Performance Insights metric.
Unit (string) --
The unit of measure for a metric. For example, a session or a process.
MetricQuery (dict) --
A single query to be processed for the metric. For more information, see ``PerformanceInsightsMetricQuery ``.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
ReferenceData (list) --
For more information, see ``PerformanceInsightsReferenceData ``.
(dict) --
Reference data used to evaluate Performance Insights to determine if its performance is anomalous or not.
Name (string) --
The name of the reference data.
ComparisonValues (dict) --
The specific reference values used to evaluate the Performance Insights. For more information, see ``PerformanceInsightsReferenceComparisonValues ``.
ReferenceScalar (dict) --
A scalar value DevOps Guru for a metric that DevOps Guru compares to actual metric values. This reference value is used to determine if an actual metric value should be considered anomalous.
Value (float) --
The reference value.
ReferenceMetric (dict) --
A metric that DevOps Guru compares to actual metric values. This reference metric is used to determine if an actual metric should be considered anomalous.
MetricQuery (dict) --
A query to be processed on the metric.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
StatsAtAnomaly (list) --
The metric statistics during the anomalous period detected by DevOps Guru;
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
StatsAtBaseline (list) --
Typical metric statistics that are not considered anomalous. When DevOps Guru analyzes metrics, it compares them to StatsAtBaseline to help determine if they are anomalous.
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
AssociatedInsightId (string) --
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection (dict) --
A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
CloudFormation (dict) --
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
StackNames (list) --
An array of CloudFormation stack names.
(string) --
Tags (list) --
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
(dict) --
A collection of Amazon Web Services stags.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
AppBoundaryKey (string) --
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
TagValues (list) --
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example, 111122223333, Production, or a team name). The key and value are the tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
(string) --
Type (string) --
The type of the reactive anomaly. It can be one of the following types.
CAUSAL - the anomaly can cause a new insight.
CONTEXTUAL - the anomaly contains additional information about an insight or its causal anomaly.
Name (string) --
The name of the reactive anomaly.
Description (string) --
A description of the reactive anomaly.
CausalAnomalyId (string) --
The ID of the causal anomaly that is associated with this reactive anomaly. The ID of a CAUSAL anomaly is always NULL.
AnomalyResources (list) --
The Amazon Web Services resources in which anomalous behavior was detected by DevOps Guru.
(dict) --
The Amazon Web Services resources in which DevOps Guru detected unusual behavior that resulted in the generation of an anomaly. When DevOps Guru detects multiple related anomalies, it creates and insight with details about the anomalous behavior and suggestions about how to correct the problem.
Name (string) --
The name of the Amazon Web Services resource.
Type (string) --
The type of the Amazon Web Services resource.
{'ProactiveInsight': {'Description': 'string'},
'ReactiveInsight': {'Description': 'string'}}
Returns details about an insight that you specify using its ID.
See also: AWS API Documentation
Request Syntax
client.describe_insight(
Id='string',
AccountId='string'
)
string
[REQUIRED]
The ID of the insight.
string
The ID of the member account in the organization.
dict
Response Syntax
{
'ProactiveInsight': {
'Id': 'string',
'Name': 'string',
'Severity': 'LOW'|'MEDIUM'|'HIGH',
'Status': 'ONGOING'|'CLOSED',
'InsightTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'PredictionTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'ResourceCollection': {
'CloudFormation': {
'StackNames': [
'string',
]
},
'Tags': [
{
'AppBoundaryKey': 'string',
'TagValues': [
'string',
]
},
]
},
'SsmOpsItemId': 'string',
'Description': 'string'
},
'ReactiveInsight': {
'Id': 'string',
'Name': 'string',
'Severity': 'LOW'|'MEDIUM'|'HIGH',
'Status': 'ONGOING'|'CLOSED',
'InsightTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'ResourceCollection': {
'CloudFormation': {
'StackNames': [
'string',
]
},
'Tags': [
{
'AppBoundaryKey': 'string',
'TagValues': [
'string',
]
},
]
},
'SsmOpsItemId': 'string',
'Description': 'string'
}
}
Response Structure
(dict) --
ProactiveInsight (dict) --
A ProactiveInsight object that represents the requested insight.
Id (string) --
The ID of the proactive insight.
Name (string) --
The name of the proactive insight.
Severity (string) --
The severity of the insight. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
Status (string) --
The status of the proactive insight.
InsightTimeRange (dict) --
A time ranged that specifies when the observed behavior in an insight started and ended.
StartTime (datetime) --
The time when the behavior described in an insight started.
EndTime (datetime) --
The time when the behavior described in an insight ended.
PredictionTimeRange (dict) --
The time range during which anomalous behavior in a proactive anomaly or an insight is expected to occur.
StartTime (datetime) --
The time range during which a metric limit is expected to be exceeded. This applies to proactive insights only.
EndTime (datetime) --
The time when the behavior in a proactive insight is expected to end.
ResourceCollection (dict) --
A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
CloudFormation (dict) --
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
StackNames (list) --
An array of CloudFormation stack names.
(string) --
Tags (list) --
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
(dict) --
A collection of Amazon Web Services stags.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
AppBoundaryKey (string) --
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
TagValues (list) --
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example, 111122223333, Production, or a team name). The key and value are the tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
(string) --
SsmOpsItemId (string) --
The ID of the Amazon Web Services System Manager OpsItem created for this insight. You must enable the creation of OpstItems insights before they are created for each insight.
Description (string) --
Describes the proactive insight.
ReactiveInsight (dict) --
A ReactiveInsight object that represents the requested insight.
Id (string) --
The ID of a reactive insight.
Name (string) --
The name of a reactive insight.
Severity (string) --
The severity of the insight. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
Status (string) --
The status of a reactive insight.
InsightTimeRange (dict) --
A time ranged that specifies when the observed behavior in an insight started and ended.
StartTime (datetime) --
The time when the behavior described in an insight started.
EndTime (datetime) --
The time when the behavior described in an insight ended.
ResourceCollection (dict) --
A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
CloudFormation (dict) --
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
StackNames (list) --
An array of CloudFormation stack names.
(string) --
Tags (list) --
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
(dict) --
A collection of Amazon Web Services stags.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
AppBoundaryKey (string) --
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
TagValues (list) --
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example, 111122223333, Production, or a team name). The key and value are the tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
(string) --
SsmOpsItemId (string) --
The ID of the Amazon Web Services System Manager OpsItem created for this insight. You must enable the creation of OpstItems insights before they are created for each insight.
Description (string) --
Describes the reactive insight.
{'ProactiveAnomalies': {'AnomalyResources': [{'Name': 'string',
'Type': 'string'}],
'SourceMetadata': {'Source': 'string',
'SourceResourceName': 'string',
'SourceResourceType': 'string'}}}
Returns a list of the anomalies that belong to an insight that you specify using its ID.
See also: AWS API Documentation
Request Syntax
client.list_anomalies_for_insight(
InsightId='string',
StartTimeRange={
'FromTime': datetime(2015, 1, 1),
'ToTime': datetime(2015, 1, 1)
},
MaxResults=123,
NextToken='string',
AccountId='string'
)
string
[REQUIRED]
The ID of the insight. The returned anomalies belong to this insight.
dict
A time range used to specify when the requested anomalies started. All returned anomalies started during this time range.
FromTime (datetime) --
The start time of the time range.
ToTime (datetime) --
The end time of the time range.
integer
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
string
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
string
The ID of the Amazon Web Services account.
dict
Response Syntax
{
'ProactiveAnomalies': [
{
'Id': 'string',
'Severity': 'LOW'|'MEDIUM'|'HIGH',
'Status': 'ONGOING'|'CLOSED',
'UpdateTime': datetime(2015, 1, 1),
'AnomalyTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'AnomalyReportedTimeRange': {
'OpenTime': datetime(2015, 1, 1),
'CloseTime': datetime(2015, 1, 1)
},
'PredictionTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'SourceDetails': {
'CloudWatchMetrics': [
{
'MetricName': 'string',
'Namespace': 'string',
'Dimensions': [
{
'Name': 'string',
'Value': 'string'
},
],
'Stat': 'Sum'|'Average'|'SampleCount'|'Minimum'|'Maximum'|'p99'|'p90'|'p50',
'Unit': 'string',
'Period': 123,
'MetricDataSummary': {
'TimestampMetricValuePairList': [
{
'Timestamp': datetime(2015, 1, 1),
'MetricValue': 123.0
},
],
'StatusCode': 'Complete'|'InternalError'|'PartialData'
}
},
],
'PerformanceInsightsMetrics': [
{
'MetricDisplayName': 'string',
'Unit': 'string',
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
},
'ReferenceData': [
{
'Name': 'string',
'ComparisonValues': {
'ReferenceScalar': {
'Value': 123.0
},
'ReferenceMetric': {
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
}
}
}
},
],
'StatsAtAnomaly': [
{
'Type': 'string',
'Value': 123.0
},
],
'StatsAtBaseline': [
{
'Type': 'string',
'Value': 123.0
},
]
},
]
},
'AssociatedInsightId': 'string',
'ResourceCollection': {
'CloudFormation': {
'StackNames': [
'string',
]
},
'Tags': [
{
'AppBoundaryKey': 'string',
'TagValues': [
'string',
]
},
]
},
'Limit': 123.0,
'SourceMetadata': {
'Source': 'string',
'SourceResourceName': 'string',
'SourceResourceType': 'string'
},
'AnomalyResources': [
{
'Name': 'string',
'Type': 'string'
},
]
},
],
'ReactiveAnomalies': [
{
'Id': 'string',
'Severity': 'LOW'|'MEDIUM'|'HIGH',
'Status': 'ONGOING'|'CLOSED',
'AnomalyTimeRange': {
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
'AnomalyReportedTimeRange': {
'OpenTime': datetime(2015, 1, 1),
'CloseTime': datetime(2015, 1, 1)
},
'SourceDetails': {
'CloudWatchMetrics': [
{
'MetricName': 'string',
'Namespace': 'string',
'Dimensions': [
{
'Name': 'string',
'Value': 'string'
},
],
'Stat': 'Sum'|'Average'|'SampleCount'|'Minimum'|'Maximum'|'p99'|'p90'|'p50',
'Unit': 'string',
'Period': 123,
'MetricDataSummary': {
'TimestampMetricValuePairList': [
{
'Timestamp': datetime(2015, 1, 1),
'MetricValue': 123.0
},
],
'StatusCode': 'Complete'|'InternalError'|'PartialData'
}
},
],
'PerformanceInsightsMetrics': [
{
'MetricDisplayName': 'string',
'Unit': 'string',
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
},
'ReferenceData': [
{
'Name': 'string',
'ComparisonValues': {
'ReferenceScalar': {
'Value': 123.0
},
'ReferenceMetric': {
'MetricQuery': {
'Metric': 'string',
'GroupBy': {
'Group': 'string',
'Dimensions': [
'string',
],
'Limit': 123
},
'Filter': {
'string': 'string'
}
}
}
}
},
],
'StatsAtAnomaly': [
{
'Type': 'string',
'Value': 123.0
},
],
'StatsAtBaseline': [
{
'Type': 'string',
'Value': 123.0
},
]
},
]
},
'AssociatedInsightId': 'string',
'ResourceCollection': {
'CloudFormation': {
'StackNames': [
'string',
]
},
'Tags': [
{
'AppBoundaryKey': 'string',
'TagValues': [
'string',
]
},
]
},
'Type': 'CAUSAL'|'CONTEXTUAL',
'Name': 'string',
'Description': 'string',
'CausalAnomalyId': 'string',
'AnomalyResources': [
{
'Name': 'string',
'Type': 'string'
},
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
ProactiveAnomalies (list) --
An array of ProactiveAnomalySummary objects that represent the requested anomalies
(dict) --
Details about a proactive anomaly. This object is returned by DescribeAnomaly.
Id (string) --
The ID of the anomaly.
Severity (string) --
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
Status (string) --
The status of the anomaly.
UpdateTime (datetime) --
The time of the anomaly's most recent update.
AnomalyTimeRange (dict) --
A time range that specifies when the observed unusual behavior in an anomaly started and ended. This is different from AnomalyReportedTimeRange, which specifies the time range when DevOps Guru opens and then closes an anomaly.
StartTime (datetime) --
The time when the anomalous behavior started.
EndTime (datetime) --
The time when the anomalous behavior ended.
AnomalyReportedTimeRange (dict) --
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened and the time when it is closed.
OpenTime (datetime) --
The time when an anomaly is opened.
CloseTime (datetime) --
The time when an anomaly is closed.
PredictionTimeRange (dict) --
The time range during which anomalous behavior in a proactive anomaly or an insight is expected to occur.
StartTime (datetime) --
The time range during which a metric limit is expected to be exceeded. This applies to proactive insights only.
EndTime (datetime) --
The time when the behavior in a proactive insight is expected to end.
SourceDetails (dict) --
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
CloudWatchMetrics (list) --
An array of CloudWatchMetricsDetail objects that contain information about analyzed CloudWatch metrics that show anomalous behavior.
(dict) --
Information about an Amazon CloudWatch metric.
MetricName (string) --
The name of the CloudWatch metric.
Namespace (string) --
The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
Dimensions (list) --
An array of CloudWatch dimensions associated with
(dict) --
The dimension of am Amazon CloudWatch metric that is used when DevOps Guru analyzes the resources in your account for operational problems and anomalous behavior. A dimension is a name/value pair that is part of the identity of a metric. A metric can have up to 10 dimensions. For more information, see Dimensions in the Amazon CloudWatch User Guide.
Name (string) --
The name of the CloudWatch dimension.
Value (string) --
The value of the CloudWatch dimension.
Stat (string) --
The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
Unit (string) --
The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds, Count, and Percent.
Period (integer) --
The length of time associated with the CloudWatch metric in number of seconds.
MetricDataSummary (dict) --
This object returns anomaly metric data.
TimestampMetricValuePairList (list) --
This is a list of Amazon CloudWatch metric values at given timestamp.
(dict) --
A pair that contains metric values at the respective timestamp.
Timestamp (datetime) --
A Timestamp that specifies the time the event occurred.
MetricValue (float) --
Value of the anomalous metric data point at respective Timestamp.
StatusCode (string) --
This is an enum of the status showing whether the metric value pair list has partial or complete data, or if there was an error.
PerformanceInsightsMetrics (list) --
An array of PerformanceInsightsMetricsDetail objects that contain information about analyzed Performance Insights metrics that show anomalous behavior.
(dict) --
Details about Performance Insights metrics.
Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.
To learn more about Performance Insights and Amazon Aurora DB instances, go to the Amazon Aurora User Guide.
To learn more about Performance Insights and Amazon RDS DB instances, go to the Amazon RDS User Guide.
MetricDisplayName (string) --
The name used for a specific Performance Insights metric.
Unit (string) --
The unit of measure for a metric. For example, a session or a process.
MetricQuery (dict) --
A single query to be processed for the metric. For more information, see ``PerformanceInsightsMetricQuery ``.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
ReferenceData (list) --
For more information, see ``PerformanceInsightsReferenceData ``.
(dict) --
Reference data used to evaluate Performance Insights to determine if its performance is anomalous or not.
Name (string) --
The name of the reference data.
ComparisonValues (dict) --
The specific reference values used to evaluate the Performance Insights. For more information, see ``PerformanceInsightsReferenceComparisonValues ``.
ReferenceScalar (dict) --
A scalar value DevOps Guru for a metric that DevOps Guru compares to actual metric values. This reference value is used to determine if an actual metric value should be considered anomalous.
Value (float) --
The reference value.
ReferenceMetric (dict) --
A metric that DevOps Guru compares to actual metric values. This reference metric is used to determine if an actual metric should be considered anomalous.
MetricQuery (dict) --
A query to be processed on the metric.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
StatsAtAnomaly (list) --
The metric statistics during the anomalous period detected by DevOps Guru;
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
StatsAtBaseline (list) --
Typical metric statistics that are not considered anomalous. When DevOps Guru analyzes metrics, it compares them to StatsAtBaseline to help determine if they are anomalous.
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
AssociatedInsightId (string) --
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection (dict) --
A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
CloudFormation (dict) --
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
StackNames (list) --
An array of CloudFormation stack names.
(string) --
Tags (list) --
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
(dict) --
A collection of Amazon Web Services stags.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
AppBoundaryKey (string) --
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
TagValues (list) --
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example, 111122223333, Production, or a team name). The key and value are the tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
(string) --
Limit (float) --
A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
SourceMetadata (dict) --
Returns the metadata of the source.
Source (string) --
The source of the anomaly.
SourceResourceName (string) --
The name of the anomaly's resource.
SourceResourceType (string) --
The anomaly's resource type.
AnomalyResources (list) --
Information about a resource in which DevOps Guru detected anomalous behavior.
(dict) --
The Amazon Web Services resources in which DevOps Guru detected unusual behavior that resulted in the generation of an anomaly. When DevOps Guru detects multiple related anomalies, it creates and insight with details about the anomalous behavior and suggestions about how to correct the problem.
Name (string) --
The name of the Amazon Web Services resource.
Type (string) --
The type of the Amazon Web Services resource.
ReactiveAnomalies (list) --
An array of ReactiveAnomalySummary objects that represent the requested anomalies
(dict) --
Details about a reactive anomaly. This object is returned by DescribeAnomaly.
Id (string) --
The ID of the reactive anomaly.
Severity (string) --
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
Status (string) --
The status of the reactive anomaly.
AnomalyTimeRange (dict) --
A time range that specifies when the observed unusual behavior in an anomaly started and ended. This is different from AnomalyReportedTimeRange, which specifies the time range when DevOps Guru opens and then closes an anomaly.
StartTime (datetime) --
The time when the anomalous behavior started.
EndTime (datetime) --
The time when the anomalous behavior ended.
AnomalyReportedTimeRange (dict) --
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened and the time when it is closed.
OpenTime (datetime) --
The time when an anomaly is opened.
CloseTime (datetime) --
The time when an anomaly is closed.
SourceDetails (dict) --
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
CloudWatchMetrics (list) --
An array of CloudWatchMetricsDetail objects that contain information about analyzed CloudWatch metrics that show anomalous behavior.
(dict) --
Information about an Amazon CloudWatch metric.
MetricName (string) --
The name of the CloudWatch metric.
Namespace (string) --
The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
Dimensions (list) --
An array of CloudWatch dimensions associated with
(dict) --
The dimension of am Amazon CloudWatch metric that is used when DevOps Guru analyzes the resources in your account for operational problems and anomalous behavior. A dimension is a name/value pair that is part of the identity of a metric. A metric can have up to 10 dimensions. For more information, see Dimensions in the Amazon CloudWatch User Guide.
Name (string) --
The name of the CloudWatch dimension.
Value (string) --
The value of the CloudWatch dimension.
Stat (string) --
The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
Unit (string) --
The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds, Count, and Percent.
Period (integer) --
The length of time associated with the CloudWatch metric in number of seconds.
MetricDataSummary (dict) --
This object returns anomaly metric data.
TimestampMetricValuePairList (list) --
This is a list of Amazon CloudWatch metric values at given timestamp.
(dict) --
A pair that contains metric values at the respective timestamp.
Timestamp (datetime) --
A Timestamp that specifies the time the event occurred.
MetricValue (float) --
Value of the anomalous metric data point at respective Timestamp.
StatusCode (string) --
This is an enum of the status showing whether the metric value pair list has partial or complete data, or if there was an error.
PerformanceInsightsMetrics (list) --
An array of PerformanceInsightsMetricsDetail objects that contain information about analyzed Performance Insights metrics that show anomalous behavior.
(dict) --
Details about Performance Insights metrics.
Amazon RDS Performance Insights enables you to monitor and explore different dimensions of database load based on data captured from a running DB instance. DB load is measured as average active sessions. Performance Insights provides the data to API consumers as a two-dimensional time-series dataset. The time dimension provides DB load data for each time point in the queried time range. Each time point decomposes overall load in relation to the requested dimensions, measured at that time point. Examples include SQL, Wait event, User, and Host.
To learn more about Performance Insights and Amazon Aurora DB instances, go to the Amazon Aurora User Guide.
To learn more about Performance Insights and Amazon RDS DB instances, go to the Amazon RDS User Guide.
MetricDisplayName (string) --
The name used for a specific Performance Insights metric.
Unit (string) --
The unit of measure for a metric. For example, a session or a process.
MetricQuery (dict) --
A single query to be processed for the metric. For more information, see ``PerformanceInsightsMetricQuery ``.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
ReferenceData (list) --
For more information, see ``PerformanceInsightsReferenceData ``.
(dict) --
Reference data used to evaluate Performance Insights to determine if its performance is anomalous or not.
Name (string) --
The name of the reference data.
ComparisonValues (dict) --
The specific reference values used to evaluate the Performance Insights. For more information, see ``PerformanceInsightsReferenceComparisonValues ``.
ReferenceScalar (dict) --
A scalar value DevOps Guru for a metric that DevOps Guru compares to actual metric values. This reference value is used to determine if an actual metric value should be considered anomalous.
Value (float) --
The reference value.
ReferenceMetric (dict) --
A metric that DevOps Guru compares to actual metric values. This reference metric is used to determine if an actual metric should be considered anomalous.
MetricQuery (dict) --
A query to be processed on the metric.
Metric (string) --
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold, db.load.avg and db.sampledload.avg are the same value. If the number of active sessions is greater than the internal threshold, Performance Insights samples the active sessions, with db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and db.sampledload.avg less than db.load.avg. For most use cases, you can query db.load.avg only.
GroupBy (dict) --
The specification for how to aggregate the data points from a Performance Insights GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within that group, unless you provide the names of specific dimensions within that group. You can also request that Performance Insights return a limited number of values for a dimension.
Group (string) --
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
Dimensions (list) --
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 (only Aurora PostgreSQL and RDS PostgreSQL)
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 (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
(string) --
Limit (integer) --
The maximum number of items to fetch for this dimension group.
Filter (dict) --
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
(string) --
(string) --
StatsAtAnomaly (list) --
The metric statistics during the anomalous period detected by DevOps Guru;
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
StatsAtBaseline (list) --
Typical metric statistics that are not considered anomalous. When DevOps Guru analyzes metrics, it compares them to StatsAtBaseline to help determine if they are anomalous.
(dict) --
A statistic in a Performance Insights collection.
Type (string) --
The statistic type.
Value (float) --
The value of the statistic.
AssociatedInsightId (string) --
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection (dict) --
A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
CloudFormation (dict) --
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
StackNames (list) --
An array of CloudFormation stack names.
(string) --
Tags (list) --
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
(dict) --
A collection of Amazon Web Services stags.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production, or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive.
Together these are known as key-value pairs.
AppBoundaryKey (string) --
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
TagValues (list) --
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example, 111122223333, Production, or a team name). The key and value are the tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys, tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
(string) --
Type (string) --
The type of the reactive anomaly. It can be one of the following types.
CAUSAL - the anomaly can cause a new insight.
CONTEXTUAL - the anomaly contains additional information about an insight or its causal anomaly.
Name (string) --
The name of the reactive anomaly.
Description (string) --
A description of the reactive anomaly.
CausalAnomalyId (string) --
The ID of the causal anomaly that is associated with this reactive anomaly. The ID of a CAUSAL anomaly is always NULL.
AnomalyResources (list) --
The Amazon Web Services resources in which anomalous behavior was detected by DevOps Guru.
(dict) --
The Amazon Web Services resources in which DevOps Guru detected unusual behavior that resulted in the generation of an anomaly. When DevOps Guru detects multiple related anomalies, it creates and insight with details about the anomalous behavior and suggestions about how to correct the problem.
Name (string) --
The name of the Amazon Web Services resource.
Type (string) --
The type of the Amazon Web Services resource.
NextToken (string) --
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
{'Recommendations': {'Category': 'string'}}
Returns a list of a specified insight's recommendations. Each recommendation includes a list of related metrics and a list of related events.
See also: AWS API Documentation
Request Syntax
client.list_recommendations(
InsightId='string',
NextToken='string',
Locale='DE_DE'|'EN_US'|'EN_GB'|'ES_ES'|'FR_FR'|'IT_IT'|'JA_JP'|'KO_KR'|'PT_BR'|'ZH_CN'|'ZH_TW',
AccountId='string'
)
string
[REQUIRED]
The ID of the requested insight.
string
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
string
A locale that specifies the language to use for recommendations.
string
The ID of the Amazon Web Services account.
dict
Response Syntax
{
'Recommendations': [
{
'Description': 'string',
'Link': 'string',
'Name': 'string',
'Reason': 'string',
'RelatedEvents': [
{
'Name': 'string',
'Resources': [
{
'Name': 'string',
'Type': 'string'
},
]
},
],
'RelatedAnomalies': [
{
'Resources': [
{
'Name': 'string',
'Type': 'string'
},
],
'SourceDetails': [
{
'CloudWatchMetrics': [
{
'MetricName': 'string',
'Namespace': 'string'
},
]
},
],
'AnomalyId': 'string'
},
],
'Category': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Recommendations (list) --
An array of the requested recommendations.
(dict) --
Recommendation information to help you remediate detected anomalous behavior that generated an insight.
Description (string) --
A description of the problem.
Link (string) --
A hyperlink to information to help you address the problem.
Name (string) --
The name of the recommendation.
Reason (string) --
The reason DevOps Guru flagged the anomalous behavior as a problem.
RelatedEvents (list) --
Events that are related to the problem. Use these events to learn more about what's happening and to help address the issue.
(dict) --
Information about an event that is related to a recommendation.
Name (string) --
The name of the event. This corresponds to the Name field in an Event object.
Resources (list) --
A ResourceCollection object that contains arrays of the names of Amazon Web Services CloudFormation stacks. You can specify up to 500 Amazon Web Services CloudFormation stacks.
(dict) --
Information about an Amazon Web Services resource that emitted and event that is related to a recommendation in an insight.
Name (string) --
The name of the resource that emitted the event. This corresponds to the Name field in an EventResource object.
Type (string) --
The type of the resource that emitted the event. This corresponds to the Type field in an EventResource object.
RelatedAnomalies (list) --
Anomalies that are related to the problem. Use these Anomalies to learn more about what's happening and to help address the issue.
(dict) --
Information about an anomaly that is related to a recommendation.
Resources (list) --
An array of objects that represent resources in which DevOps Guru detected anomalous behavior. Each object contains the name and type of the resource.
(dict) --
Information about a resource in which DevOps Guru detected anomalous behavior.
Name (string) --
The name of the resource.
Type (string) --
The type of the resource. Resource types take the same form that is used by Amazon Web Services CloudFormation resource type identifiers, service-provider::service-name::data-type-name. For example, AWS::RDS::DBCluster. For more information, see Amazon Web Services resource and property types reference in the Amazon Web Services CloudFormation User Guide.
SourceDetails (list) --
Information about where the anomalous behavior related the recommendation was found. For example, details in Amazon CloudWatch metrics.
(dict) --
Contains an array of RecommendationRelatedCloudWatchMetricsSourceDetail objects that contain the name and namespace of an Amazon CloudWatch metric.
CloudWatchMetrics (list) --
An array of CloudWatchMetricsDetail objects that contains information about the analyzed metrics that displayed anomalous behavior.
(dict) --
Information about an Amazon CloudWatch metric that is analyzed by DevOps Guru. It is one of many analyzed metrics that are used to generate insights.
MetricName (string) --
The name of the CloudWatch metric.
Namespace (string) --
The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
AnomalyId (string) --
The ID of an anomaly that generated the insight with this recommendation.
Category (string) --
The category type of the recommendation.
NextToken (string) --
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.