Lookoutmetrics
This page documents function available when using the Lookoutmetrics
module, created with @service Lookoutmetrics
.
Index
Main.Lookoutmetrics.activate_anomaly_detector
Main.Lookoutmetrics.back_test_anomaly_detector
Main.Lookoutmetrics.create_alert
Main.Lookoutmetrics.create_anomaly_detector
Main.Lookoutmetrics.create_metric_set
Main.Lookoutmetrics.deactivate_anomaly_detector
Main.Lookoutmetrics.delete_alert
Main.Lookoutmetrics.delete_anomaly_detector
Main.Lookoutmetrics.describe_alert
Main.Lookoutmetrics.describe_anomaly_detection_executions
Main.Lookoutmetrics.describe_anomaly_detector
Main.Lookoutmetrics.describe_metric_set
Main.Lookoutmetrics.detect_metric_set_config
Main.Lookoutmetrics.get_anomaly_group
Main.Lookoutmetrics.get_data_quality_metrics
Main.Lookoutmetrics.get_feedback
Main.Lookoutmetrics.get_sample_data
Main.Lookoutmetrics.list_alerts
Main.Lookoutmetrics.list_anomaly_detectors
Main.Lookoutmetrics.list_anomaly_group_related_metrics
Main.Lookoutmetrics.list_anomaly_group_summaries
Main.Lookoutmetrics.list_anomaly_group_time_series
Main.Lookoutmetrics.list_metric_sets
Main.Lookoutmetrics.list_tags_for_resource
Main.Lookoutmetrics.put_feedback
Main.Lookoutmetrics.tag_resource
Main.Lookoutmetrics.untag_resource
Main.Lookoutmetrics.update_alert
Main.Lookoutmetrics.update_anomaly_detector
Main.Lookoutmetrics.update_metric_set
Documentation
Main.Lookoutmetrics.activate_anomaly_detector
— Methodactivate_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
— Methodback_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
— Methodcreate_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
— Methodcreate_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
— Methodcreate_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
— Methoddeactivate_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
— Methoddelete_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
— Methoddelete_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
— Methoddescribe_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
— Methoddescribe_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
— Methoddescribe_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
— Methoddescribe_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
— Methoddetect_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
— Methodget_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
— Methodget_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
— Methodget_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
— Methodget_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
— Methodlist_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
— Methodlist_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
— Methodlist_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
— Methodlist_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
— Methodlist_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
— Methodlist_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
— Methodlist_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
— Methodput_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
— Methodtag_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
— Methoduntag_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
— Methodupdate_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
— Methodupdate_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
— Methodupdate_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.