Lookoutmetrics
This page documents function available when using the Lookoutmetrics module, created with @service Lookoutmetrics.
Index
Main.Lookoutmetrics.activate_anomaly_detectorMain.Lookoutmetrics.back_test_anomaly_detectorMain.Lookoutmetrics.create_alertMain.Lookoutmetrics.create_anomaly_detectorMain.Lookoutmetrics.create_metric_setMain.Lookoutmetrics.deactivate_anomaly_detectorMain.Lookoutmetrics.delete_alertMain.Lookoutmetrics.delete_anomaly_detectorMain.Lookoutmetrics.describe_alertMain.Lookoutmetrics.describe_anomaly_detection_executionsMain.Lookoutmetrics.describe_anomaly_detectorMain.Lookoutmetrics.describe_metric_setMain.Lookoutmetrics.detect_metric_set_configMain.Lookoutmetrics.get_anomaly_groupMain.Lookoutmetrics.get_data_quality_metricsMain.Lookoutmetrics.get_feedbackMain.Lookoutmetrics.get_sample_dataMain.Lookoutmetrics.list_alertsMain.Lookoutmetrics.list_anomaly_detectorsMain.Lookoutmetrics.list_anomaly_group_related_metricsMain.Lookoutmetrics.list_anomaly_group_summariesMain.Lookoutmetrics.list_anomaly_group_time_seriesMain.Lookoutmetrics.list_metric_setsMain.Lookoutmetrics.list_tags_for_resourceMain.Lookoutmetrics.put_feedbackMain.Lookoutmetrics.tag_resourceMain.Lookoutmetrics.untag_resourceMain.Lookoutmetrics.update_alertMain.Lookoutmetrics.update_anomaly_detectorMain.Lookoutmetrics.update_metric_set
Documentation
Main.Lookoutmetrics.activate_anomaly_detector — Method
activate_anomaly_detector(anomaly_detector_arn)
activate_anomaly_detector(anomaly_detector_arn, params::Dict{String,<:Any})Activates an anomaly detector.
Arguments
anomaly_detector_arn: The ARN of the anomaly detector.
Main.Lookoutmetrics.back_test_anomaly_detector — Method
back_test_anomaly_detector(anomaly_detector_arn)
back_test_anomaly_detector(anomaly_detector_arn, params::Dict{String,<:Any})Runs a backtest for anomaly detection for the specified resource.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.
Main.Lookoutmetrics.create_alert — Method
create_alert(action, alert_name, anomaly_detector_arn)
create_alert(action, alert_name, anomaly_detector_arn, params::Dict{String,<:Any})Creates an alert for an anomaly detector.
Arguments
action: Action that will be triggered when there is an alert.alert_name: The name of the alert.anomaly_detector_arn: The ARN of the detector to which the alert is attached.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"AlertDescription": A description of the alert."AlertFilters": The configuration of the alert filters, containing MetricList and DimensionFilterList."AlertSensitivityThreshold": An integer from 0 to 100 specifying the alert sensitivity threshold."Tags": A list of tags to apply to the alert.
Main.Lookoutmetrics.create_anomaly_detector — Method
create_anomaly_detector(anomaly_detector_config, anomaly_detector_name)
create_anomaly_detector(anomaly_detector_config, anomaly_detector_name, params::Dict{String,<:Any})Creates an anomaly detector.
Arguments
anomaly_detector_config: Contains information about the configuration of the anomaly detector.anomaly_detector_name: The name of the detector.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"AnomalyDetectorDescription": A description of the detector."KmsKeyArn": The ARN of the KMS key to use to encrypt your data."Tags": A list of tags to apply to the anomaly detector.
Main.Lookoutmetrics.create_metric_set — Method
create_metric_set(anomaly_detector_arn, metric_list, metric_set_name, metric_source)
create_metric_set(anomaly_detector_arn, metric_list, metric_set_name, metric_source, params::Dict{String,<:Any})Creates a dataset.
Arguments
anomaly_detector_arn: The ARN of the anomaly detector that will use the dataset.metric_list: A list of metrics that the dataset will contain.metric_set_name: The name of the dataset.metric_source: Contains information about how the source data should be interpreted.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"DimensionFilterList": A list of filters that specify which data is kept for anomaly detection."DimensionList": A list of the fields you want to treat as dimensions."MetricSetDescription": A description of the dataset you are creating."MetricSetFrequency": The frequency with which the source data will be analyzed for anomalies."Offset": After an interval ends, the amount of seconds that the detector waits before importing data. Offset is only supported for S3, Redshift, Athena and datasources."Tags": A list of tags to apply to the dataset."TimestampColumn": Contains information about the column used for tracking time in your source data."Timezone": The time zone in which your source data was recorded.
Main.Lookoutmetrics.deactivate_anomaly_detector — Method
deactivate_anomaly_detector(anomaly_detector_arn)
deactivate_anomaly_detector(anomaly_detector_arn, params::Dict{String,<:Any})Deactivates an anomaly detector.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.
Main.Lookoutmetrics.delete_alert — Method
delete_alert(alert_arn)
delete_alert(alert_arn, params::Dict{String,<:Any})Deletes an alert.
Arguments
alert_arn: The ARN of the alert to delete.
Main.Lookoutmetrics.delete_anomaly_detector — Method
delete_anomaly_detector(anomaly_detector_arn)
delete_anomaly_detector(anomaly_detector_arn, params::Dict{String,<:Any})Deletes a detector. Deleting an anomaly detector will delete all of its corresponding resources including any configured datasets and alerts.
Arguments
anomaly_detector_arn: The ARN of the detector to delete.
Main.Lookoutmetrics.describe_alert — Method
describe_alert(alert_arn)
describe_alert(alert_arn, params::Dict{String,<:Any})Describes an alert. Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.
Arguments
alert_arn: The ARN of the alert to describe.
Main.Lookoutmetrics.describe_anomaly_detection_executions — Method
describe_anomaly_detection_executions(anomaly_detector_arn)
describe_anomaly_detection_executions(anomaly_detector_arn, params::Dict{String,<:Any})Returns information about the status of the specified anomaly detection jobs.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MaxResults": The number of items to return in the response."NextToken": Specify the pagination token that's returned by a previous request to retrieve the next page of results."Timestamp": The timestamp of the anomaly detection job.
Main.Lookoutmetrics.describe_anomaly_detector — Method
describe_anomaly_detector(anomaly_detector_arn)
describe_anomaly_detector(anomaly_detector_arn, params::Dict{String,<:Any})Describes a detector. Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.
Arguments
anomaly_detector_arn: The ARN of the detector to describe.
Main.Lookoutmetrics.describe_metric_set — Method
describe_metric_set(metric_set_arn)
describe_metric_set(metric_set_arn, params::Dict{String,<:Any})Describes a dataset. Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.
Arguments
metric_set_arn: The ARN of the dataset.
Main.Lookoutmetrics.detect_metric_set_config — Method
detect_metric_set_config(anomaly_detector_arn, auto_detection_metric_source)
detect_metric_set_config(anomaly_detector_arn, auto_detection_metric_source, params::Dict{String,<:Any})Detects an Amazon S3 dataset's file format, interval, and offset.
Arguments
anomaly_detector_arn: An anomaly detector ARN.auto_detection_metric_source: A data source.
Main.Lookoutmetrics.get_anomaly_group — Method
get_anomaly_group(anomaly_detector_arn, anomaly_group_id)
get_anomaly_group(anomaly_detector_arn, anomaly_group_id, params::Dict{String,<:Any})Returns details about a group of anomalous metrics.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.anomaly_group_id: The ID of the anomaly group.
Main.Lookoutmetrics.get_data_quality_metrics — Method
get_data_quality_metrics(anomaly_detector_arn)
get_data_quality_metrics(anomaly_detector_arn, params::Dict{String,<:Any})Returns details about the requested data quality metrics.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector that you want to investigate.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MetricSetArn": The Amazon Resource Name (ARN) of a specific data quality metric set.
Main.Lookoutmetrics.get_feedback — Method
get_feedback(anomaly_detector_arn, anomaly_group_time_series_feedback)
get_feedback(anomaly_detector_arn, anomaly_group_time_series_feedback, params::Dict{String,<:Any})Get feedback for an anomaly group.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.anomaly_group_time_series_feedback: The anomalous metric and group ID.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MaxResults": The maximum number of results to return."NextToken": Specify the pagination token that's returned by a previous request to retrieve the next page of results.
Main.Lookoutmetrics.get_sample_data — Method
get_sample_data()
get_sample_data(params::Dict{String,<:Any})Returns a selection of sample records from an Amazon S3 datasource.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"S3SourceConfig": A datasource bucket in Amazon S3.
Main.Lookoutmetrics.list_alerts — Method
list_alerts()
list_alerts(params::Dict{String,<:Any})Lists the alerts attached to a detector. Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"AnomalyDetectorArn": The ARN of the alert's detector."MaxResults": The maximum number of results that will be displayed by the request."NextToken": If the result of the previous request is truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.
Main.Lookoutmetrics.list_anomaly_detectors — Method
list_anomaly_detectors()
list_anomaly_detectors(params::Dict{String,<:Any})Lists the detectors in the current AWS Region. Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MaxResults": The maximum number of results to return."NextToken": If the result of the previous request was truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.
Main.Lookoutmetrics.list_anomaly_group_related_metrics — Method
list_anomaly_group_related_metrics(anomaly_detector_arn, anomaly_group_id)
list_anomaly_group_related_metrics(anomaly_detector_arn, anomaly_group_id, params::Dict{String,<:Any})Returns a list of measures that are potential causes or effects of an anomaly group.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.anomaly_group_id: The ID of the anomaly group.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MaxResults": The maximum number of results to return."NextToken": Specify the pagination token that's returned by a previous request to retrieve the next page of results."RelationshipTypeFilter": Filter for potential causes (CAUSEOFINPUTANOMALYGROUP) or downstream effects (EFFECTOFINPUTANOMALYGROUP) of the anomaly group.
Main.Lookoutmetrics.list_anomaly_group_summaries — Method
list_anomaly_group_summaries(anomaly_detector_arn, sensitivity_threshold)
list_anomaly_group_summaries(anomaly_detector_arn, sensitivity_threshold, params::Dict{String,<:Any})Returns a list of anomaly groups.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.sensitivity_threshold: The minimum severity score for inclusion in the output.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MaxResults": The maximum number of results to return."NextToken": Specify the pagination token that's returned by a previous request to retrieve the next page of results.
Main.Lookoutmetrics.list_anomaly_group_time_series — Method
list_anomaly_group_time_series(anomaly_detector_arn, anomaly_group_id, metric_name)
list_anomaly_group_time_series(anomaly_detector_arn, anomaly_group_id, metric_name, params::Dict{String,<:Any})Gets a list of anomalous metrics for a measure in an anomaly group.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.anomaly_group_id: The ID of the anomaly group.metric_name: The name of the measure field.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"MaxResults": The maximum number of results to return."NextToken": Specify the pagination token that's returned by a previous request to retrieve the next page of results.
Main.Lookoutmetrics.list_metric_sets — Method
list_metric_sets()
list_metric_sets(params::Dict{String,<:Any})Lists the datasets in the current AWS Region. Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"AnomalyDetectorArn": The ARN of the anomaly detector containing the metrics sets to list."MaxResults": The maximum number of results to return."NextToken": If the result of the previous request was truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.
Main.Lookoutmetrics.list_tags_for_resource — Method
list_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})Gets a list of tags for a detector, dataset, or alert.
Arguments
resource_arn: The resource's Amazon Resource Name (ARN).
Main.Lookoutmetrics.put_feedback — Method
put_feedback(anomaly_detector_arn, anomaly_group_time_series_feedback)
put_feedback(anomaly_detector_arn, anomaly_group_time_series_feedback, params::Dict{String,<:Any})Add feedback for an anomalous metric.
Arguments
anomaly_detector_arn: The Amazon Resource Name (ARN) of the anomaly detector.anomaly_group_time_series_feedback: Feedback for an anomalous metric.
Main.Lookoutmetrics.tag_resource — Method
tag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})Adds tags to a detector, dataset, or alert.
Arguments
resource_arn: The resource's Amazon Resource Name (ARN).tags: Tags to apply to the resource. Tag keys and values can contain letters, numbers, spaces, and the following symbols: _.:/=+@-
Main.Lookoutmetrics.untag_resource — Method
untag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})Removes tags from a detector, dataset, or alert.
Arguments
resource_arn: The resource's Amazon Resource Name (ARN).tag_keys: Keys to remove from the resource's tags.
Main.Lookoutmetrics.update_alert — Method
update_alert(alert_arn)
update_alert(alert_arn, params::Dict{String,<:Any})Make changes to an existing alert.
Arguments
alert_arn: The ARN of the alert to update.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"Action": Action that will be triggered when there is an alert."AlertDescription": A description of the alert."AlertFilters": The configuration of the alert filters, containing MetricList and DimensionFilterList."AlertSensitivityThreshold": An integer from 0 to 100 specifying the alert sensitivity threshold.
Main.Lookoutmetrics.update_anomaly_detector — Method
update_anomaly_detector(anomaly_detector_arn)
update_anomaly_detector(anomaly_detector_arn, params::Dict{String,<:Any})Updates a detector. After activation, you can only change a detector's ingestion delay and description.
Arguments
anomaly_detector_arn: The ARN of the detector to update.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"AnomalyDetectorConfig": Contains information about the configuration to which the detector will be updated."AnomalyDetectorDescription": The updated detector description."KmsKeyArn": The Amazon Resource Name (ARN) of an AWS KMS encryption key.
Main.Lookoutmetrics.update_metric_set — Method
update_metric_set(metric_set_arn)
update_metric_set(metric_set_arn, params::Dict{String,<:Any})Updates a dataset.
Arguments
metric_set_arn: The ARN of the dataset to update.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}. Valid keys are:
"DimensionFilterList": Describes a list of filters for choosing specific dimensions and specific values. Each filter consists of the dimension and one of its values that you want to include. When multiple dimensions or values are specified, the dimensions are joined with an AND operation and the values are joined with an OR operation."DimensionList": The dimension list."MetricList": The metric list."MetricSetDescription": The dataset's description."MetricSetFrequency": The dataset's interval."MetricSource":"Offset": After an interval ends, the amount of seconds that the detector waits before importing data. Offset is only supported for S3, Redshift, Athena and datasources."TimestampColumn": The timestamp column.