AWS Systems Manager Run Command
采集 AWS Systems Manager Run Command 指标数据
配置¶
安装 Func¶
推荐开通 观测云集成 - 扩展 - 托管版 Func: 一切前置条件都自动安装好, 请继续脚本安装
如果自行部署 Func 参考自行部署 Func
安装脚本¶
提示:请提前准备好符合要求的亚马逊 AK(简单起见,可直接授予全局只读权限
ReadOnlyAccess)
-
登陆Func 控制台,点击【脚本市场】,进入观测云脚本市场,搜索:
integration_aws_ssm_run_command -
点击【安装】后,输入相应的参数:AWS AK ID 、AK Secret 及账户名。
-
点击【部署启动脚本】,系统会自动创建
Startup脚本集,并自动配置相应的启动脚本。 -
开启后可以在「管理 / 自动触发配置」里看到对应的自动触发配置。点击【执行】,即可立即执行一次,无需等待定期时间。稍等片刻,可以查看执行任务记录以及对应日志。
验证¶
- 在「管理 / 自动触发配置」确认对应的任务是否已存在对应的自动触发配置,同时可以查看对应任务记录及日志检查是否有异常
- 在观测云,「基础设施 - 资源目录」中查看是否存在资产信息
- 在观测云,「指标」查看是否有对应监控数据
指标¶
配置亚马逊-云监控,可以通过配置的方式采集更多的指标 亚马逊云监控指标详情
AWS Systems Manager Run Command 指标在 aws_ssm_run_command 指标集下,描述列包括每个指标的描述以及单位和统计数据。
| 指标 | 描述 | 单位 |
|---|---|---|
CommandsDeliveryTimedOut |
终端状态为 Delivery Timed Out 的命令的数量 | count |
CommandsFailed |
终端状态为 Failed 的命令的数量 | count |
CommandsSucceeded |
终端状态为 Success 的命令的数量 | count |
对象¶
采集到的 AWS Systems Manager Run Command 对象数据结构, 可以从「基础设施 - 资源目录」里看到对象数据
{
"measurement": "aws_ssm_run_command",
"tags": {
"command_id" : "91d10100-89c4-4077-a2ce-89fb90d1f566",
"document_name" : "AWS-RunShellScript",
"RegionId" : "ap-southeast-1"
},
"fields": {
"document_version" : "1",
"expires_after" : "2025-08-05T14:14:19.774000+08:00",
"parameters" : "{[命令文档]}",
"instance_ids" : "xxxx-0b8b6fee9ef5426d7",
"targets" : "{[Json 数据]}",
"requested_date_time" : "2025-08-05T13:04:19.774000+08:00",
"status" : "Success",
"status_details" : "Success",
"cloud_watch_output_config" : "{}",
"alarm_configuration" : "{}",
"triggered_alarms" : "[]",
"timeout_seconds" : "600",
"output_s_3_region" : "ap-southeast-1"
}
}
注意:
tags、fields中的字段可能会随后续更新有所变动