
# HttpClient监控
介绍APM采集的HttpClient监控指标的类别、名称、含义等信息。
表1HttpClient监控采集参数 
| 参数名              | 数据类型      | 应用类型 | 默认值 | Agent支持的起始版本 | Agent支持的终止版本 | 描述                                                                                        |
|:---|:---|:---|:---|:---|:---|:---|
| url规整配置          | obj_array | JAVA | -   | 2.0.0        | -            | 根据url规整配置,将一些restful风格的url进行规整。规整方式包含：startwith、endwith、include以及regex四种方式。               |
| httpclient最大采集行数 | integer   | JAVA | 500 | 2.4.1        | -            | httpclient最大采集行数                                                                          |
| 采集黑名单配置          | obj_array | JAVA | -   | 2.5.6        | -            | 指定规则匹配的url不采集，匹配方式包含： startwith、endwith、include以及regex四种方式。 |
   
表2HttpClient监控指标说明 
| 指标类别                                                | 指标                 | 指标名称               | 指标说明                    | 单位 | 数据类型   | 默认聚合方式 |
|:---|:---|:---|:---|:---|:---|:---|
| 异常（exception，httpclient调用的异常信息统计。）                  | exceptionType      | 异常类型               | 异常类型                    | -  | ENUM   | LAST   |
| 异常（exception，httpclient调用的异常信息统计。）                  | count              | 次数                 | 该异常的发生次数                | -  | INT    | SUM    |
| 异常（exception，httpclient调用的异常信息统计。）                  | message            | 异常消息               | 该异常产生的异常消息              | -  | STRING | LAST   |
| 异常（exception，httpclient调用的异常信息统计。）                  | stackTrace         | 异常堆栈               | 该异常产生的堆栈信息              | -  | CLOB   | LAST   |
| 异常（exception，httpclient调用的异常信息统计。）                  | causeType          | 异常类                | 发生异常的类                  | -  | ENUM   | LAST   |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | envId              | 集群id               | 被调用方的集群id               | -  | ENUM   | LAST   |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | hostUri            | 调用地址               | 被调用的地址                  | -  | STRING | LAST   |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | errorCount         | 错误次数               | 调用该集群url发生的错误次数         | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | invokeCount        | 调用次数               | 调用该集群url的调用次数           | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | maxTime            | 最大响应时间             | 调用该集群url的最大响应时间         | ms | INT    | MAX    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | totalTime          | 总响应时间              | 调用该集群url的总响应时间          | ms | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | responseCloseCount | 关闭响应数              | 调用该集群url的关闭响应数          | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | range1             | 0-10ms             | 响应时间在0-10ms范围请求数        | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | range2             | 10-100ms           | 响应时间在10-100ms范围请求数      | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | range3             | 100-500ms          | 响应时间在100-500ms范围请求数     | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | range4             | 500-1000ms         | 响应时间在500-1000ms范围请求数    | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | range5             | 1-10s              | 响应时间在1-10s范围请求数         | -  | INT    | SUM    |
| 集群指标（hostInvocation，根据被调用方的集群维度统计httpclient接口调用信息。） | range6             | 10s以上              | 响应时间在10s以上请求数           | -  | INT    | SUM    |
| httpclient版本（info ，httpclient的包版本信息统计。）             | httpClientVersion  | httpclient版本       | httpclient包的版本          | -  | STRING | LAST   |
| httpclient版本（info ，httpclient的包版本信息统计。）             | httpCoreVersion    | httpCore版本         | httpCore包的版本            | -  | STRING | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | url                | url                | 被调用url                  | -  | ENUM   | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | method             | httpmethod         | url的httpmethod          | -  | ENUM   | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | client             | 客户端类型              | httpclient客户端的类型        | -  | ENUM   | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | concurrentMax      | 最大并发               | 被调用url的最大并发             | -  | INT    | MAX    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | errorCount         | 错误次数               | 被调用url的错误次数             | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | errorTraceId       | 错误traceId          | 采集周期内发生错误的调用链对应的traceid | -  | STRING | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | slowTraceId        | 慢TraceId           | 采集周期内最慢的调用链对应的traceid   | -  | STRING | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | hostUri            | 调用地址               | 被调用url的调用地址             | -  | STRING | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | invokeCount        | 调用次数               | 被调用url的调用次数             | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | lastError          | 错误信息               | url发生错误时产生的错误信息         | -  | STRING | LAST   |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | maxTime            | 最大响应时间             | 被调用url的最大响应时间           | ms | INT    | MAX    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | responseCloseCount | responseCloseCount | 被调用url的关闭响应数            | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | totalTime          | 总响应时间              | 被调用url的总响应时间            | ms | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | range1             | 0-10ms             | 响应时间在0-10ms范围请求数        | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | range2             | 10-100ms           | 响应时间在10-100ms范围请求数      | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | range3             | 100-500ms          | 响应时间在100-500ms范围请求数     | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | range4             | 500-1000ms         | 响应时间在500-1000ms范围请求数    | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | range5             | 1-10s              | 响应时间在1-10s范围请求数         | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | range6             | 10s以上              | 响应时间在10s以上请求数           | -  | INT    | SUM    |
| url监控（invocation，以被调用的url为维度统计接口调用信息。）              | envId              | 集群id               | 被调用的url对应的集群id          | -  | STRING | LAST   |
| httpclient汇总（total ，httpclient接口调用的汇总信息统计。）         | errorCount         | 错误次数               | 总的错误次数                  | -  | INT    | SUM    |
| httpclient汇总（total ，httpclient接口调用的汇总信息统计。）         | invokeCount        | 调用次数               | 总的调用次数                  | -  | INT    | SUM    |
| httpclient汇总（total ，httpclient接口调用的汇总信息统计。）         | responseCloseCount | 关闭响应数              | 总的关闭响应数                 | -  | INT    | SUM    |
| httpclient汇总（total ，httpclient接口调用的汇总信息统计。）         | totalTime          | 总响应时间              | 总响应时间                   | ms | INT    | SUM    |
| 状态码统计（code ，httpclient调用的异常信息统计。）                   | code               | 状态码                | 状态码                     | -  | ENUM   | LAST   |
| 状态码统计（code ，httpclient调用的异常信息统计。）                   | url                | url                | 产生对应状态码的url             | -  | STRING | LAST   |
| 状态码统计（code ，httpclient调用的异常信息统计。）                   | count              | 次数                 | 对应状态码的发生次数              | -  | INT    | SUM    |
   
