4.2 执行结果
4.3.2 查询正在运行 execution 各 Job 监控数据
get_running_execution_resource_usage(execution_id, show_datapoints=False)
功能描述
获取正在执行状态execution的监控数据,包括CPU和内存使用情况。
输入参数
参数 是否
必选 参数
类型 参数描述
execution_id 是 String execution ID
参数 是否 必选
参数 类型
参数描述
show_datapoints 否 Bool 是否展示采集到的监控数据点
返回值
表
4-14 response body 字典树第 1 层 key 值
参数 参数类型 描述
job-name Array 流程中各Job的名称,具体
内容见表4-9
表
4-15 response body 字典树各 Job 元素 key 值
参数 参数类型 描述
metric Dictionary 监控元信息,具体内容见
表4-10
max_value_metric Dictionary 各监控数据点最大值 min_value_metric Dictionary 各监控数据点最小值 average_value_metric Float 各监控数据点平均值 current_value_metric Dictionary 最近一次采集到的监控数
据点
dataPoints Array 当show_datapoints置为 True时,该字段展示所有 监控数据点详情
表
4-16 监控元信息
参数 参数类型 描述
namespace String 默认值
“PAAS.CONTAINER”
存量,单位为M
● cpuCoreLimit:CPU核 数申请量,单位为Core
● cpuUsage:CPU使用 量所占百分比
● memUsage:内存使用 量所占百分比
● memCapacity:内存容 量,单位为M
● cpuCoreUsed:已使用 CPU核数,单位为Core
dimensions Array 监控维度说明,具体内容
见表4-11
表
4-17 监控维度说明
参数 参数类型 描述
name String 监控维度项,默认为以下2
项:
● clusterId,集群ID,默 认为“CCI-ClusterID”
● podID,CCI中Pod ID
value String 监控维度值
表
4-18 监控数据结构体
参数 参数类型 描述
timestamps Long 监控数据获取时刻时间戳
unit String 监控数据单位
statistics Array 监控数据详情,具体内容
见表4-13
表
4-19 监控数据详情
参数 参数类型 描述
statistic String 统计学方法,支持
maximum,average,
minimum
value Float 监控数据值
5 Response 对象使用方法
使用GCS客户端调用成功后均会返回 SDK公共结果对象requests.Response,若调用失 败,则抛出异常,可参考通用示例从SDK公共结果对象中获取HTTP状态码及返回内 容,进一步判断错误详情。
用户可以通过Response.json()方法获取服务返回的json内容,通过Response.text 获取 返回信息。下面返回值为通过Response.text获得的内容。
表1中展示了Response中常用的字段和方法,Response中的字段和方法还有很多,用 户可以自行查阅requests包里的Response结构进行查看
表
5-1 requests.Response
字段或方法 说明
content 以二进制(bytes)方式返回的响应内容。
encoding 获取text属性时采用的解码方式。
headers 以小写方式返回响应headers。
json(**kwargs) 将返回结果以json格式读入,即调用json.loads读取返回 体,最终返回一个字典。如果返回体非json格式,则会抛 出ValueError。
kwargs为调用json.loads传入的可选参数。
ok 如果响应码小于400,则返回True。
status_code 请求的响应码,例如404 or 200。
text 返回内容解码后的文本,以unicode的方式表示文本内
容。
即按照Response.encoding中的编码方式来解码 Response.content中的内容,若Response.encoding为 空,则根据返回内容推断编码方式进行解码。
6 异常抛出
执行请求失败会抛出异常,异常类型如表1所示,进一步查看实现可以参阅requests 包:
表
6-1 异常列表
异常类型 异常说明
requests.RequestExceptio
n(*args, **kwargs) 该异常未所有异常的基类,但错误异常不明确无法分 类到具体的异常时返回此异常。
requests.ConnectionError(*
args, **kwargs) 遇到网络问题(如:DNS 查询失败、拒绝连接等)。
requests.HTTPError(*args,
**kwargs) HTTP 请求返回了不成功的状态码。
requests.URLRequired(*arg
s, **kwargs) 请求的URL非法。
requests.TooManyRedirect
s(*args, **kwargs) 请求超过了设定的最大重定向次数。
requests.ConnectTimeout(*
args, **kwargs) 连接服务器超时。
requests.ReadTimeout(*arg
s, **kwargs) 连接成功后读取超时。
requests.Timeout(*args,
**kwargs) 请求超时,包括ConnetTimeout和ReadTimeout。