文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `DescribeAnomalyDetectors` 搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 `DescribeAnomalyDetectors`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](cloudwatch_example_cloudwatch_GetStartedMetricsDashboardsAlarms_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK (v4)**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/CloudWatch#code-examples)中設定和執行。
```
///
/// Describe anomaly detectors for a metric and namespace.
///
/// The namespace of the metric.
/// The metric of the anomaly detectors.
/// The list of detectors.
public async Task> DescribeAnomalyDetectors(string metricNamespace, string metricName)
{
List detectors = new List();
var paginatedDescribeAnomalyDetectors = _amazonCloudWatch.Paginators.DescribeAnomalyDetectors(
new DescribeAnomalyDetectorsRequest()
{
MetricName = metricName,
Namespace = metricNamespace
});
await foreach (var data in paginatedDescribeAnomalyDetectors.AnomalyDetectors)
{
detectors.Add(data);
}
return detectors;
}
```
+ 如需 API 詳細資訊，請參閱*適用於 .NET 的 AWS SDK API 參考*中的 [DescribeAnomalyDetectors](https://docs.aws.amazon.com/goto/DotNetSDKV4/monitoring-2010-08-01/DescribeAnomalyDetectors)。
------
#### [ CLI ]
**AWS CLI**
**擷取異常偵測模型的清單**
下列 `describe-anomaly-detectors` 範例顯示與指定帳戶中 `AWS/Logs` 命名空間相關聯的異常偵測器模型相關資訊。
```
aws cloudwatch describe-anomaly-detectors \
--namespace AWS/Logs
```
輸出：
```
{
"AnomalyDetectors": [
{
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [],
"Stat": "SampleCount",
"Configuration": {
"ExcludedTimeRanges": []
},
"StateValue": "TRAINED",
"SingleMetricAnomalyDetector": {
"AccountId": "123456789012",
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [],
"Stat": "SampleCount"
}
},
{
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [
{
"Name": "LogGroupName",
"Value": "demo"
}
],
"Stat": "Average",
"Configuration": {
"ExcludedTimeRanges": []
},
"StateValue": "PENDING_TRAINING",
"SingleMetricAnomalyDetector": {
"AccountId": "123456789012",
"Namespace": "AWS/Logs",
"MetricName": "IncomingBytes",
"Dimensions": [
{
"Name": "LogGroupName",
"Value": "demo"
}
],
"Stat": "Average"
}
}
]
}
```
如需詳細資訊，請參閱*《Amazon CloudWatch 使用者指南》*中的[使用 CloudWatch 異常偵測](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeAnomalyDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-anomaly-detectors.html)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/cloudwatch#code-examples)中設定和執行。
```
/**
* Describes the anomaly detectors based on the specified JSON file.
*
* @param fileName the name of the JSON file containing the custom metric namespace and name
* @return a {@link CompletableFuture} that completes when the anomaly detectors have been described
* @throws RuntimeException if there is a failure during the operation, such as when reading or parsing the JSON file,
* or when describing the anomaly detectors
*/
public CompletableFuture describeAnomalyDetectorsAsync(String fileName) {
CompletableFuture readFileFuture = CompletableFuture.supplyAsync(() -> {
try {
JsonParser parser = new JsonFactory().createParser(new File(fileName));
return new ObjectMapper().readTree(parser);
} catch (IOException e) {
throw new RuntimeException("Failed to read or parse the file", e);
}
});
return readFileFuture.thenCompose(rootNode -> {
try {
String customMetricNamespace = rootNode.findValue("customMetricNamespace").asText();
String customMetricName = rootNode.findValue("customMetricName").asText();
DescribeAnomalyDetectorsRequest detectorsRequest = DescribeAnomalyDetectorsRequest.builder()
.maxResults(10)
.metricName(customMetricName)
.namespace(customMetricNamespace)
.build();
return getAsyncClient().describeAnomalyDetectors(detectorsRequest).thenAccept(response -> {
List anomalyDetectorList = response.anomalyDetectors();
for (AnomalyDetector detector : anomalyDetectorList) {
logger.info("Metric name: {} ", detector.singleMetricAnomalyDetector().metricName());
logger.info("State: {} ", detector.stateValue());
}
});
} catch (RuntimeException e) {
throw new RuntimeException("Failed to describe anomaly detectors", e);
}
}).whenComplete((result, exception) -> {
if (exception != null) {
throw new RuntimeException("Error describing anomaly detectors", exception);
}
});
}
```
+ 如需 API 詳細資訊，請參閱*AWS SDK for Java 2.x API 參考*中的 [DescribeAnomalyDetectors](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/DescribeAnomalyDetectors)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/cloudwatch#code-examples)中設定和執行。
```
suspend fun describeAnomalyDetectors(fileName: String) {
// Read values from the JSON file.
val parser = JsonFactory().createParser(File(fileName))
val rootNode = ObjectMapper().readTree(parser)
val customMetricNamespace = rootNode.findValue("customMetricNamespace").asText()
val customMetricName = rootNode.findValue("customMetricName").asText()
val detectorsRequest =
DescribeAnomalyDetectorsRequest {
maxResults = 10
metricName = customMetricName
namespace = customMetricNamespace
}
CloudWatchClient.fromEnvironment { region = "us-east-1" }.use { cwClient ->
val response = cwClient.describeAnomalyDetectors(detectorsRequest)
response.anomalyDetectors?.forEach { detector ->
println("Metric name: ${detector.singleMetricAnomalyDetector?.metricName}")
println("State: ${detector.stateValue}")
}
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考**》中的 [DescribeAnomalyDetectors](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------