Amazon SDK for JavaScriptV3 API 参考指南详细描述了Amazon SDK for JavaScript版本 3 (V3) 的所有 API 操作。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CloudWatch 使用适用于 JavaScript V3 的 SDK 的示
以下代码示例向您展示如何通过Amazon SDK for JavaScript V3 执行操作和实施常见场景 CloudWatch。
操作是展示如何调用具体服务函数的代码节选。
场景是展示如何通过在同一服务中调用多个函数来完成特定任务的代码示例。
每个示例都包含一个链接 GitHub,其中包含了有关如何在上下文中设置和运行代码的说明。
主题
操作
以下代码示例显示如何创建或更新 Amazon CloudWatch 警报并将其与指定指标、指标数学表达式、异常检测模型或 Metrics Insights 查询关联起来。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { PutMetricAlarmCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; const run = async () => { // This alarm triggers when CPUUtilization exceeds 70% for one minute. const command = new PutMetricAlarmCommand({ AlarmName: process.env.CLOUDWATCH_ALARM_NAME, // Set the value of CLOUDWATCH_ALARM_NAME to the name of an existing alarm. ComparisonOperator: "GreaterThanThreshold", EvaluationPeriods: 1, MetricName: "CPUUtilization", Namespace: "AWS/EC2", Period: 60, Statistic: "Average", Threshold: 70.0, ActionsEnabled: false, AlarmDescription: "Alarm when server CPU exceeds 70%", Dimensions: [ { Name: "InstanceId", Value: process.env.EC2_INSTANCE_ID, // Set the value of EC_INSTANCE_ID to the Id of an existing Amazon EC2 instance. }, ], Unit: "Percent", }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 PutMetricAlarmAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。查找完整示例,学习如何在 Amazon 代码示例存储库
中进行设置和运行。 // Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); var params = { AlarmName: 'Web_Server_CPU_Utilization', ComparisonOperator: 'GreaterThanThreshold', EvaluationPeriods: 1, MetricName: 'CPUUtilization', Namespace: 'AWS/EC2', Period: 60, Statistic: 'Average', Threshold: 70.0, ActionsEnabled: false, AlarmDescription: 'Alarm when server CPU exceeds 70%', Dimensions: [ { Name: 'InstanceId', Value: 'INSTANCE_ID' }, ], Unit: 'Percent' }; cw.putMetricAlarm(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 PutMetricAlarmAmazon SDK for JavaScriptAPI 参考中的。
-
以下代码示例显示如何删除 Amazon CloudWatch 告警的方式。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { DeleteAlarmsCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; const run = async () => { const command = new DeleteAlarmsCommand({ AlarmNames: [process.env.CLOUDWATCH_ALARM_NAME], // Set the value of CLOUDWATCH_ALARM_NAME to the name of an existing alarm. }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 DeleteAlarmsAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。在 Amazon 代码示例存储库
中查找完整示例,了解如何进行设置和运行。 导入软件开发工具包和客户端模块,然后调用 API。
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); var params = { AlarmNames: ['Web_Server_CPU_Utilization'] }; cw.deleteAlarms(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 DeleteAlarmsAmazon SDK for JavaScriptAPI 参考中的。
-
以下代码示例显示如何描述指标的 Amazon CloudWatch 告警。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { DescribeAlarmsCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; const run = async () => { const command = new DescribeAlarmsCommand({ AlarmNames: [process.env.CLOUDWATCH_ALARM_NAME], // Set the value of CLOUDWATCH_ALARM_NAME to the name of an existing alarm. }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 DescribeAlarmsForMetricAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。查找完整示例,学习如何在 Amazon 代码示例存储库
中进行设置和运行。 // Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); cw.describeAlarms({StateValue: 'INSUFFICIENT_DATA'}, function(err, data) { if (err) { console.log("Error", err); } else { // List the names of all current alarms in the console data.MetricAlarms.forEach(function (item, index, array) { console.log(item.AlarmName); }); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 DescribeAlarmsForMetricAmazon SDK for JavaScriptAPI 参考中的。
-
以下代码示例显示如何禁用 Amazon CloudWatch 告警的操作。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { DisableAlarmActionsCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; const run = async () => { const command = new DisableAlarmActionsCommand({ AlarmNames: process.env.CLOUDWATCH_ALARM_NAME, // Set the value of CLOUDWATCH_ALARM_NAME to the name of an existing alarm. }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 DisableAlarmActionsAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。在 Amazon 代码示例存储库
中查找完整示例,了解如何进行设置和运行。 导入软件开发工具包和客户端模块,然后调用 API。
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); cw.disableAlarmActions({AlarmNames: ['Web_Server_CPU_Utilization']}, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 DisableAlarmActionsAmazon SDK for JavaScriptAPI 参考中的。
-
以下代码示例显示如何启用 Amazon CloudWatch 告警的操作。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { EnableAlarmActionsCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; const run = async () => { const command = new EnableAlarmActionsCommand({ AlarmNames: [process.env.CLOUDWATCH_ALARM_NAME], // Set the value of CLOUDWATCH_ALARM_NAME to the name of an existing alarm. }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 EnableAlarmActionsAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。在 Amazon 代码示例存储库
中查找完整示例,了解如何进行设置和运行。 导入软件开发工具包和客户端模块,然后调用 API。
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); var params = { AlarmName: 'Web_Server_CPU_Utilization', ComparisonOperator: 'GreaterThanThreshold', EvaluationPeriods: 1, MetricName: 'CPUUtilization', Namespace: 'AWS/EC2', Period: 60, Statistic: 'Average', Threshold: 70.0, ActionsEnabled: true, AlarmActions: ['ACTION_ARN'], AlarmDescription: 'Alarm when server CPU exceeds 70%', Dimensions: [ { Name: 'InstanceId', Value: 'INSTANCE_ID' }, ], Unit: 'Percent' }; cw.putMetricAlarm(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Alarm action added", data); var paramsEnableAlarmAction = { AlarmNames: [params.AlarmName] }; cw.enableAlarmActions(paramsEnableAlarmAction, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Alarm action enabled", data); } }); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 EnableAlarmActionsAmazon SDK for JavaScriptAPI 参考中的。
-
以下代码示例显示如何列出 Amazon CloudWatch 指标的元数据。要获取指标的数据,请使用 GetMetricData 或 GetMetricStatistics 操作。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { ListMetricsCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; export const run = async () => { // Use the AWS console to see available namespaces and metric names. Custom metrics can also be created. // https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html const command = new ListMetricsCommand({ Dimensions: [ { Name: "LogGroupName", }, ], MetricName: "IncomingLogEvents", Namespace: "AWS/Logs", }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 ListMetricsAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。查找完整示例,学习如何在 Amazon 代码示例存储库
中进行设置和运行。 // Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); var params = { Dimensions: [ { Name: 'LogGroupName', /* required */ }, ], MetricName: 'IncomingLogEvents', Namespace: 'AWS/Logs' }; cw.listMetrics(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Metrics", JSON.stringify(data.Metrics)); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 ListMetricsAmazon SDK for JavaScriptAPI 参考中的。
-
以下代码示例显示如何向亚马逊发布指标数据点 CloudWatch。
- 适用于 PK f JavaScript or
-
注意
还有更多 GitHub。查找完整示例,了解如何在Amazon 代码示例存储库
中进行设置和运行。 在单独的模块中创建客户端并将其导出。
import { CloudWatchClient } from "@aws-sdk/client-cloudwatch"; import { DEFAULT_REGION } from "libs/utils/util-aws-sdk.js"; export const client = new CloudWatchClient({ region: DEFAULT_REGION });
导入软件开发工具包和客户端模块,然后调用 API。
import { PutMetricDataCommand } from "@aws-sdk/client-cloudwatch"; import { client } from "../libs/client.js"; const run = async () => { // See https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html#API_PutMetricData_RequestParameters // and https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html // for more information about the parameters in this command. const command = new PutMetricDataCommand({ MetricData: [ { MetricName: "PAGES_VISITED", Dimensions: [ { Name: "UNIQUE_PAGES", Value: "URLS", }, ], Unit: "None", Value: 1.0, }, ], Namespace: "SITE/TRAFFIC", }); try { return await client.send(command); } catch (err) { console.error(err); } }; export default run();
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 PutMetricDataAmazon SDK for JavaScriptAPI 参考中的。
-
- 适用于 JavaScript V3 的开发工具包
-
注意
还有更多 GitHub。查找完整示例,学习如何在 Amazon 代码示例存储库
中进行设置和运行。 // Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Set the region AWS.config.update({region: 'REGION'}); // Create CloudWatch service object var cw = new AWS.CloudWatch({apiVersion: '2010-08-01'}); // Create parameters JSON for putMetricData var params = { MetricData: [ { MetricName: 'PAGES_VISITED', Dimensions: [ { Name: 'UNIQUE_PAGES', Value: 'URLS' }, ], Unit: 'None', Value: 1.0 }, ], Namespace: 'SITE/TRAFFIC' }; cw.putMetricData(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", JSON.stringify(data)); } });
-
有关更多信息,请参阅 Amazon SDK for JavaScript 开发人员指南。
-
有关 API 的详细信息,请参阅 PutMetricDataAmazon SDK for JavaScriptAPI 参考中的。
-