摘要：
通过最佳实践内容arms，您可以看到arms openapi可以灵活地集成到客户链接监控场景arms中，并直观地显示监控信息。1.arm real service使您能够实时监控整... 通过最佳实践内容arms，您可以看到arms openapi可以灵活地集成到客户链接监控场景arms中，并直观地显示监控信息。
1.arm real service使您能够实时监控整个应用程序的性能，从而使您能够实时跟踪应用程序的性能。
此最佳实践是以调用arms openapi的形式实现客户应用场景链接监控的可视化图形显示。使用环境是private cloud v3，版本10的ascm控制台调用arms openapi接口，并通过工具postman进行测试。第二章详细介绍了测试环境和测试工具。第三章通过查询所有应用程序arms openapi接口来描述调用过程，并包含接口需要请求的参数接口列表。最后一章将使用armsopen api接口获取复杂应用场景的链接监控信息，并详细介绍每个接口的列表字段、调用过程和返回结果。
最佳实践价值
通过在应用场景中调用arms openapi，读者可以直观地了解arms产品的功能，arms提供了一套openapi，可以轻松集成到客户应用中，快速实现复杂的微服务链路监控功能。arms的监控服务能力涵盖了广泛的功能，包括浏览器、小应用程序、应用程序、分布式应用程序和容器环境，因此完整的监控能力，不需要在开发过程中集成多个开源组件，这使得微服务程序监控功能的开发变得简单，应用程序的操作和维护也变得容易。
2.在使用arms之前，您需要根据以下内容检查当前的系统环境。
此最佳实践基于vpc enterprise v3 10.0版本的arms。
注：arms openapi的版本变化不大，用法一致，因此本文档也适用于公有云产品或私有云v3 7.0或以上版本。vpc v3 10.0控制台称为ascm，10.0之前的v3 apsara stack。
1.登录ascm控制台。
2.将鼠标指向页面顶部导航栏中的产品，然后单击企业分布式应用程序服务edas。
图1：ASCM
注：由于arms的监控应用数据，需要edas产品的配合。该测试首先通过edas部署标准spring boot应用程序，打开arms监控并获取监控数据。
图 2：EDAS控制台
图 3：ARMS控制台
3.测试工具的检查。
这种做法将在vpc环境中创建win64虚拟机，然后在虚拟机中安装postman进行测试。
图4：Postman测试
3.openapi使用调用url进行确认
openapi接口都是rest服务。首先确认服务的url。每个vpc环境的不同域名将导致不同的url。请根据具体环境信息修改url信息，前缀和端口保持不变。http://arms.console.example.com:8099/
名称
界面
数据集api
/数据集/通用查询。json
关键应用程序性能指标
/公制/公制。json
报警信息
没有什么
应用程序监视-应用程序拓扑
/追踪/依赖。json
事件集
/事件集/事件列表。json
呼叫示例-查看所有应用程序：
api说明
网址：http://arms.console.example.com:8099/trace/services.json
参数列表
字段名
字段类型
场意义
必修的
评论
_用户id
一串
用户id
对
用户名（例如arms_admin）
返回格式示例
把单词放在句尾的最好方法之一是单词中的单词。代码也是单词中的单词。数据也是单词中的单词。其中一个艰难的方法就是跟随时代的潮流这个单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词的单词单词的单词的单词的单词的单词的单词的单词的单词；字符串"；//应用名称}]，"；服务"；：[//应用程序名称列表"；字符串"；，"；字符串"；]" 成功"；：true}邮递员呼叫结果
参数设置：userid=121827433423****
图5：Postman调用结果
4.应用描述从arms获取应用拓扑数据、图形和应用监控索引数据，并通过大屏幕datav显示。
图6：DataV展示
5.通过/metric/metric查询接口调用数json接口获取与应用程序相关的性能数据并查询接口调用数。
api说明
网址：http://arms.console.example.com:8099/metric/metric.json接口描述：字段名
字段类型
场意义
必修的
评论
开始时间
长的
查询数据的开始时间
对
没有什么
结束时间
长的
查询数据的截止日期
对
没有什么
intervalinsec
整数
时间间隔
不
建议填写
米制的
一串
公制字段
对
详细填写参考参数并填写演示
过滤器
列表[字符串]
过滤场
对
详细填写参考参数并填写演示
措施
列表[字符串]
指数
对
详细填写参考参数并填写演示
尺寸
列表[字符串]
维
对
详细填写参考参数并填写演示
排序子句
一串
排序字段
不
没有什么
顺序
一串
分类
不
默认无排序（asc或desc）
限度
整数
返回号码
不
没有什么
_用户id
一串
用户id
对
用户名（例如arms_admin）
举个例子
查询过去7天内指定应用程序的接口调用数
参数填充演示：
字段名
字段类型
场意义
强制性的
示例值
价值来源
开始时间
长的
查询数据的开始时间
对
一兆五千七百八十一亿九千九百三十一万九千八百九十八
系统时间
结束时间
长的
查询数据的截止日期
对
一兆五千七百八十八亿零四百一十一万九千八百九十八
系统时间
intervalinsec
整数
时间间隔
不
默认值为3600秒或1小时
手动设置
米制的
一串
metric字段，查询的指示符
对
appstat。细节
手动设置
过滤器
列表[字符串]
严格按照格式过滤字段，否则调用将出错
对
[{key=pid，value=1218274334230390@db61f75c2f******}，{key=regionid，value=cn-******-d01}]
pid和regionid来自专有网络环境
措施
列表[字符串]
指数
对
[rt、计数、错误、错误率]
api文档
尺寸
列表[字符串]
维
对
[pid、rpctype、rootip]
api文档
排序子句
一串
排序字段
不
没有什么
没有什么
顺序
一串
分类
不
默认无排序（asc或desc）
没有什么
限度
整数
返回号码
不
没有什么
没有什么
_用户id
一串
用户id
对
121827433423****
没有什么
查询结果
参数设置：
图7：参数设置
结果描述：
返回的结果是json数据集。数据集指示查询状态。如果成功，则返回200。如果失败，将返回相应的错误代码和错误原因。典型错误，例如缺少必要的参数、身份验证错误等（因为filters参数不是按照格式要求编写的）。openapi返回的结果集组织与查询数据的开始时间、结束时间和数据间隔有关。该查询查询了过去7天的数据，数据间隔设置为24小时，因此在该结果集中返回七个“数据”集。每个数据都包括“度量”和“维度”中指定的查询。以这个结果集为例，它包括：count:0.0pid:rpcdesc:http条目rpctype:0（http调用）。调整查询的开始、结束和间隔将影响数据的数量。调整接口查询参数将影响每个数据中的数据。如果需要计算一些聚合值，例如过去7天内http调用的总数，则需要计算并添加多个数据以获得结果。6.通过/metric/metric查询异常数json接口获取与应用程序相关的性能数据并查询异常数。
api说明
网址：http://arms.console.example.com:8099/metric/metric.json接口描述：字段名
字段类型
场意义
必修的
评论
开始时间
长的
查询数据的开始时间
对
没有什么
结束时间
长的
查询数据的截止日期
对
没有什么
intervalinsec
整数
时间间隔
不
建议填写
米制的
一串
公制字段
对
有关详细信息，请参阅以下内容
过滤器
列表[字符串]
过滤场
对
有关详细信息，请参阅以下内容
措施
列表[字符串]
指数
对
有关详细信息，请参阅以下内容
尺寸
列表[字符串]
维
对
请参考以下f
