Application Insights
This page documents function available when using the Application_Insights
module, created with @service Application_Insights
.
Index
Main.Application_Insights.add_workload
Main.Application_Insights.create_application
Main.Application_Insights.create_component
Main.Application_Insights.create_log_pattern
Main.Application_Insights.delete_application
Main.Application_Insights.delete_component
Main.Application_Insights.delete_log_pattern
Main.Application_Insights.describe_application
Main.Application_Insights.describe_component
Main.Application_Insights.describe_component_configuration
Main.Application_Insights.describe_component_configuration_recommendation
Main.Application_Insights.describe_log_pattern
Main.Application_Insights.describe_observation
Main.Application_Insights.describe_problem
Main.Application_Insights.describe_problem_observations
Main.Application_Insights.describe_workload
Main.Application_Insights.list_applications
Main.Application_Insights.list_components
Main.Application_Insights.list_configuration_history
Main.Application_Insights.list_log_pattern_sets
Main.Application_Insights.list_log_patterns
Main.Application_Insights.list_problems
Main.Application_Insights.list_tags_for_resource
Main.Application_Insights.list_workloads
Main.Application_Insights.remove_workload
Main.Application_Insights.tag_resource
Main.Application_Insights.untag_resource
Main.Application_Insights.update_application
Main.Application_Insights.update_component
Main.Application_Insights.update_component_configuration
Main.Application_Insights.update_log_pattern
Main.Application_Insights.update_problem
Main.Application_Insights.update_workload
Documentation
Main.Application_Insights.add_workload
— Methodadd_workload(component_name, resource_group_name, workload_configuration)
add_workload(component_name, resource_group_name, workload_configuration, params::Dict{String,<:Any})
Adds a workload to a component. Each component can have at most five workloads.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.workload_configuration
: The configuration settings of the workload. The value is the escaped JSON of the configuration.
Main.Application_Insights.create_application
— Methodcreate_application()
create_application(params::Dict{String,<:Any})
Adds an application that is created from a resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AttachMissingPermission"
: If set to true, the managed policies for SSM and CW will be attached to the instance roles if they are missing."AutoConfigEnabled"
: Indicates whether Application Insights automatically configures unmonitored resources in the resource group."AutoCreate"
: Configures all of the resources in the resource group by applying the recommended configurations."CWEMonitorEnabled"
: Indicates whether Application Insights can listen to CloudWatch events for the application resources, such as instance terminated, failed deployment, and others."GroupingType"
: Application Insights can create applications based on a resource group or on an account. To create an account-based application using all of the resources in the account, set this parameter to ACCOUNT_BASED."OpsCenterEnabled"
: When set to true, creates opsItems for any problems detected on an application."OpsItemSNSTopicArn"
: The SNS topic provided to Application Insights that is associated to the created opsItem. Allows you to receive notifications for updates to the opsItem."ResourceGroupName"
: The name of the resource group."Tags"
: List of tags to add to the application. tag key (Key) and an associated tag value (Value). The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.
Main.Application_Insights.create_component
— Methodcreate_component(component_name, resource_group_name, resource_list)
create_component(component_name, resource_group_name, resource_list, params::Dict{String,<:Any})
Creates a custom component by grouping similar standalone instances to monitor.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.resource_list
: The list of resource ARNs that belong to the component.
Main.Application_Insights.create_log_pattern
— Methodcreate_log_pattern(pattern, pattern_name, pattern_set_name, rank, resource_group_name)
create_log_pattern(pattern, pattern_name, pattern_set_name, rank, resource_group_name, params::Dict{String,<:Any})
Adds an log pattern to a LogPatternSet.
Arguments
pattern
: The log pattern. The pattern must be DFA compatible. Patterns that utilize forward lookahead or backreference constructions are not supported.pattern_name
: The name of the log pattern.pattern_set_name
: The name of the log pattern set.rank
: Rank of the log pattern. Must be a value between 1 and 1,000,000. The patterns are sorted by rank, so we recommend that you set your highest priority patterns with the lowest rank. A pattern of rank 1 will be the first to get matched to a log line. A pattern of rank 1,000,000 will be last to get matched. When you configure custom log patterns from the console, a Low severity pattern translates to a 750,000 rank. A Medium severity pattern translates to a 500,000 rank. And a High severity pattern translates to a 250,000 rank. Rank values less than 1 or greater than 1,000,000 are reserved for AWS-provided patterns.resource_group_name
: The name of the resource group.
Main.Application_Insights.delete_application
— Methoddelete_application(resource_group_name)
delete_application(resource_group_name, params::Dict{String,<:Any})
Removes the specified application from monitoring. Does not delete the application.
Arguments
resource_group_name
: The name of the resource group.
Main.Application_Insights.delete_component
— Methoddelete_component(component_name, resource_group_name)
delete_component(component_name, resource_group_name, params::Dict{String,<:Any})
Ungroups a custom component. When you ungroup custom components, all applicable monitors that are set up for the component are removed and the instances revert to their standalone status.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.
Main.Application_Insights.delete_log_pattern
— Methoddelete_log_pattern(pattern_name, pattern_set_name, resource_group_name)
delete_log_pattern(pattern_name, pattern_set_name, resource_group_name, params::Dict{String,<:Any})
Removes the specified log pattern from a LogPatternSet.
Arguments
pattern_name
: The name of the log pattern.pattern_set_name
: The name of the log pattern set.resource_group_name
: The name of the resource group.
Main.Application_Insights.describe_application
— Methoddescribe_application(resource_group_name)
describe_application(resource_group_name, params::Dict{String,<:Any})
Describes the application.
Arguments
resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner.
Main.Application_Insights.describe_component
— Methoddescribe_component(component_name, resource_group_name)
describe_component(component_name, resource_group_name, params::Dict{String,<:Any})
Describes a component and lists the resources that are grouped together in a component.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner.
Main.Application_Insights.describe_component_configuration
— Methoddescribe_component_configuration(component_name, resource_group_name)
describe_component_configuration(component_name, resource_group_name, params::Dict{String,<:Any})
Describes the monitoring configuration of the component.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner.
Main.Application_Insights.describe_component_configuration_recommendation
— Methoddescribe_component_configuration_recommendation(component_name, resource_group_name, tier)
describe_component_configuration_recommendation(component_name, resource_group_name, tier, params::Dict{String,<:Any})
Describes the recommended monitoring configuration of the component.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.tier
: The tier of the application component.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"RecommendationType"
: The recommended configuration type."WorkloadName"
: The name of the workload.
Main.Application_Insights.describe_log_pattern
— Methoddescribe_log_pattern(pattern_name, pattern_set_name, resource_group_name)
describe_log_pattern(pattern_name, pattern_set_name, resource_group_name, params::Dict{String,<:Any})
Describe a specific log pattern from a LogPatternSet.
Arguments
pattern_name
: The name of the log pattern.pattern_set_name
: The name of the log pattern set.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner.
Main.Application_Insights.describe_observation
— Methoddescribe_observation(observation_id)
describe_observation(observation_id, params::Dict{String,<:Any})
Describes an anomaly or error with the application.
Arguments
observation_id
: The ID of the observation.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner.
Main.Application_Insights.describe_problem
— Methoddescribe_problem(problem_id)
describe_problem(problem_id, params::Dict{String,<:Any})
Describes an application problem.
Arguments
problem_id
: The ID of the problem.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the owner of the resource group affected by the problem.
Main.Application_Insights.describe_problem_observations
— Methoddescribe_problem_observations(problem_id)
describe_problem_observations(problem_id, params::Dict{String,<:Any})
Describes the anomalies or errors associated with the problem.
Arguments
problem_id
: The ID of the problem.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner.
Main.Application_Insights.describe_workload
— Methoddescribe_workload(component_name, resource_group_name, workload_id)
describe_workload(component_name, resource_group_name, workload_id, params::Dict{String,<:Any})
Describes a workload and its configuration.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.workload_id
: The ID of the workload.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the workload owner.
Main.Application_Insights.list_applications
— Methodlist_applications()
list_applications(params::Dict{String,<:Any})
Lists the IDs of the applications that you are monitoring.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner."MaxResults"
: The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value."NextToken"
: The token to request the next page of results.
Main.Application_Insights.list_components
— Methodlist_components(resource_group_name)
list_components(resource_group_name, params::Dict{String,<:Any})
Lists the auto-grouped, standalone, and custom components of the application.
Arguments
resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner."MaxResults"
: The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value."NextToken"
: The token to request the next page of results.
Main.Application_Insights.list_configuration_history
— Methodlist_configuration_history()
list_configuration_history(params::Dict{String,<:Any})
Lists the INFO, WARN, and ERROR events for periodic configuration updates performed by Application Insights. Examples of events represented are: INFO: creating a new alarm or updating an alarm threshold. WARN: alarm not created due to insufficient data points used to predict thresholds. ERROR: alarm not created due to permission errors or exceeding quotas.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner."EndTime"
: The end time of the event."EventStatus"
: The status of the configuration update event. Possible values include INFO, WARN, and ERROR."MaxResults"
: The maximum number of results returned by ListConfigurationHistory in paginated output. When this parameter is used, ListConfigurationHistory returns only MaxResults in a single page along with a NextToken response element. The remaining results of the initial request can be seen by sending another ListConfigurationHistory request with the returned NextToken value. If this parameter is not used, then ListConfigurationHistory returns all results."NextToken"
: The NextToken value returned from a previous paginated ListConfigurationHistory request where MaxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the NextToken value. This value is null when there are no more results to return."ResourceGroupName"
: Resource group to which the application belongs."StartTime"
: The start time of the event.
Main.Application_Insights.list_log_pattern_sets
— Methodlist_log_pattern_sets(resource_group_name)
list_log_pattern_sets(resource_group_name, params::Dict{String,<:Any})
Lists the log pattern sets in the specific application.
Arguments
resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner."MaxResults"
: The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value."NextToken"
: The token to request the next page of results.
Main.Application_Insights.list_log_patterns
— Methodlist_log_patterns(resource_group_name)
list_log_patterns(resource_group_name, params::Dict{String,<:Any})
Lists the log patterns in the specific log LogPatternSet.
Arguments
resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner."MaxResults"
: The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value."NextToken"
: The token to request the next page of results."PatternSetName"
: The name of the log pattern set.
Main.Application_Insights.list_problems
— Methodlist_problems()
list_problems(params::Dict{String,<:Any})
Lists the problems with your application.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID for the resource group owner."ComponentName"
: The name of the component."EndTime"
: The time when the problem ended, in epoch seconds. If not specified, problems within the past seven days are returned."MaxResults"
: The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value."NextToken"
: The token to request the next page of results."ResourceGroupName"
: The name of the resource group."StartTime"
: The time when the problem was detected, in epoch seconds. If you don't specify a time frame for the request, problems within the past seven days are returned."Visibility"
: Specifies whether or not you can view the problem. If not specified, visible and ignored problems are returned.
Main.Application_Insights.list_tags_for_resource
— Methodlist_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})
Retrieve a list of the tags (keys and values) that are associated with a specified application. A tag is a label that you optionally define and associate with an application. Each tag consists of a required tag key and an optional associated tag value. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the application that you want to retrieve tag information for.
Main.Application_Insights.list_workloads
— Methodlist_workloads(component_name, resource_group_name)
list_workloads(component_name, resource_group_name, params::Dict{String,<:Any})
Lists the workloads that are configured on a given component.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AccountId"
: The AWS account ID of the owner of the workload."MaxResults"
: The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value."NextToken"
: The token to request the next page of results.
Main.Application_Insights.remove_workload
— Methodremove_workload(component_name, resource_group_name, workload_id)
remove_workload(component_name, resource_group_name, workload_id, params::Dict{String,<:Any})
Remove workload from a component.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.workload_id
: The ID of the workload.
Main.Application_Insights.tag_resource
— Methodtag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})
Add one or more tags (keys and values) to a specified application. A tag is a label that you optionally define and associate with an application. Tags can help you categorize and manage application in different ways, such as by purpose, owner, environment, or other criteria. Each tag consists of a required tag key and an associated tag value, both of which you define. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the application that you want to add one or more tags to.tags
: A list of tags that to add to the application. A tag consists of a required tag key (Key) and an associated tag value (Value). The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.
Main.Application_Insights.untag_resource
— Methoduntag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})
Remove one or more tags (keys and values) from a specified application.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the application that you want to remove one or more tags from.tag_keys
: The tags (tag keys) that you want to remove from the resource. When you specify a tag key, the action removes both that key and its associated tag value. To remove more than one tag from the application, append the TagKeys parameter and argument for each additional tag to remove, separated by an ampersand.
Main.Application_Insights.update_application
— Methodupdate_application(resource_group_name)
update_application(resource_group_name, params::Dict{String,<:Any})
Updates the application.
Arguments
resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AttachMissingPermission"
: If set to true, the managed policies for SSM and CW will be attached to the instance roles if they are missing."AutoConfigEnabled"
: Turns auto-configuration on or off."CWEMonitorEnabled"
: Indicates whether Application Insights can listen to CloudWatch events for the application resources, such as instance terminated, failed deployment, and others."OpsCenterEnabled"
: When set to true, creates opsItems for any problems detected on an application."OpsItemSNSTopicArn"
: The SNS topic provided to Application Insights that is associated to the created opsItem. Allows you to receive notifications for updates to the opsItem."RemoveSNSTopic"
: Disassociates the SNS topic from the opsItem created for detected problems.
Main.Application_Insights.update_component
— Methodupdate_component(component_name, resource_group_name)
update_component(component_name, resource_group_name, params::Dict{String,<:Any})
Updates the custom component name and/or the list of resources that make up the component.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"NewComponentName"
: The new name of the component."ResourceList"
: The list of resource ARNs that belong to the component.
Main.Application_Insights.update_component_configuration
— Methodupdate_component_configuration(component_name, resource_group_name)
update_component_configuration(component_name, resource_group_name, params::Dict{String,<:Any})
Updates the monitoring configurations for the component. The configuration input parameter is an escaped JSON of the configuration and should match the schema of what is returned by DescribeComponentConfigurationRecommendation.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"AutoConfigEnabled"
: Automatically configures the component by applying the recommended configurations."ComponentConfiguration"
: The configuration settings of the component. The value is the escaped JSON of the configuration. For more information about the JSON format, see Working with JSON. You can send a request to DescribeComponentConfigurationRecommendation to see the recommended configuration for a component. For the complete format of the component configuration file, see Component Configuration."Monitor"
: Indicates whether the application component is monitored."Tier"
: The tier of the application component.
Main.Application_Insights.update_log_pattern
— Methodupdate_log_pattern(pattern_name, pattern_set_name, resource_group_name)
update_log_pattern(pattern_name, pattern_set_name, resource_group_name, params::Dict{String,<:Any})
Adds a log pattern to a LogPatternSet.
Arguments
pattern_name
: The name of the log pattern.pattern_set_name
: The name of the log pattern set.resource_group_name
: The name of the resource group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"Pattern"
: The log pattern. The pattern must be DFA compatible. Patterns that utilize forward lookahead or backreference constructions are not supported."Rank"
: Rank of the log pattern. Must be a value between 1 and 1,000,000. The patterns are sorted by rank, so we recommend that you set your highest priority patterns with the lowest rank. A pattern of rank 1 will be the first to get matched to a log line. A pattern of rank 1,000,000 will be last to get matched. When you configure custom log patterns from the console, a Low severity pattern translates to a 750,000 rank. A Medium severity pattern translates to a 500,000 rank. And a High severity pattern translates to a 250,000 rank. Rank values less than 1 or greater than 1,000,000 are reserved for AWS-provided patterns.
Main.Application_Insights.update_problem
— Methodupdate_problem(problem_id)
update_problem(problem_id, params::Dict{String,<:Any})
Updates the visibility of the problem or specifies the problem as RESOLVED.
Arguments
problem_id
: The ID of the problem.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"UpdateStatus"
: The status of the problem. Arguments can be passed for only problems that show a status of RECOVERING."Visibility"
: The visibility of a problem. When you pass a value of IGNORED, the problem is removed from the default view, and all notifications for the problem are suspended. When VISIBLE is passed, the IGNORED action is reversed.
Main.Application_Insights.update_workload
— Methodupdate_workload(component_name, resource_group_name, workload_configuration)
update_workload(component_name, resource_group_name, workload_configuration, params::Dict{String,<:Any})
Adds a workload to a component. Each component can have at most five workloads.
Arguments
component_name
: The name of the component.resource_group_name
: The name of the resource group.workload_configuration
: The configuration settings of the workload. The value is the escaped JSON of the configuration.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"WorkloadId"
: The ID of the workload.