DevOpsGuru ********** Client ====== class DevOpsGuru.Client A low-level client representing Amazon DevOps Guru Amazon DevOps Guru is a fully managed service that helps you identify anomalous behavior in business critical operational applications. You specify the Amazon Web Services resources that you want DevOps Guru to cover, then the Amazon CloudWatch metrics and Amazon Web Services CloudTrail events related to those resources are analyzed. When anomalous behavior is detected, DevOps Guru creates an *insight* that includes recommendations, related events, and related metrics that can help you improve your operational applications. For more information, see What is Amazon DevOps Guru. You can specify 1 or 2 Amazon Simple Notification Service topics so you are notified every time a new insight is created. You can also enable DevOps Guru to generate an OpsItem in Amazon Web Services Systems Manager for each insight to help you manage and track your work addressing insights. To learn about the DevOps Guru workflow, see How DevOps Guru works. To learn about DevOps Guru concepts, see Concepts in DevOps Guru. import boto3 client = boto3.client('devops-guru') These are the available methods: * add_notification_channel * can_paginate * close * delete_insight * describe_account_health * describe_account_overview * describe_anomaly * describe_event_sources_config * describe_feedback * describe_insight * describe_organization_health * describe_organization_overview * describe_organization_resource_collection_health * describe_resource_collection_health * describe_service_integration * get_cost_estimation * get_paginator * get_resource_collection * get_waiter * list_anomalies_for_insight * list_anomalous_log_groups * list_events * list_insights * list_monitored_resources * list_notification_channels * list_organization_insights * list_recommendations * put_feedback * remove_notification_channel * search_insights * search_organization_insights * start_cost_estimation * update_event_sources_config * update_resource_collection * update_service_integration Paginators ========== Paginators are available on a client instance via the "get_paginator" method. For more detailed instructions and examples on the usage of paginators, see the paginators user guide. The available paginators are: * DescribeOrganizationResourceCollectionHealth * DescribeResourceCollectionHealth * GetCostEstimation * GetResourceCollection * ListAnomaliesForInsight * ListAnomalousLogGroups * ListEvents * ListInsights * ListMonitoredResources * ListNotificationChannels * ListOrganizationInsights * ListRecommendations * SearchInsights * SearchOrganizationInsights DevOpsGuru / Paginator / SearchOrganizationInsights SearchOrganizationInsights ************************** class DevOpsGuru.Paginator.SearchOrganizationInsights paginator = client.get_paginator('search_organization_insights') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.search_organization_insights()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( AccountIds=[ 'string', ], StartTimeRange={ 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, Filters={ 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'Statuses': [ 'ONGOING'|'CLOSED', ], 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, Type='REACTIVE'|'PROACTIVE', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **AccountIds** (*list*) -- **[REQUIRED]** The ID of the Amazon Web Services account. * *(string) --* * **StartTimeRange** (*dict*) -- **[REQUIRED]** A time range used to specify when the behavior of an insight or anomaly started. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **Filters** (*dict*) -- A "SearchOrganizationInsightsFilters" object that is used to set the severity and status filters on your insight search. * **Severities** *(list) --* An array of severity values used to search for insights. * *(string) --* * **Statuses** *(list) --* An array of status values used to search for insights. * *(string) --* * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru- rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **Type** (*string*) -- **[REQUIRED]** The type of insights you are searching for ( "REACTIVE" or "PROACTIVE"). * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'ReactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight." * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **ReactiveInsights** *(list) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight." * **Id** *(string) --* The ID of a reactive summary. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* DevOpsGuru / Paginator / ListOrganizationInsights ListOrganizationInsights ************************ class DevOpsGuru.Paginator.ListOrganizationInsights paginator = client.get_paginator('list_organization_insights') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_organization_insights()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( StatusFilter={ 'Ongoing': { 'Type': 'REACTIVE'|'PROACTIVE' }, 'Closed': { 'Type': 'REACTIVE'|'PROACTIVE', 'EndTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } }, 'Any': { 'Type': 'REACTIVE'|'PROACTIVE', 'StartTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } } }, AccountIds=[ 'string', ], OrganizationalUnitIds=[ 'string', ], PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **StatusFilter** (*dict*) -- **[REQUIRED]** A filter used by "ListInsights" to specify which insights to return. * **Ongoing** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies ongoing insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **Closed** *(dict) --* A "ListInsightsClosedStatusFilter" that specifies closed insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **EndTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights ended. * **FromTime** *(datetime) --* The earliest end time in the time range. * **ToTime** *(datetime) --* The latest end time in the time range. * **Any** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies insights of any status that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **StartTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights started. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **AccountIds** (*list*) -- The ID of the Amazon Web Services account. * *(string) --* * **OrganizationalUnitIds** (*list*) -- The ID of the organizational unit. * *(string) --* * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { 'Id': 'string', 'AccountId': 'string', 'OrganizationalUnitId': '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, ], 'ReactiveInsights': [ { 'Id': 'string', 'AccountId': 'string', 'OrganizationalUnitId': '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, ], } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight". * **Id** *(string) --* The ID of the insight summary. * **AccountId** *(string) --* The ID of the Amazon Web Services account. * **OrganizationalUnitId** *(string) --* The ID of the organizational unit. * **Name** *(string) --* The name of the insight summary. * **Severity** *(string) --* An array of severity values used to search for insights. For more information, see Understanding insight severities in the *Amazon DevOps Guru User Guide*. * **Status** *(string) --* An array of status values used to search for insights. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **ReactiveInsights** *(list) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight". * **Id** *(string) --* The ID of the insight summary. * **AccountId** *(string) --* The ID of the Amazon Web Services account. * **OrganizationalUnitId** *(string) --* The ID of the organizational unit. * **Name** *(string) --* The name of the insight summary. * **Severity** *(string) --* An array of severity values used to search for insights. For more information, see Understanding insight severities in the *Amazon DevOps Guru User Guide*. * **Status** *(string) --* An array of status values used to search for insights. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* DevOpsGuru / Paginator / ListMonitoredResources ListMonitoredResources ********************** class DevOpsGuru.Paginator.ListMonitoredResources paginator = client.get_paginator('list_monitored_resources') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_monitored_resources()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( Filters={ 'ResourcePermission': 'FULL_PERMISSION'|'MISSING_PERMISSION', 'ResourceTypeFilters': [ 'LOG_GROUPS'|'CLOUDFRONT_DISTRIBUTION'|'DYNAMODB_TABLE'|'EC2_NAT_GATEWAY'|'ECS_CLUSTER'|'ECS_SERVICE'|'EKS_CLUSTER'|'ELASTIC_BEANSTALK_ENVIRONMENT'|'ELASTIC_LOAD_BALANCER_LOAD_BALANCER'|'ELASTIC_LOAD_BALANCING_V2_LOAD_BALANCER'|'ELASTIC_LOAD_BALANCING_V2_TARGET_GROUP'|'ELASTICACHE_CACHE_CLUSTER'|'ELASTICSEARCH_DOMAIN'|'KINESIS_STREAM'|'LAMBDA_FUNCTION'|'OPEN_SEARCH_SERVICE_DOMAIN'|'RDS_DB_INSTANCE'|'RDS_DB_CLUSTER'|'REDSHIFT_CLUSTER'|'ROUTE53_HOSTED_ZONE'|'ROUTE53_HEALTH_CHECK'|'S3_BUCKET'|'SAGEMAKER_ENDPOINT'|'SNS_TOPIC'|'SQS_QUEUE'|'STEP_FUNCTIONS_ACTIVITY'|'STEP_FUNCTIONS_STATE_MACHINE', ] }, PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **Filters** (*dict*) -- Filters to determine which monitored resources you want to retrieve. You can filter by resource type or resource permission status. * **ResourcePermission** *(string) --* **[REQUIRED]** The permission status of a resource. * **ResourceTypeFilters** *(list) --* **[REQUIRED]** The type of resource that you wish to retrieve, such as log groups. * *(string) --* * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'MonitoredResourceIdentifiers': [ { 'MonitoredResourceName': 'string', 'Type': 'string', 'ResourcePermission': 'FULL_PERMISSION'|'MISSING_PERMISSION', 'LastUpdated': datetime(2015, 1, 1), 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] } }, ], } **Response Structure** * *(dict) --* * **MonitoredResourceIdentifiers** *(list) --* Information about the resource that is being monitored, including the name of the resource, the type of resource, and whether or not permission is given to DevOps Guru to access that resource. * *(dict) --* Information about the resource that is being monitored, including the name of the resource, the type of resource, and whether or not permission is given to DevOps Guru to access that resource. * **MonitoredResourceName** *(string) --* The name of the resource being monitored. * **Type** *(string) --* The type of resource being monitored. * **ResourcePermission** *(string) --* The permission status of a resource. * **LastUpdated** *(datetime) --* The time at which DevOps Guru last updated this resource. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* DevOpsGuru / Paginator / ListRecommendations ListRecommendations ******************* class DevOpsGuru.Paginator.ListRecommendations paginator = client.get_paginator('list_recommendations') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_recommendations()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( InsightId='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', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **InsightId** (*string*) -- **[REQUIRED]** The ID of the requested insight. * **Locale** (*string*) -- A locale that specifies the language to use for recommendations. * **AccountId** (*string*) -- The ID of the Amazon Web Services account. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **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' }, ], } **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 "RecommendationRelatedClo udWatchMetricsSourceDetail" 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. DevOpsGuru / Paginator / ListAnomaliesForInsight ListAnomaliesForInsight *********************** class DevOpsGuru.Paginator.ListAnomaliesForInsight paginator = client.get_paginator('list_anomalies_for_insight') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_anomalies_for_insight()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( InsightId='string', StartTimeRange={ 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, AccountId='string', Filters={ 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **InsightId** (*string*) -- **[REQUIRED]** The ID of the insight. The returned anomalies belong to this insight. * **StartTimeRange** (*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. * **AccountId** (*string*) -- The ID of the Amazon Web Services account. * **Filters** (*dict*) -- Specifies one or more service names that are used to list anomalies. * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **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' }, ], 'Description': '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' }, ] }, ], } **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 an 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 >>``<>``<<. * **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 >>``<>``<<. * *(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 >>``<>``<<. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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 of the source which detects proactive anomalies. * **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. * **Description** *(string) --* A description of the proactive anomaly. * **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 an 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 >>``<>``<<. * **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 >>``<>``<<. * *(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 >>``<>``<<. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. DevOpsGuru / Paginator / ListEvents ListEvents ********** class DevOpsGuru.Paginator.ListEvents paginator = client.get_paginator('list_events') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_events()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( Filters={ 'InsightId': 'string', 'EventTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, 'EventClass': 'INFRASTRUCTURE'|'DEPLOYMENT'|'SECURITY_CHANGE'|'CONFIG_CHANGE'|'SCHEMA_CHANGE', 'EventSource': 'string', 'DataSource': 'AWS_CLOUD_TRAIL'|'AWS_CODE_DEPLOY', 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] } }, AccountId='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **Filters** (*dict*) -- **[REQUIRED]** A "ListEventsFilters" object used to specify which events to return. * **InsightId** *(string) --* An ID of an insight that is related to the events you want to filter for. * **EventTimeRange** *(dict) --* A time range during which you want the filtered events to have occurred. * **FromTime** *(datetime) --* **[REQUIRED]** The time when the event started. * **ToTime** *(datetime) --* **[REQUIRED]** The time when the event ended. * **EventClass** *(string) --* The class of the events you want to filter for, such as an infrastructure change, a deployment, or a schema change. * **EventSource** *(string) --* The Amazon Web Services source that emitted the events you want to filter for. * **DataSource** *(string) --* The source, "AWS_CLOUD_TRAIL" or "AWS_CODE_DEPLOY", of the events you want returned. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru- rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **AccountId** (*string*) -- The ID of the Amazon Web Services account. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'Events': [ { 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'Id': 'string', 'Time': datetime(2015, 1, 1), 'EventSource': 'string', 'Name': 'string', 'DataSource': 'AWS_CLOUD_TRAIL'|'AWS_CODE_DEPLOY', 'EventClass': 'INFRASTRUCTURE'|'DEPLOYMENT'|'SECURITY_CHANGE'|'CONFIG_CHANGE'|'SCHEMA_CHANGE', 'Resources': [ { 'Type': 'string', 'Name': 'string', 'Arn': 'string' }, ] }, ], } **Response Structure** * *(dict) --* * **Events** *(list) --* A list of the requested events. * *(dict) --* An Amazon Web Services resource event. Amazon Web Services resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **Id** *(string) --* The ID of the event. * **Time** *(datetime) --* A "Timestamp" that specifies the time the event occurred. * **EventSource** *(string) --* The Amazon Web Services source that emitted the event. * **Name** *(string) --* The name of the event. * **DataSource** *(string) --* The source, "AWS_CLOUD_TRAIL" or "AWS_CODE_DEPLOY", where DevOps Guru analysis found the event. * **EventClass** *(string) --* The class of the event. The class specifies what the event is related to, such as an infrastructure change, a deployment, or a schema change. * **Resources** *(list) --* An "EventResource" object that contains information about the resource that emitted the event. * *(dict) --* The Amazon Web Services resource that emitted an event. Amazon Web Services resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions. * **Type** *(string) --* The type of resource that emitted an event. * **Name** *(string) --* The name of the resource that emitted an event. * **Arn** *(string) --* The Amazon Resource Name (ARN) of the resource that emitted an event. DevOpsGuru / Paginator / ListAnomalousLogGroups ListAnomalousLogGroups ********************** class DevOpsGuru.Paginator.ListAnomalousLogGroups paginator = client.get_paginator('list_anomalous_log_groups') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_anomalous_log_groups()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( InsightId='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **InsightId** (*string*) -- **[REQUIRED]** The ID of the insight containing the log groups. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'InsightId': 'string', 'AnomalousLogGroups': [ { 'LogGroupName': 'string', 'ImpactStartTime': datetime(2015, 1, 1), 'ImpactEndTime': datetime(2015, 1, 1), 'NumberOfLogLinesScanned': 123, 'LogAnomalyShowcases': [ { 'LogAnomalyClasses': [ { 'LogStreamName': 'string', 'LogAnomalyType': 'KEYWORD'|'KEYWORD_TOKEN'|'FORMAT'|'HTTP_CODE'|'BLOCK_FORMAT'|'NUMERICAL_POINT'|'NUMERICAL_NAN'|'NEW_FIELD_NAME', 'LogAnomalyToken': 'string', 'LogEventId': 'string', 'Explanation': 'string', 'NumberOfLogLinesOccurrences': 123, 'LogEventTimestamp': datetime(2015, 1, 1) }, ] }, ] }, ], } **Response Structure** * *(dict) --* * **InsightId** *(string) --* The ID of the insight containing the log groups. * **AnomalousLogGroups** *(list) --* The list of Amazon CloudWatch log groups that are related to an insight. * *(dict) --* An Amazon CloudWatch log group that contains log anomalies and is used to generate an insight. * **LogGroupName** *(string) --* The name of the CloudWatch log group. * **ImpactStartTime** *(datetime) --* The time the anomalous log events began. The impact start time indicates the time of the first log anomaly event that occurs. * **ImpactEndTime** *(datetime) --* The time the anomalous log events stopped. * **NumberOfLogLinesScanned** *(integer) --* The number of log lines that were scanned for anomalous log events. * **LogAnomalyShowcases** *(list) --* The log anomalies in the log group. Each log anomaly displayed represents a cluster of similar anomalous log events. * *(dict) --* A cluster of similar anomalous log events found within a log group. * **LogAnomalyClasses** *(list) --* A list of anomalous log events that may be related. * *(dict) --* Information about an anomalous log event found within a log group. * **LogStreamName** *(string) --* The name of the Amazon CloudWatch log stream that the anomalous log event belongs to. A log stream is a sequence of log events that share the same source. * **LogAnomalyType** *(string) --* The type of log anomaly that has been detected. * **LogAnomalyToken** *(string) --* The token where the anomaly was detected. This may refer to an exception or another location, or it may be blank for log anomalies such as format anomalies. * **LogEventId** *(string) --* The ID of the log event. * **Explanation** *(string) --* The explanation for why the log event is considered an anomaly. * **NumberOfLogLinesOccurrences** *(integer) --* The number of log lines where this anomalous log event occurs. * **LogEventTimestamp** *(datetime) --* The time of the first occurrence of the anomalous log event. DevOpsGuru / Paginator / ListInsights ListInsights ************ class DevOpsGuru.Paginator.ListInsights paginator = client.get_paginator('list_insights') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_insights()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( StatusFilter={ 'Ongoing': { 'Type': 'REACTIVE'|'PROACTIVE' }, 'Closed': { 'Type': 'REACTIVE'|'PROACTIVE', 'EndTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } }, 'Any': { 'Type': 'REACTIVE'|'PROACTIVE', 'StartTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } } }, PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **StatusFilter** (*dict*) -- **[REQUIRED]** A filter used to filter the returned insights by their status. You can specify one status filter. * **Ongoing** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies ongoing insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **Closed** *(dict) --* A "ListInsightsClosedStatusFilter" that specifies closed insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **EndTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights ended. * **FromTime** *(datetime) --* The earliest end time in the time range. * **ToTime** *(datetime) --* The latest end time in the time range. * **Any** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies insights of any status that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **StartTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights started. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'ReactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* The returned list of proactive insights. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight." * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **ReactiveInsights** *(list) --* The returned list of reactive insights. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight." * **Id** *(string) --* The ID of a reactive summary. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* DevOpsGuru / Paginator / DescribeOrganizationResourceCollectionHealth DescribeOrganizationResourceCollectionHealth ******************************************** class DevOpsGuru.Paginator.DescribeOrganizationResourceCollectionHealth paginator = client.get_paginator('describe_organization_resource_collection_health') paginate(**kwargs) Creates an iterator that will paginate through responses from " DevOpsGuru.Client.describe_organization_resource_collection_hea lth()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( OrganizationResourceCollectionType='AWS_CLOUD_FORMATION'|'AWS_SERVICE'|'AWS_ACCOUNT'|'AWS_TAGS', AccountIds=[ 'string', ], OrganizationalUnitIds=[ 'string', ], MaxResults=123, PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **OrganizationResourceCollectionType** (*string*) -- **[REQUIRED]** An Amazon Web Services resource collection type. This type specifies how analyzed Amazon Web Services resources are defined. 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. * **AccountIds** (*list*) -- The ID of the Amazon Web Services account. * *(string) --* * **OrganizationalUnitIds** (*list*) -- The ID of the organizational unit. * *(string) --* * **MaxResults** (*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. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'CloudFormation': [ { 'StackName': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Service': [ { 'ServiceName': 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Account': [ { 'AccountId': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123 } }, ], 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValue': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ] } **Response Structure** * *(dict) --* * **CloudFormation** *(list) --* The returned "CloudFormationHealthOverview" object that contains an "InsightHealthOverview" object with the requested system health information. * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack. * **StackName** *(string) --* The name of the CloudFormation stack. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services CloudFormation stack. * **Service** *(list) --* An array of "ServiceHealth" objects that describes the health of the Amazon Web Services services associated with the resources in the collection. * *(dict) --* Represents the health of an Amazon Web Services service. * **ServiceName** *(string) --* The name of the Amazon Web Services service. * **Insight** *(dict) --* Represents the health of an Amazon Web Services service. This is a "ServiceInsightHealth" that contains the number of open proactive and reactive insights for this service. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights in the Amazon Web Services service * **OpenReactiveInsights** *(integer) --* The number of open reactive insights in the Amazon Web Services service * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in an analyzed Amazon Web Services service. * **Account** *(list) --* The name of the organization's account. * *(dict) --* Returns the number of open reactive insights, the number of open proactive insights, and the number of metrics analyzed in your Amazon Web Services account. Use these numbers to gauge the health of operations in your Amazon Web Services account. * **AccountId** *(string) --* The ID of the Amazon Web Services account. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * **OpenReactiveInsights** *(integer) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * **Tags** *(list) --* 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services tag *key*. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **TagValue** *(string) --* The value in an Amazon Web Services tag. 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. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services tag, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services tag. DevOpsGuru / Paginator / GetResourceCollection GetResourceCollection ********************* class DevOpsGuru.Paginator.GetResourceCollection paginator = client.get_paginator('get_resource_collection') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.get_resource_collection()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( ResourceCollectionType='AWS_CLOUD_FORMATION'|'AWS_SERVICE'|'AWS_TAGS', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **ResourceCollectionType** (*string*) -- **[REQUIRED]** The type of Amazon Web Services resource collections to return. The one valid value is "CLOUD_FORMATION" for Amazon Web Services CloudFormation stacks. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, } **Response Structure** * *(dict) --* * **ResourceCollection** *(dict) --* The requested list of Amazon Web Services resource collections. 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) --* Information about Amazon Web Services CloudFormation stacks. You can use up to 500 stacks to specify which Amazon Web Services resources in your account to analyze. For more information, see Stacks in the *Amazon Web Services CloudFormation User Guide*. * **StackNames** *(list) --* An array of CloudFormation stack names. * *(string) --* * **Tags** *(list) --* The Amazon Web Services tags used to filter the 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru- rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags used to filter insights. This is used to return insights generated from only resources that contain the tags in the tag collection. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * **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) --* DevOpsGuru / Paginator / SearchInsights SearchInsights ************** class DevOpsGuru.Paginator.SearchInsights paginator = client.get_paginator('search_insights') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.search_insights()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( StartTimeRange={ 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, Filters={ 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'Statuses': [ 'ONGOING'|'CLOSED', ], 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, Type='REACTIVE'|'PROACTIVE', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **StartTimeRange** (*dict*) -- **[REQUIRED]** The start of the time range passed in. Returned insights occurred after this time. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **Filters** (*dict*) -- A "SearchInsightsFilters" object that is used to set the severity and status filters on your insight search. * **Severities** *(list) --* An array of severity values used to search for insights. * *(string) --* * **Statuses** *(list) --* An array of status values used to search for insights. * *(string) --* * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru- rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **Type** (*string*) -- **[REQUIRED]** The type of insights you are searching for ( "REACTIVE" or "PROACTIVE"). * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'ReactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* The returned proactive insights. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight." * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **ReactiveInsights** *(list) --* The returned reactive insights. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight." * **Id** *(string) --* The ID of a reactive summary. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps- Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment- application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru- RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* DevOpsGuru / Paginator / DescribeResourceCollectionHealth DescribeResourceCollectionHealth ******************************** class DevOpsGuru.Paginator.DescribeResourceCollectionHealth paginator = client.get_paginator('describe_resource_collection_health') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.describe_resource_collection_health()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( ResourceCollectionType='AWS_CLOUD_FORMATION'|'AWS_SERVICE'|'AWS_TAGS', PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: * **ResourceCollectionType** (*string*) -- **[REQUIRED]** An Amazon Web Services resource collection type. This type specifies how analyzed Amazon Web Services resources are defined. 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. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'CloudFormation': [ { 'StackName': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Service': [ { 'ServiceName': 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValue': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ] } **Response Structure** * *(dict) --* * **CloudFormation** *(list) --* The returned "CloudFormationHealthOverview" object that contains an "InsightHealthOverview" object with the requested system health information. * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack. * **StackName** *(string) --* The name of the CloudFormation stack. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services CloudFormation stack. * **Service** *(list) --* An array of "ServiceHealth" objects that describes the health of the Amazon Web Services services associated with the resources in the collection. * *(dict) --* Represents the health of an Amazon Web Services service. * **ServiceName** *(string) --* The name of the Amazon Web Services service. * **Insight** *(dict) --* Represents the health of an Amazon Web Services service. This is a "ServiceInsightHealth" that contains the number of open proactive and reactive insights for this service. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights in the Amazon Web Services service * **OpenReactiveInsights** *(integer) --* The number of open reactive insights in the Amazon Web Services service * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in an analyzed Amazon Web Services service. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services tag *key*. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **TagValue** *(string) --* The value in an Amazon Web Services tag. 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. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services tag, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services tag. DevOpsGuru / Paginator / ListNotificationChannels ListNotificationChannels ************************ class DevOpsGuru.Paginator.ListNotificationChannels paginator = client.get_paginator('list_notification_channels') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.list_notification_channels()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'Channels': [ { 'Id': 'string', 'Config': { 'Sns': { 'TopicArn': 'string' }, 'Filters': { 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'MessageTypes': [ 'NEW_INSIGHT'|'CLOSED_INSIGHT'|'NEW_ASSOCIATION'|'SEVERITY_UPGRADED'|'NEW_RECOMMENDATION', ] } } }, ], } **Response Structure** * *(dict) --* * **Channels** *(list) --* An array that contains the requested notification channels. * *(dict) --* Information about a notification channel. A notification channel is used to notify you when DevOps Guru creates an insight. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS). If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics. If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer- managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics. * **Id** *(string) --* The ID of a notification channel. * **Config** *(dict) --* A "NotificationChannelConfig" object that contains information about configured notification channels. * **Sns** *(dict) --* Information about a notification channel configured in DevOps Guru to send notifications when insights are created. If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics. If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics. * **TopicArn** *(string) --* The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic. * **Filters** *(dict) --* The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. If you do not provide filter configurations, the default configurations are to receive notifications for all message types of "High" or "Medium" severity. * **Severities** *(list) --* The severity levels that you want to receive notifications for. For example, you can choose to receive notifications only for insights with "HIGH" and "MEDIUM" severity levels. For more information, see Understanding insight severities. * *(string) --* * **MessageTypes** *(list) --* The events that you want to receive notifications for. For example, you can choose to receive notifications only when the severity level is upgraded or a new insight is created. * *(string) --* DevOpsGuru / Paginator / GetCostEstimation GetCostEstimation ***************** class DevOpsGuru.Paginator.GetCostEstimation paginator = client.get_paginator('get_cost_estimation') paginate(**kwargs) Creates an iterator that will paginate through responses from "DevOpsGuru.Client.get_cost_estimation()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'Status': 'ONGOING'|'COMPLETED', 'Costs': [ { 'Type': 'string', 'State': 'ACTIVE'|'INACTIVE', 'Count': 123, 'UnitCost': 123.0, 'Cost': 123.0 }, ], 'TimeRange': { 'StartTime': datetime(2015, 1, 1), 'EndTime': datetime(2015, 1, 1) }, 'TotalCost': 123.0, } **Response Structure** * *(dict) --* * **ResourceCollection** *(dict) --* The collection of the Amazon Web Services resources used to create your monthly DevOps Guru cost estimate. * **CloudFormation** *(dict) --* An object that specifies the CloudFormation stack that defines the Amazon Web Services resources used to create a monthly estimate for DevOps Guru. * **StackNames** *(list) --* An array of CloudFormation stack names. Its size is fixed at 1 item. * *(string) --* * **Tags** *(list) --* The Amazon Web Services tags used to filter the resource collection that is used for a cost estimate. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru- rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* Information about a collection of Amazon Web Services resources that are identified by an Amazon Web Services tag. This collection of resources is used to create a monthly cost estimate for DevOps Guru to analyze Amazon Web Services resources. The maximum number of tags you can specify for a cost estimate is one. The estimate created is for the cost to analyze the Amazon Web Services resources defined by the tag. For more information, see Stacks in the *Amazon Web Services CloudFormation User Guide*. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru- production-application/containers". * **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) --* * **Status** *(string) --* The status of creating this cost estimate. If it's still in progress, the status "ONGOING" is returned. If it is finished, the status "COMPLETED" is returned. * **Costs** *(list) --* An array of "ResourceCost" objects that each contains details about the monthly cost estimate to analyze one of your Amazon Web Services resources. * *(dict) --* An object that contains information about the estimated monthly cost to analyze an Amazon Web Services resource. For more information, see Estimate your Amazon DevOps Guru costs and Amazon DevOps Guru pricing. * **Type** *(string) --* The type of the Amazon Web Services resource. * **State** *(string) --* The state of the resource. The resource is "ACTIVE" if it produces metrics, events, or logs within an hour, otherwise it is "INACTIVE". You pay for the number of active Amazon Web Services resource hours analyzed for each resource. Inactive resources are not charged. * **Count** *(integer) --* The number of active resources analyzed for this service to create a monthly cost estimate. * **UnitCost** *(float) --* The price per hour to analyze the resources in the service. For more information, see Estimate your Amazon DevOps Guru costs and Amazon DevOps Guru pricing. * **Cost** *(float) --* The total estimated monthly cost to analyze the active resources for this resource. * **TimeRange** *(dict) --* The start and end time of the cost estimation. * **StartTime** *(datetime) --* The start time of the cost estimation. * **EndTime** *(datetime) --* The end time of the cost estimation. * **TotalCost** *(float) --* The estimated monthly cost to analyze the Amazon Web Services resources. This value is the sum of the estimated costs to analyze each resource in the "Costs" object in this response. DevOpsGuru / Client / list_events list_events *********** DevOpsGuru.Client.list_events(**kwargs) Returns a list of the events emitted by the resources that are evaluated by DevOps Guru. You can use filters to specify which events are returned. See also: AWS API Documentation **Request Syntax** response = client.list_events( Filters={ 'InsightId': 'string', 'EventTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, 'EventClass': 'INFRASTRUCTURE'|'DEPLOYMENT'|'SECURITY_CHANGE'|'CONFIG_CHANGE'|'SCHEMA_CHANGE', 'EventSource': 'string', 'DataSource': 'AWS_CLOUD_TRAIL'|'AWS_CODE_DEPLOY', 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] } }, MaxResults=123, NextToken='string', AccountId='string' ) Parameters: * **Filters** (*dict*) -- **[REQUIRED]** A "ListEventsFilters" object used to specify which events to return. * **InsightId** *(string) --* An ID of an insight that is related to the events you want to filter for. * **EventTimeRange** *(dict) --* A time range during which you want the filtered events to have occurred. * **FromTime** *(datetime) --* **[REQUIRED]** The time when the event started. * **ToTime** *(datetime) --* **[REQUIRED]** The time when the event ended. * **EventClass** *(string) --* The class of the events you want to filter for, such as an infrastructure change, a deployment, or a schema change. * **EventSource** *(string) --* The Amazon Web Services source that emitted the events you want to filter for. * **DataSource** *(string) --* The source, "AWS_CLOUD_TRAIL" or "AWS_CODE_DEPLOY", of the events you want returned. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **MaxResults** (*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. * **NextToken** (*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. * **AccountId** (*string*) -- The ID of the Amazon Web Services account. Return type: dict Returns: **Response Syntax** { 'Events': [ { 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'Id': 'string', 'Time': datetime(2015, 1, 1), 'EventSource': 'string', 'Name': 'string', 'DataSource': 'AWS_CLOUD_TRAIL'|'AWS_CODE_DEPLOY', 'EventClass': 'INFRASTRUCTURE'|'DEPLOYMENT'|'SECURITY_CHANGE'|'CONFIG_CHANGE'|'SCHEMA_CHANGE', 'Resources': [ { 'Type': 'string', 'Name': 'string', 'Arn': 'string' }, ] }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **Events** *(list) --* A list of the requested events. * *(dict) --* An Amazon Web Services resource event. Amazon Web Services resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **Id** *(string) --* The ID of the event. * **Time** *(datetime) --* A "Timestamp" that specifies the time the event occurred. * **EventSource** *(string) --* The Amazon Web Services source that emitted the event. * **Name** *(string) --* The name of the event. * **DataSource** *(string) --* The source, "AWS_CLOUD_TRAIL" or "AWS_CODE_DEPLOY", where DevOps Guru analysis found the event. * **EventClass** *(string) --* The class of the event. The class specifies what the event is related to, such as an infrastructure change, a deployment, or a schema change. * **Resources** *(list) --* An "EventResource" object that contains information about the resource that emitted the event. * *(dict) --* The Amazon Web Services resource that emitted an event. Amazon Web Services resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions. * **Type** *(string) --* The type of resource that emitted an event. * **Name** *(string) --* The name of the resource that emitted an event. * **Arn** *(string) --* The Amazon Resource Name (ARN) of the resource that emitted an event. * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / start_cost_estimation start_cost_estimation ********************* DevOpsGuru.Client.start_cost_estimation(**kwargs) Starts the creation of an estimate of the monthly cost to analyze your Amazon Web Services resources. See also: AWS API Documentation **Request Syntax** response = client.start_cost_estimation( ResourceCollection={ 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, ClientToken='string' ) Parameters: * **ResourceCollection** (*dict*) -- **[REQUIRED]** The collection of Amazon Web Services resources used to create a monthly DevOps Guru cost estimate. * **CloudFormation** *(dict) --* An object that specifies the CloudFormation stack that defines the Amazon Web Services resources used to create a monthly estimate for DevOps Guru. * **StackNames** *(list) --* An array of CloudFormation stack names. Its size is fixed at 1 item. * *(string) --* * **Tags** *(list) --* The Amazon Web Services tags used to filter the resource collection that is used for a cost estimate. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * *(dict) --* Information about a collection of Amazon Web Services resources that are identified by an Amazon Web Services tag. This collection of resources is used to create a monthly cost estimate for DevOps Guru to analyze Amazon Web Services resources. The maximum number of tags you can specify for a cost estimate is one. The estimate created is for the cost to analyze the Amazon Web Services resources defined by the tag. For more information, see Stacks in the *Amazon Web Services CloudFormation User Guide*. * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **ClientToken** (*string*) -- The idempotency token used to identify each cost estimate request. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / search_organization_insights search_organization_insights **************************** DevOpsGuru.Client.search_organization_insights(**kwargs) Returns a list of insights in your organization. You can specify which insights are returned by their start time, one or more statuses ( "ONGOING", "CLOSED", and "CLOSED"), one or more severities ( "LOW", "MEDIUM", and "HIGH"), and type ( "REACTIVE" or "PROACTIVE"). Use the "Filters" parameter to specify status and severity search parameters. Use the "Type" parameter to specify "REACTIVE" or "PROACTIVE" in your search. See also: AWS API Documentation **Request Syntax** response = client.search_organization_insights( AccountIds=[ 'string', ], StartTimeRange={ 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, Filters={ 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'Statuses': [ 'ONGOING'|'CLOSED', ], 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, MaxResults=123, NextToken='string', Type='REACTIVE'|'PROACTIVE' ) Parameters: * **AccountIds** (*list*) -- **[REQUIRED]** The ID of the Amazon Web Services account. * *(string) --* * **StartTimeRange** (*dict*) -- **[REQUIRED]** A time range used to specify when the behavior of an insight or anomaly started. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **Filters** (*dict*) -- A "SearchOrganizationInsightsFilters" object that is used to set the severity and status filters on your insight search. * **Severities** *(list) --* An array of severity values used to search for insights. * *(string) --* * **Statuses** *(list) --* An array of status values used to search for insights. * *(string) --* * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **MaxResults** (*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. * **NextToken** (*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. * **Type** (*string*) -- **[REQUIRED]** The type of insights you are searching for ( "REACTIVE" or "PROACTIVE"). Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'ReactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight." * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **ReactiveInsights** *(list) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight." * **Id** *(string) --* The ID of a reactive summary. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / get_paginator get_paginator ************* DevOpsGuru.Client.get_paginator(operation_name) Create a paginator for an operation. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Raises: **OperationNotPageableError** -- Raised if the operation is not pageable. You can use the "client.can_paginate" method to check if an operation is pageable. Return type: "botocore.paginate.Paginator" Returns: A paginator object. DevOpsGuru / Client / put_feedback put_feedback ************ DevOpsGuru.Client.put_feedback(**kwargs) Collects customer feedback about the specified insight. See also: AWS API Documentation **Request Syntax** response = client.put_feedback( InsightFeedback={ 'Id': 'string', 'Feedback': 'VALID_COLLECTION'|'RECOMMENDATION_USEFUL'|'ALERT_TOO_SENSITIVE'|'DATA_NOISY_ANOMALY'|'DATA_INCORRECT' } ) Parameters: **InsightFeedback** (*dict*) -- The feedback from customers is about the recommendations in this insight. * **Id** *(string) --* The insight feedback ID. * **Feedback** *(string) --* The feedback provided by the customer. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_service_integration describe_service_integration **************************** DevOpsGuru.Client.describe_service_integration() Returns the integration status of services that are integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon Web Services Systems Manager, which can be used to create an OpsItem for each generated insight. See also: AWS API Documentation **Request Syntax** response = client.describe_service_integration() Return type: dict Returns: **Response Syntax** { 'ServiceIntegration': { 'OpsCenter': { 'OptInStatus': 'ENABLED'|'DISABLED' }, 'LogsAnomalyDetection': { 'OptInStatus': 'ENABLED'|'DISABLED' }, 'KMSServerSideEncryption': { 'KMSKeyId': 'string', 'OptInStatus': 'ENABLED'|'DISABLED', 'Type': 'CUSTOMER_MANAGED_KEY'|'AWS_OWNED_KMS_KEY' } } } **Response Structure** * *(dict) --* * **ServiceIntegration** *(dict) --* Information about the integration of DevOps Guru with another Amazon Web Services service, such as Amazon Web Services Systems Manager. * **OpsCenter** *(dict) --* Information about whether DevOps Guru is configured to create an OpsItem in Amazon Web Services Systems Manager OpsCenter for each created insight. * **OptInStatus** *(string) --* Specifies if DevOps Guru is enabled to create an Amazon Web Services Systems Manager OpsItem for each created insight. * **LogsAnomalyDetection** *(dict) --* Information about whether DevOps Guru is configured to perform log anomaly detection on Amazon CloudWatch log groups. * **OptInStatus** *(string) --* Specifies if DevOps Guru is configured to perform log anomaly detection on CloudWatch log groups. * **KMSServerSideEncryption** *(dict) --* Information about whether DevOps Guru is configured to encrypt server-side data using KMS. * **KMSKeyId** *(string) --* Describes the specified KMS key. To specify a KMS key, use its key ID, key ARN, alias name, or alias ARN. When using an alias name, prefix it with "alias/". If you specify a predefined Amazon Web Services alias (an Amazon Web Services alias with no key ID), Amazon Web Services KMS associates the alias with an Amazon Web Services managed key and returns its KeyId and Arn in the response. To specify a KMS key in a different Amazon Web Services account, you must use the key ARN or alias ARN. For example: Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab Key ARN: arn:aws:kms:us-east-2:111122223333:key /1234abcd-12ab-34cd-56ef-1234567890ab Alias name: alias/ExampleAlias Alias ARN: arn:aws:kms:us- east-2:111122223333:alias/ExampleAlias * **OptInStatus** *(string) --* Specifies if DevOps Guru is enabled for customer managed keys. * **Type** *(string) --* The type of KMS key used. Customer managed keys are the KMS keys that you create. Amazon Web Services owned keys are keys that are owned and managed by DevOps Guru. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_organization_health describe_organization_health **************************** DevOpsGuru.Client.describe_organization_health(**kwargs) Returns active insights, predictive insights, and resource hours analyzed in last hour. See also: AWS API Documentation **Request Syntax** response = client.describe_organization_health( AccountIds=[ 'string', ], OrganizationalUnitIds=[ 'string', ] ) Parameters: * **AccountIds** (*list*) -- The ID of the Amazon Web Services account. * *(string) --* * **OrganizationalUnitIds** (*list*) -- The ID of the organizational unit. * *(string) --* Return type: dict Returns: **Response Syntax** { 'OpenReactiveInsights': 123, 'OpenProactiveInsights': 123, 'MetricsAnalyzed': 123, 'ResourceHours': 123 } **Response Structure** * *(dict) --* * **OpenReactiveInsights** *(integer) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * **OpenProactiveInsights** *(integer) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * **MetricsAnalyzed** *(integer) --* An integer that specifies the number of metrics that have been analyzed in your organization. * **ResourceHours** *(integer) --* The number of Amazon DevOps Guru resource analysis hours billed to the current Amazon Web Services account in the last hour. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / can_paginate can_paginate ************ DevOpsGuru.Client.can_paginate(operation_name) Check if an operation can be paginated. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Returns: "True" if the operation can be paginated, "False" otherwise. DevOpsGuru / Client / describe_organization_overview describe_organization_overview ****************************** DevOpsGuru.Client.describe_organization_overview(**kwargs) Returns an overview of your organization's history based on the specified time range. The overview includes the total reactive and proactive insights. See also: AWS API Documentation **Request Syntax** response = client.describe_organization_overview( FromTime=datetime(2015, 1, 1), ToTime=datetime(2015, 1, 1), AccountIds=[ 'string', ], OrganizationalUnitIds=[ 'string', ] ) Parameters: * **FromTime** (*datetime*) -- **[REQUIRED]** The start of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred after this day. * **ToTime** (*datetime*) -- The end of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred before this day. If this is not specified, then the current day is used. * **AccountIds** (*list*) -- The ID of the Amazon Web Services account. * *(string) --* * **OrganizationalUnitIds** (*list*) -- The ID of the organizational unit. * *(string) --* Return type: dict Returns: **Response Syntax** { 'ReactiveInsights': 123, 'ProactiveInsights': 123 } **Response Structure** * *(dict) --* * **ReactiveInsights** *(integer) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * **ProactiveInsights** *(integer) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_monitored_resources list_monitored_resources ************************ DevOpsGuru.Client.list_monitored_resources(**kwargs) Returns the list of all log groups that are being monitored and tagged by DevOps Guru. See also: AWS API Documentation **Request Syntax** response = client.list_monitored_resources( Filters={ 'ResourcePermission': 'FULL_PERMISSION'|'MISSING_PERMISSION', 'ResourceTypeFilters': [ 'LOG_GROUPS'|'CLOUDFRONT_DISTRIBUTION'|'DYNAMODB_TABLE'|'EC2_NAT_GATEWAY'|'ECS_CLUSTER'|'ECS_SERVICE'|'EKS_CLUSTER'|'ELASTIC_BEANSTALK_ENVIRONMENT'|'ELASTIC_LOAD_BALANCER_LOAD_BALANCER'|'ELASTIC_LOAD_BALANCING_V2_LOAD_BALANCER'|'ELASTIC_LOAD_BALANCING_V2_TARGET_GROUP'|'ELASTICACHE_CACHE_CLUSTER'|'ELASTICSEARCH_DOMAIN'|'KINESIS_STREAM'|'LAMBDA_FUNCTION'|'OPEN_SEARCH_SERVICE_DOMAIN'|'RDS_DB_INSTANCE'|'RDS_DB_CLUSTER'|'REDSHIFT_CLUSTER'|'ROUTE53_HOSTED_ZONE'|'ROUTE53_HEALTH_CHECK'|'S3_BUCKET'|'SAGEMAKER_ENDPOINT'|'SNS_TOPIC'|'SQS_QUEUE'|'STEP_FUNCTIONS_ACTIVITY'|'STEP_FUNCTIONS_STATE_MACHINE', ] }, MaxResults=123, NextToken='string' ) Parameters: * **Filters** (*dict*) -- Filters to determine which monitored resources you want to retrieve. You can filter by resource type or resource permission status. * **ResourcePermission** *(string) --* **[REQUIRED]** The permission status of a resource. * **ResourceTypeFilters** *(list) --* **[REQUIRED]** The type of resource that you wish to retrieve, such as log groups. * *(string) --* * **MaxResults** (*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. * **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'MonitoredResourceIdentifiers': [ { 'MonitoredResourceName': 'string', 'Type': 'string', 'ResourcePermission': 'FULL_PERMISSION'|'MISSING_PERMISSION', 'LastUpdated': datetime(2015, 1, 1), 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] } }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **MonitoredResourceIdentifiers** *(list) --* Information about the resource that is being monitored, including the name of the resource, the type of resource, and whether or not permission is given to DevOps Guru to access that resource. * *(dict) --* Information about the resource that is being monitored, including the name of the resource, the type of resource, and whether or not permission is given to DevOps Guru to access that resource. * **MonitoredResourceName** *(string) --* The name of the resource being monitored. * **Type** *(string) --* The type of resource being monitored. * **ResourcePermission** *(string) --* The permission status of a resource. * **LastUpdated** *(datetime) --* The time at which DevOps Guru last updated this resource. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / get_resource_collection get_resource_collection *********************** DevOpsGuru.Client.get_resource_collection(**kwargs) Returns lists Amazon Web Services resources that are of the specified resource collection type. 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. See also: AWS API Documentation **Request Syntax** response = client.get_resource_collection( ResourceCollectionType='AWS_CLOUD_FORMATION'|'AWS_SERVICE'|'AWS_TAGS', NextToken='string' ) Parameters: * **ResourceCollectionType** (*string*) -- **[REQUIRED]** The type of Amazon Web Services resource collections to return. The one valid value is "CLOUD_FORMATION" for Amazon Web Services CloudFormation stacks. * **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'NextToken': 'string' } **Response Structure** * *(dict) --* * **ResourceCollection** *(dict) --* The requested list of Amazon Web Services resource collections. 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) --* Information about Amazon Web Services CloudFormation stacks. You can use up to 500 stacks to specify which Amazon Web Services resources in your account to analyze. For more information, see Stacks in the *Amazon Web Services CloudFormation User Guide*. * **StackNames** *(list) --* An array of CloudFormation stack names. * *(string) --* * **Tags** *(list) --* The Amazon Web Services tags used to filter the 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags used to filter insights. This is used to return insights generated from only resources that contain the tags in the tag collection. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_account_health describe_account_health *********************** DevOpsGuru.Client.describe_account_health() Returns the number of open reactive insights, the number of open proactive insights, and the number of metrics analyzed in your Amazon Web Services account. Use these numbers to gauge the health of operations in your Amazon Web Services account. See also: AWS API Documentation **Request Syntax** response = client.describe_account_health() Return type: dict Returns: **Response Syntax** { 'OpenReactiveInsights': 123, 'OpenProactiveInsights': 123, 'MetricsAnalyzed': 123, 'ResourceHours': 123, 'AnalyzedResourceCount': 123 } **Response Structure** * *(dict) --* * **OpenReactiveInsights** *(integer) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * **OpenProactiveInsights** *(integer) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * **MetricsAnalyzed** *(integer) --* An integer that specifies the number of metrics that have been analyzed in your Amazon Web Services account. * **ResourceHours** *(integer) --* The number of Amazon DevOps Guru resource analysis hours billed to the current Amazon Web Services account in the last hour. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your Amazon Web Services account. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_anomalies_for_insight list_anomalies_for_insight ************************** DevOpsGuru.Client.list_anomalies_for_insight(**kwargs) Returns a list of the anomalies that belong to an insight that you specify using its ID. See also: AWS API Documentation **Request Syntax** response = client.list_anomalies_for_insight( InsightId='string', StartTimeRange={ 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, MaxResults=123, NextToken='string', AccountId='string', Filters={ 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } } ) Parameters: * **InsightId** (*string*) -- **[REQUIRED]** The ID of the insight. The returned anomalies belong to this insight. * **StartTimeRange** (*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. * **MaxResults** (*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. * **NextToken** (*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. * **AccountId** (*string*) -- The ID of the Amazon Web Services account. * **Filters** (*dict*) -- Specifies one or more service names that are used to list anomalies. * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* Return type: dict Returns: **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' }, ], 'Description': '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 an 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 >>``<>``<<. * **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 >>``<>``<<. * *(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 >>``<>``<<. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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 of the source which detects proactive anomalies. * **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. * **Description** *(string) --* A description of the proactive anomaly. * **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 an 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 >>``<>``<<. * **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 >>``<>``<<. * *(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 >>``<>``<<. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / get_waiter get_waiter ********** DevOpsGuru.Client.get_waiter(waiter_name) Returns an object that can wait for some condition. Parameters: **waiter_name** (*str*) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters. Returns: The specified waiter object. Return type: "botocore.waiter.Waiter" DevOpsGuru / Client / add_notification_channel add_notification_channel ************************ DevOpsGuru.Client.add_notification_channel(**kwargs) Adds a notification channel to DevOps Guru. A notification channel is used to notify you about important DevOps Guru events, such as when an insight is generated. If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics. If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics. See also: AWS API Documentation **Request Syntax** response = client.add_notification_channel( Config={ 'Sns': { 'TopicArn': 'string' }, 'Filters': { 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'MessageTypes': [ 'NEW_INSIGHT'|'CLOSED_INSIGHT'|'NEW_ASSOCIATION'|'SEVERITY_UPGRADED'|'NEW_RECOMMENDATION', ] } } ) Parameters: **Config** (*dict*) -- **[REQUIRED]** A "NotificationChannelConfig" object that specifies what type of notification channel to add. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS). * **Sns** *(dict) --* **[REQUIRED]** Information about a notification channel configured in DevOps Guru to send notifications when insights are created. If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics. If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics. * **TopicArn** *(string) --* The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic. * **Filters** *(dict) --* The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. If you do not provide filter configurations, the default configurations are to receive notifications for all message types of "High" or "Medium" severity. * **Severities** *(list) --* The severity levels that you want to receive notifications for. For example, you can choose to receive notifications only for insights with "HIGH" and "MEDIUM" severity levels. For more information, see Understanding insight severities. * *(string) --* * **MessageTypes** *(list) --* The events that you want to receive notifications for. For example, you can choose to receive notifications only when the severity level is upgraded or a new insight is created. * *(string) --* Return type: dict Returns: **Response Syntax** { 'Id': 'string' } **Response Structure** * *(dict) --* * **Id** *(string) --* The ID of the added notification channel. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ServiceQuotaExceededException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_account_overview describe_account_overview ************************* DevOpsGuru.Client.describe_account_overview(**kwargs) For the time range passed in, returns the number of open reactive insight that were created, the number of open proactive insights that were created, and the Mean Time to Recover (MTTR) for all closed reactive insights. See also: AWS API Documentation **Request Syntax** response = client.describe_account_overview( FromTime=datetime(2015, 1, 1), ToTime=datetime(2015, 1, 1) ) Parameters: * **FromTime** (*datetime*) -- **[REQUIRED]** The start of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred after this day. * **ToTime** (*datetime*) -- The end of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred before this day. If this is not specified, then the current day is used. Return type: dict Returns: **Response Syntax** { 'ReactiveInsights': 123, 'ProactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 } **Response Structure** * *(dict) --* * **ReactiveInsights** *(integer) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account that were created during the time range passed in. * **ProactiveInsights** *(integer) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account that were created during the time range passed in. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Mean Time to Recover (MTTR) for all closed insights that were created during the time range passed in. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / search_insights search_insights *************** DevOpsGuru.Client.search_insights(**kwargs) Returns a list of insights in your Amazon Web Services account. You can specify which insights are returned by their start time, one or more statuses ( "ONGOING" or "CLOSED"), one or more severities ( "LOW", "MEDIUM", and "HIGH"), and type ( "REACTIVE" or "PROACTIVE"). Use the "Filters" parameter to specify status and severity search parameters. Use the "Type" parameter to specify "REACTIVE" or "PROACTIVE" in your search. See also: AWS API Documentation **Request Syntax** response = client.search_insights( StartTimeRange={ 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) }, Filters={ 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'Statuses': [ 'ONGOING'|'CLOSED', ], 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, MaxResults=123, NextToken='string', Type='REACTIVE'|'PROACTIVE' ) Parameters: * **StartTimeRange** (*dict*) -- **[REQUIRED]** The start of the time range passed in. Returned insights occurred after this time. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **Filters** (*dict*) -- A "SearchInsightsFilters" object that is used to set the severity and status filters on your insight search. * **Severities** *(list) --* An array of severity values used to search for insights. * *(string) --* * **Statuses** *(list) --* An array of status values used to search for insights. * *(string) --* * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **MaxResults** (*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. * **NextToken** (*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. * **Type** (*string*) -- **[REQUIRED]** The type of insights you are searching for ( "REACTIVE" or "PROACTIVE"). Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'ReactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* The returned proactive insights. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight." * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **ReactiveInsights** *(list) --* The returned reactive insights. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight." * **Id** *(string) --* The ID of a reactive summary. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_insight describe_insight **************** DevOpsGuru.Client.describe_insight(**kwargs) Returns details about an insight that you specify using its ID. See also: AWS API Documentation **Request Syntax** response = client.describe_insight( Id='string', AccountId='string' ) Parameters: * **Id** (*string*) -- **[REQUIRED]** The ID of the insight. * **AccountId** (*string*) -- The ID of the member account in the organization. Return type: dict Returns: **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / get_cost_estimation get_cost_estimation ******************* DevOpsGuru.Client.get_cost_estimation(**kwargs) Returns an estimate of the monthly cost for DevOps Guru to analyze your Amazon Web Services resources. For more information, see Estimate your Amazon DevOps Guru costs and Amazon DevOps Guru pricing. See also: AWS API Documentation **Request Syntax** response = client.get_cost_estimation( NextToken='string' ) Parameters: **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'ResourceCollection': { 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] }, 'Status': 'ONGOING'|'COMPLETED', 'Costs': [ { 'Type': 'string', 'State': 'ACTIVE'|'INACTIVE', 'Count': 123, 'UnitCost': 123.0, 'Cost': 123.0 }, ], 'TimeRange': { 'StartTime': datetime(2015, 1, 1), 'EndTime': datetime(2015, 1, 1) }, 'TotalCost': 123.0, 'NextToken': 'string' } **Response Structure** * *(dict) --* * **ResourceCollection** *(dict) --* The collection of the Amazon Web Services resources used to create your monthly DevOps Guru cost estimate. * **CloudFormation** *(dict) --* An object that specifies the CloudFormation stack that defines the Amazon Web Services resources used to create a monthly estimate for DevOps Guru. * **StackNames** *(list) --* An array of CloudFormation stack names. Its size is fixed at 1 item. * *(string) --* * **Tags** *(list) --* The Amazon Web Services tags used to filter the resource collection that is used for a cost estimate. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru- production-application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* Information about a collection of Amazon Web Services resources that are identified by an Amazon Web Services tag. This collection of resources is used to create a monthly cost estimate for DevOps Guru to analyze Amazon Web Services resources. The maximum number of tags you can specify for a cost estimate is one. The estimate created is for the cost to analyze the Amazon Web Services resources defined by the tag. For more information, see Stacks in the *Amazon Web Services CloudFormation User Guide*. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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) --* * **Status** *(string) --* The status of creating this cost estimate. If it's still in progress, the status "ONGOING" is returned. If it is finished, the status "COMPLETED" is returned. * **Costs** *(list) --* An array of "ResourceCost" objects that each contains details about the monthly cost estimate to analyze one of your Amazon Web Services resources. * *(dict) --* An object that contains information about the estimated monthly cost to analyze an Amazon Web Services resource. For more information, see Estimate your Amazon DevOps Guru costs and Amazon DevOps Guru pricing. * **Type** *(string) --* The type of the Amazon Web Services resource. * **State** *(string) --* The state of the resource. The resource is "ACTIVE" if it produces metrics, events, or logs within an hour, otherwise it is "INACTIVE". You pay for the number of active Amazon Web Services resource hours analyzed for each resource. Inactive resources are not charged. * **Count** *(integer) --* The number of active resources analyzed for this service to create a monthly cost estimate. * **UnitCost** *(float) --* The price per hour to analyze the resources in the service. For more information, see Estimate your Amazon DevOps Guru costs and Amazon DevOps Guru pricing. * **Cost** *(float) --* The total estimated monthly cost to analyze the active resources for this resource. * **TimeRange** *(dict) --* The start and end time of the cost estimation. * **StartTime** *(datetime) --* The start time of the cost estimation. * **EndTime** *(datetime) --* The end time of the cost estimation. * **TotalCost** *(float) --* The estimated monthly cost to analyze the Amazon Web Services resources. This value is the sum of the estimated costs to analyze each resource in the "Costs" object in this response. * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_feedback describe_feedback ***************** DevOpsGuru.Client.describe_feedback(**kwargs) Returns the most recent feedback submitted in the current Amazon Web Services account and Region. See also: AWS API Documentation **Request Syntax** response = client.describe_feedback( InsightId='string' ) Parameters: **InsightId** (*string*) -- The ID of the insight for which the feedback was provided. Return type: dict Returns: **Response Syntax** { 'InsightFeedback': { 'Id': 'string', 'Feedback': 'VALID_COLLECTION'|'RECOMMENDATION_USEFUL'|'ALERT_TOO_SENSITIVE'|'DATA_NOISY_ANOMALY'|'DATA_INCORRECT' } } **Response Structure** * *(dict) --* * **InsightFeedback** *(dict) --* Information about insight feedback received from a customer. * **Id** *(string) --* The insight feedback ID. * **Feedback** *(string) --* The feedback provided by the customer. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / update_resource_collection update_resource_collection ************************** DevOpsGuru.Client.update_resource_collection(**kwargs) Updates the collection of resources that DevOps Guru analyzes. 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. This method also creates the IAM role required for you to use DevOps Guru. See also: AWS API Documentation **Request Syntax** response = client.update_resource_collection( Action='ADD'|'REMOVE', ResourceCollection={ 'CloudFormation': { 'StackNames': [ 'string', ] }, 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValues': [ 'string', ] }, ] } ) Parameters: * **Action** (*string*) -- **[REQUIRED]** Specifies if the resource collection in the request is added or deleted to the resource collection. * **ResourceCollection** (*dict*) -- **[REQUIRED]** Contains information used to update a collection of Amazon Web Services resources. * **CloudFormation** *(dict) --* A collection of Amazon Web Services CloudFormation stacks. You can specify up to 500 Amazon Web Services CloudFormation stacks. * **StackNames** *(list) --* An array of the names of the Amazon Web Services CloudFormation stacks to update. You can specify up to 500 Amazon Web Services CloudFormation stacks. * *(string) --* * **Tags** *(list) --* The updated Amazon Web Services tags used to filter the 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * *(dict) --* A new collection of Amazon Web Services resources that are defined by an Amazon Web Services tag or tag *key*/*value* pair. * **AppBoundaryKey** *(string) --* **[REQUIRED]** 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **TagValues** *(list) --* **[REQUIRED]** 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) --* Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_anomalous_log_groups list_anomalous_log_groups ************************* DevOpsGuru.Client.list_anomalous_log_groups(**kwargs) Returns the list of log groups that contain log anomalies. See also: AWS API Documentation **Request Syntax** response = client.list_anomalous_log_groups( InsightId='string', MaxResults=123, NextToken='string' ) Parameters: * **InsightId** (*string*) -- **[REQUIRED]** The ID of the insight containing the log groups. * **MaxResults** (*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. * **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'InsightId': 'string', 'AnomalousLogGroups': [ { 'LogGroupName': 'string', 'ImpactStartTime': datetime(2015, 1, 1), 'ImpactEndTime': datetime(2015, 1, 1), 'NumberOfLogLinesScanned': 123, 'LogAnomalyShowcases': [ { 'LogAnomalyClasses': [ { 'LogStreamName': 'string', 'LogAnomalyType': 'KEYWORD'|'KEYWORD_TOKEN'|'FORMAT'|'HTTP_CODE'|'BLOCK_FORMAT'|'NUMERICAL_POINT'|'NUMERICAL_NAN'|'NEW_FIELD_NAME', 'LogAnomalyToken': 'string', 'LogEventId': 'string', 'Explanation': 'string', 'NumberOfLogLinesOccurrences': 123, 'LogEventTimestamp': datetime(2015, 1, 1) }, ] }, ] }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **InsightId** *(string) --* The ID of the insight containing the log groups. * **AnomalousLogGroups** *(list) --* The list of Amazon CloudWatch log groups that are related to an insight. * *(dict) --* An Amazon CloudWatch log group that contains log anomalies and is used to generate an insight. * **LogGroupName** *(string) --* The name of the CloudWatch log group. * **ImpactStartTime** *(datetime) --* The time the anomalous log events began. The impact start time indicates the time of the first log anomaly event that occurs. * **ImpactEndTime** *(datetime) --* The time the anomalous log events stopped. * **NumberOfLogLinesScanned** *(integer) --* The number of log lines that were scanned for anomalous log events. * **LogAnomalyShowcases** *(list) --* The log anomalies in the log group. Each log anomaly displayed represents a cluster of similar anomalous log events. * *(dict) --* A cluster of similar anomalous log events found within a log group. * **LogAnomalyClasses** *(list) --* A list of anomalous log events that may be related. * *(dict) --* Information about an anomalous log event found within a log group. * **LogStreamName** *(string) --* The name of the Amazon CloudWatch log stream that the anomalous log event belongs to. A log stream is a sequence of log events that share the same source. * **LogAnomalyType** *(string) --* The type of log anomaly that has been detected. * **LogAnomalyToken** *(string) --* The token where the anomaly was detected. This may refer to an exception or another location, or it may be blank for log anomalies such as format anomalies. * **LogEventId** *(string) --* The ID of the log event. * **Explanation** *(string) --* The explanation for why the log event is considered an anomaly. * **NumberOfLogLinesOccurrences** *(integer) --* The number of log lines where this anomalous log event occurs. * **LogEventTimestamp** *(datetime) --* The time of the first occurrence of the anomalous log event. * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / delete_insight delete_insight ************** DevOpsGuru.Client.delete_insight(**kwargs) Deletes the insight along with the associated anomalies, events and recommendations. See also: AWS API Documentation **Request Syntax** response = client.delete_insight( Id='string' ) Parameters: **Id** (*string*) -- **[REQUIRED]** The ID of the insight. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / update_service_integration update_service_integration ************************** DevOpsGuru.Client.update_service_integration(**kwargs) Enables or disables integration with a service that can be integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon Web Services Systems Manager, which can be used to create an OpsItem for each generated insight. See also: AWS API Documentation **Request Syntax** response = client.update_service_integration( ServiceIntegration={ 'OpsCenter': { 'OptInStatus': 'ENABLED'|'DISABLED' }, 'LogsAnomalyDetection': { 'OptInStatus': 'ENABLED'|'DISABLED' }, 'KMSServerSideEncryption': { 'KMSKeyId': 'string', 'OptInStatus': 'ENABLED'|'DISABLED', 'Type': 'CUSTOMER_MANAGED_KEY'|'AWS_OWNED_KMS_KEY' } } ) Parameters: **ServiceIntegration** (*dict*) -- **[REQUIRED]** An "IntegratedServiceConfig" object used to specify the integrated service you want to update, and whether you want to update it to enabled or disabled. * **OpsCenter** *(dict) --* Information about whether DevOps Guru is configured to create an OpsItem in Amazon Web Services Systems Manager OpsCenter for each created insight. You can use this to update the configuration. * **OptInStatus** *(string) --* Specifies if DevOps Guru is enabled to create an Amazon Web Services Systems Manager OpsItem for each created insight. * **LogsAnomalyDetection** *(dict) --* Information about whether DevOps Guru is configured to perform log anomaly detection on Amazon CloudWatch log groups. * **OptInStatus** *(string) --* Specifies if DevOps Guru is configured to perform log anomaly detection on CloudWatch log groups. * **KMSServerSideEncryption** *(dict) --* Information about whether DevOps Guru is configured to encrypt server-side data using KMS. * **KMSKeyId** *(string) --* Describes the specified KMS key. To specify a KMS key, use its key ID, key ARN, alias name, or alias ARN. When using an alias name, prefix it with "alias/". If you specify a predefined Amazon Web Services alias (an Amazon Web Services alias with no key ID), Amazon Web Services KMS associates the alias with an Amazon Web Services managed key and returns its KeyId and Arn in the response. To specify a KMS key in a different Amazon Web Services account, you must use the key ARN or alias ARN. For example: Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd- 12ab-34cd-56ef-1234567890ab Alias name: alias/ExampleAlias Alias ARN: arn:aws:kms:us- east-2:111122223333:alias/ExampleAlias * **OptInStatus** *(string) --* Specifies if DevOps Guru is enabled for KMS integration. * **Type** *(string) --* The type of KMS key used. Customer managed keys are the KMS keys that you create. Amazon Web Services owned keys are keys that are owned and managed by DevOps Guru. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_anomaly describe_anomaly **************** DevOpsGuru.Client.describe_anomaly(**kwargs) Returns details about an anomaly that you specify using its ID. See also: AWS API Documentation **Request Syntax** response = client.describe_anomaly( Id='string', AccountId='string' ) Parameters: * **Id** (*string*) -- **[REQUIRED]** The ID of the anomaly. * **AccountId** (*string*) -- The ID of the member account. Return type: dict Returns: **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' }, ], 'Description': '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 an 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 >>``<>``<<. * **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 >>``<>``<<. * *(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 >>``<>``<<. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. * **Description** *(string) --* A description of the proactive anomaly. * **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 an 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 >>``<>``<<. * **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 >>``<>``<<. * *(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 >>``<>``<<. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / remove_notification_channel remove_notification_channel *************************** DevOpsGuru.Client.remove_notification_channel(**kwargs) Removes a notification channel from DevOps Guru. A notification channel is used to notify you when DevOps Guru generates an insight that contains information about how to improve your operations. See also: AWS API Documentation **Request Syntax** response = client.remove_notification_channel( Id='string' ) Parameters: **Id** (*string*) -- **[REQUIRED]** The ID of the notification channel to be removed. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.ConflictException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / close close ***** DevOpsGuru.Client.close() Closes underlying endpoint connections. DevOpsGuru / Client / describe_event_sources_config describe_event_sources_config ***************************** DevOpsGuru.Client.describe_event_sources_config() Returns the integration status of services that are integrated with DevOps Guru as Consumer via EventBridge. The one service that can be integrated with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive recommendations which can be stored and viewed in DevOps Guru. See also: AWS API Documentation **Request Syntax** response = client.describe_event_sources_config() Return type: dict Returns: **Response Syntax** { 'EventSources': { 'AmazonCodeGuruProfiler': { 'Status': 'ENABLED'|'DISABLED' } } } **Response Structure** * *(dict) --* * **EventSources** *(dict) --* Lists the event sources in the configuration. * **AmazonCodeGuruProfiler** *(dict) --* Information about whether DevOps Guru is configured to consume recommendations which are generated from AWS CodeGuru Profiler. * **Status** *(string) --* The status of the CodeGuru Profiler integration. Specifies if DevOps Guru is enabled to consume recommendations that are generated from Amazon CodeGuru Profiler. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_organization_insights list_organization_insights ************************** DevOpsGuru.Client.list_organization_insights(**kwargs) Returns a list of insights associated with the account or OU Id. See also: AWS API Documentation **Request Syntax** response = client.list_organization_insights( StatusFilter={ 'Ongoing': { 'Type': 'REACTIVE'|'PROACTIVE' }, 'Closed': { 'Type': 'REACTIVE'|'PROACTIVE', 'EndTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } }, 'Any': { 'Type': 'REACTIVE'|'PROACTIVE', 'StartTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } } }, MaxResults=123, AccountIds=[ 'string', ], OrganizationalUnitIds=[ 'string', ], NextToken='string' ) Parameters: * **StatusFilter** (*dict*) -- **[REQUIRED]** A filter used by "ListInsights" to specify which insights to return. * **Ongoing** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies ongoing insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **Closed** *(dict) --* A "ListInsightsClosedStatusFilter" that specifies closed insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **EndTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights ended. * **FromTime** *(datetime) --* The earliest end time in the time range. * **ToTime** *(datetime) --* The latest end time in the time range. * **Any** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies insights of any status that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **StartTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights started. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **MaxResults** (*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. * **AccountIds** (*list*) -- The ID of the Amazon Web Services account. * *(string) --* * **OrganizationalUnitIds** (*list*) -- The ID of the organizational unit. * *(string) --* * **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { 'Id': 'string', 'AccountId': 'string', 'OrganizationalUnitId': '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, ], 'ReactiveInsights': [ { 'Id': 'string', 'AccountId': 'string', 'OrganizationalUnitId': '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] } }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight". * **Id** *(string) --* The ID of the insight summary. * **AccountId** *(string) --* The ID of the Amazon Web Services account. * **OrganizationalUnitId** *(string) --* The ID of the organizational unit. * **Name** *(string) --* The name of the insight summary. * **Severity** *(string) --* An array of severity values used to search for insights. For more information, see Understanding insight severities in the *Amazon DevOps Guru User Guide*. * **Status** *(string) --* An array of status values used to search for insights. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **ReactiveInsights** *(list) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight". * **Id** *(string) --* The ID of the insight summary. * **AccountId** *(string) --* The ID of the Amazon Web Services account. * **OrganizationalUnitId** *(string) --* The ID of the organizational unit. * **Name** *(string) --* The name of the insight summary. * **Severity** *(string) --* An array of severity values used to search for insights. For more information, see Understanding insight severities in the *Amazon DevOps Guru User Guide*. * **Status** *(string) --* An array of status values used to search for insights. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_recommendations list_recommendations ******************** DevOpsGuru.Client.list_recommendations(**kwargs) 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** response = 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' ) Parameters: * **InsightId** (*string*) -- **[REQUIRED]** The ID of the requested insight. * **NextToken** (*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. * **Locale** (*string*) -- A locale that specifies the language to use for recommendations. * **AccountId** (*string*) -- The ID of the Amazon Web Services account. Return type: dict Returns: **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 "RecommendationRelatedCloudW atchMetricsSourceDetail" 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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ResourceNotFoundException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / update_event_sources_config update_event_sources_config *************************** DevOpsGuru.Client.update_event_sources_config(**kwargs) Enables or disables integration with a service that can be integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive recommendations which can be stored and viewed in DevOps Guru. See also: AWS API Documentation **Request Syntax** response = client.update_event_sources_config( EventSources={ 'AmazonCodeGuruProfiler': { 'Status': 'ENABLED'|'DISABLED' } } ) Parameters: **EventSources** (*dict*) -- Configuration information about the integration of DevOps Guru as the Consumer via EventBridge with another AWS Service. * **AmazonCodeGuruProfiler** *(dict) --* Information about whether DevOps Guru is configured to consume recommendations which are generated from AWS CodeGuru Profiler. * **Status** *(string) --* The status of the CodeGuru Profiler integration. Specifies if DevOps Guru is enabled to consume recommendations that are generated from Amazon CodeGuru Profiler. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_insights list_insights ************* DevOpsGuru.Client.list_insights(**kwargs) Returns a list of insights in your Amazon Web Services account. You can specify which insights are returned by their start time and status ( "ONGOING", "CLOSED", or "ANY"). See also: AWS API Documentation **Request Syntax** response = client.list_insights( StatusFilter={ 'Ongoing': { 'Type': 'REACTIVE'|'PROACTIVE' }, 'Closed': { 'Type': 'REACTIVE'|'PROACTIVE', 'EndTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } }, 'Any': { 'Type': 'REACTIVE'|'PROACTIVE', 'StartTimeRange': { 'FromTime': datetime(2015, 1, 1), 'ToTime': datetime(2015, 1, 1) } } }, MaxResults=123, NextToken='string' ) Parameters: * **StatusFilter** (*dict*) -- **[REQUIRED]** A filter used to filter the returned insights by their status. You can specify one status filter. * **Ongoing** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies ongoing insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **Closed** *(dict) --* A "ListInsightsClosedStatusFilter" that specifies closed insights that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **EndTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights ended. * **FromTime** *(datetime) --* The earliest end time in the time range. * **ToTime** *(datetime) --* The latest end time in the time range. * **Any** *(dict) --* A "ListInsightsAnyStatusFilter" that specifies insights of any status that are either "REACTIVE" or "PROACTIVE". * **Type** *(string) --* **[REQUIRED]** Use to filter for either "REACTIVE" or "PROACTIVE" insights. * **StartTimeRange** *(dict) --* **[REQUIRED]** A time range used to specify when the behavior of the filtered insights started. * **FromTime** *(datetime) --* The start time of the time range. * **ToTime** *(datetime) --* The end time of the time range. * **MaxResults** (*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. * **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'ProactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'ReactiveInsights': [ { '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', ] }, ] }, 'ServiceCollection': { 'ServiceNames': [ 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', ] }, 'AssociatedResourceArns': [ 'string', ] }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **ProactiveInsights** *(list) --* The returned list of proactive insights. * *(dict) --* Details about a proactive insight. This object is returned by "DescribeInsight." * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **ReactiveInsights** *(list) --* The returned list of reactive insights. * *(dict) --* Information about a reactive insight. This object is returned by "DescribeInsight." * **Id** *(string) --* The ID of a reactive summary. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case- sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * *(dict) --* A collection of Amazon Web Services tags. 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops- guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production- application/RDS" or "Devops-Guru-production- application/containers". * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru-deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * **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) --* * **ServiceCollection** *(dict) --* A collection of the names of Amazon Web Services services. * **ServiceNames** *(list) --* An array of strings that each specifies the name of an Amazon Web Services service. * *(string) --* * **AssociatedResourceArns** *(list) --* The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight. * *(string) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_resource_collection_health describe_resource_collection_health *********************************** DevOpsGuru.Client.describe_resource_collection_health(**kwargs) Returns the number of open proactive insights, open reactive insights, and the Mean Time to Recover (MTTR) for all closed insights in resource collections in your account. You specify the type of Amazon Web Services resources collection. 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. See also: AWS API Documentation **Request Syntax** response = client.describe_resource_collection_health( ResourceCollectionType='AWS_CLOUD_FORMATION'|'AWS_SERVICE'|'AWS_TAGS', NextToken='string' ) Parameters: * **ResourceCollectionType** (*string*) -- **[REQUIRED]** An Amazon Web Services resource collection type. This type specifies how analyzed Amazon Web Services resources are defined. 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. * **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'CloudFormation': [ { 'StackName': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Service': [ { 'ServiceName': 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123 }, 'AnalyzedResourceCount': 123 }, ], 'NextToken': 'string', 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValue': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ] } **Response Structure** * *(dict) --* * **CloudFormation** *(list) --* The returned "CloudFormationHealthOverview" object that contains an "InsightHealthOverview" object with the requested system health information. * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack. * **StackName** *(string) --* The name of the CloudFormation stack. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services CloudFormation stack. * **Service** *(list) --* An array of "ServiceHealth" objects that describes the health of the Amazon Web Services services associated with the resources in the collection. * *(dict) --* Represents the health of an Amazon Web Services service. * **ServiceName** *(string) --* The name of the Amazon Web Services service. * **Insight** *(dict) --* Represents the health of an Amazon Web Services service. This is a "ServiceInsightHealth" that contains the number of open proactive and reactive insights for this service. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights in the Amazon Web Services service * **OpenReactiveInsights** *(integer) --* The number of open reactive insights in the Amazon Web Services service * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in an analyzed Amazon Web Services service. * **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. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services tag *key*. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **TagValue** *(string) --* The value in an Amazon Web Services tag. 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. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services tag, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services tag. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / list_notification_channels list_notification_channels ************************** DevOpsGuru.Client.list_notification_channels(**kwargs) Returns a list of notification channels configured for DevOps Guru. Each notification channel is used to notify you when DevOps Guru generates an insight that contains information about how to improve your operations. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS). See also: AWS API Documentation **Request Syntax** response = client.list_notification_channels( NextToken='string' ) Parameters: **NextToken** (*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. Return type: dict Returns: **Response Syntax** { 'Channels': [ { 'Id': 'string', 'Config': { 'Sns': { 'TopicArn': 'string' }, 'Filters': { 'Severities': [ 'LOW'|'MEDIUM'|'HIGH', ], 'MessageTypes': [ 'NEW_INSIGHT'|'CLOSED_INSIGHT'|'NEW_ASSOCIATION'|'SEVERITY_UPGRADED'|'NEW_RECOMMENDATION', ] } } }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **Channels** *(list) --* An array that contains the requested notification channels. * *(dict) --* Information about a notification channel. A notification channel is used to notify you when DevOps Guru creates an insight. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS). If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics. If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer- managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics. * **Id** *(string) --* The ID of a notification channel. * **Config** *(dict) --* A "NotificationChannelConfig" object that contains information about configured notification channels. * **Sns** *(dict) --* Information about a notification channel configured in DevOps Guru to send notifications when insights are created. If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for Amazon SNS topics. If you use an Amazon SNS topic that is encrypted by an Amazon Web Services Key Management Service customer- managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics. * **TopicArn** *(string) --* The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic. * **Filters** *(dict) --* The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. If you do not provide filter configurations, the default configurations are to receive notifications for all message types of "High" or "Medium" severity. * **Severities** *(list) --* The severity levels that you want to receive notifications for. For example, you can choose to receive notifications only for insights with "HIGH" and "MEDIUM" severity levels. For more information, see Understanding insight severities. * *(string) --* * **MessageTypes** *(list) --* The events that you want to receive notifications for. For example, you can choose to receive notifications only when the severity level is upgraded or a new insight is created. * *(string) --* * **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. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException" DevOpsGuru / Client / describe_organization_resource_collection_health describe_organization_resource_collection_health ************************************************ DevOpsGuru.Client.describe_organization_resource_collection_health(**kwargs) Provides an overview of your system's health. If additional member accounts are part of your organization, you can filter those accounts using the "AccountIds" field. See also: AWS API Documentation **Request Syntax** response = client.describe_organization_resource_collection_health( OrganizationResourceCollectionType='AWS_CLOUD_FORMATION'|'AWS_SERVICE'|'AWS_ACCOUNT'|'AWS_TAGS', AccountIds=[ 'string', ], OrganizationalUnitIds=[ 'string', ], NextToken='string', MaxResults=123 ) Parameters: * **OrganizationResourceCollectionType** (*string*) -- **[REQUIRED]** An Amazon Web Services resource collection type. This type specifies how analyzed Amazon Web Services resources are defined. 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. * **AccountIds** (*list*) -- The ID of the Amazon Web Services account. * *(string) --* * **OrganizationalUnitIds** (*list*) -- The ID of the organizational unit. * *(string) --* * **NextToken** (*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. * **MaxResults** (*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. Return type: dict Returns: **Response Syntax** { 'CloudFormation': [ { 'StackName': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Service': [ { 'ServiceName': 'API_GATEWAY'|'APPLICATION_ELB'|'AUTO_SCALING_GROUP'|'CLOUD_FRONT'|'DYNAMO_DB'|'EC2'|'ECS'|'EKS'|'ELASTIC_BEANSTALK'|'ELASTI_CACHE'|'ELB'|'ES'|'KINESIS'|'LAMBDA'|'NAT_GATEWAY'|'NETWORK_ELB'|'RDS'|'REDSHIFT'|'ROUTE_53'|'S3'|'SAGE_MAKER'|'SNS'|'SQS'|'STEP_FUNCTIONS'|'SWF', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123 }, 'AnalyzedResourceCount': 123 }, ], 'Account': [ { 'AccountId': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123 } }, ], 'NextToken': 'string', 'Tags': [ { 'AppBoundaryKey': 'string', 'TagValue': 'string', 'Insight': { 'OpenProactiveInsights': 123, 'OpenReactiveInsights': 123, 'MeanTimeToRecoverInMilliseconds': 123 }, 'AnalyzedResourceCount': 123 }, ] } **Response Structure** * *(dict) --* * **CloudFormation** *(list) --* The returned "CloudFormationHealthOverview" object that contains an "InsightHealthOverview" object with the requested system health information. * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack. * **StackName** *(string) --* The name of the CloudFormation stack. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services CloudFormation stack. * **Service** *(list) --* An array of "ServiceHealth" objects that describes the health of the Amazon Web Services services associated with the resources in the collection. * *(dict) --* Represents the health of an Amazon Web Services service. * **ServiceName** *(string) --* The name of the Amazon Web Services service. * **Insight** *(dict) --* Represents the health of an Amazon Web Services service. This is a "ServiceInsightHealth" that contains the number of open proactive and reactive insights for this service. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights in the Amazon Web Services service * **OpenReactiveInsights** *(integer) --* The number of open reactive insights in the Amazon Web Services service * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in an analyzed Amazon Web Services service. * **Account** *(list) --* The name of the organization's account. * *(dict) --* Returns the number of open reactive insights, the number of open proactive insights, and the number of metrics analyzed in your Amazon Web Services account. Use these numbers to gauge the health of operations in your Amazon Web Services account. * **AccountId** *(string) --* The ID of the Amazon Web Services account. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* An integer that specifies the number of open proactive insights in your Amazon Web Services account. * **OpenReactiveInsights** *(integer) --* An integer that specifies the number of open reactive insights in your Amazon Web Services account. * **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. * **Tags** *(list) --* 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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps-Guru- deployment-application" or "devops-guru-rds-application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops-guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops-Guru-production-application/containers". * *(dict) --* Information about the health of Amazon Web Services resources in your account that are specified by an Amazon Web Services tag *key*. * **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. Warning: The string used for a *key* in a tag that you use to define your resource coverage must begin with the prefix "Devops-guru-". The tag *key* might be "DevOps- Guru-deployment-application" or "devops-guru-rds- application". When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named "devops- guru-rds" and a *key* named "DevOps-Guru-RDS", and these act as two different *keys*. Possible *key*/*value* pairs in your application might be "Devops-Guru-production-application/RDS" or "Devops- Guru-production-application/containers". * **TagValue** *(string) --* The value in an Amazon Web Services tag. 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. * **Insight** *(dict) --* Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services tag, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. * **OpenProactiveInsights** *(integer) --* The number of open proactive insights. * **OpenReactiveInsights** *(integer) --* The number of open reactive insights. * **MeanTimeToRecoverInMilliseconds** *(integer) --* The Meant Time to Recover (MTTR) for the insight. * **AnalyzedResourceCount** *(integer) --* Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services tag. **Exceptions** * "DevOpsGuru.Client.exceptions.AccessDeniedException" * "DevOpsGuru.Client.exceptions.InternalServerException" * "DevOpsGuru.Client.exceptions.ThrottlingException" * "DevOpsGuru.Client.exceptions.ValidationException"