
# URL监控
介绍APM采集的URL监控指标的类别、名称、含义等信息。
表1URL监控采集参数 
| 参数名            | 数据类型      | 应用类型 | 默认值   | Agent支持的起始版本 | Agent支持的终止版本 | 描述                                                                        |
|:---|:---|:---|:---|:---|:---|:---|
| 拦截header指定key值 | array     | JAVA | -     | 2.0.0        | -            | 拦截header中指定key值的内容。                                                       |
| 拦截url参数指定key值  | array     | JAVA | -     | 2.0.0        | -            | 拦截url参数指定key值的内容。                                                         |
| 拦截cookie指定key值 | array     | JAVA | -     | 2.0.0        | -            | 拦截cookie指定key值的内容。                                                        |
| url采集配置        | obj_array | JAVA | -     | 2.0.0        | -            | url采集配置，将restful风格url按配置进行规整。规整方式包含：startwith、endwith、include以及regex四种方式。 |
| 采集黑名单配置        | obj_array | JAVA | -     | 2.0.0        | -            | 指定规则匹配的url不采集,匹配方式包含：startwith、endwith、include以及regex四种方式。                |
| 业务code采集长度限制   | integer   | JAVA | 0     | 2.0.0        | -            | 解析业务code需要采集body内容的长度限制。                                                  |
| 解析业务code的key   | array     | JAVA | -     | 2.0.0        | -            | 解析json格式的body内容的key，获取业务状态码。                                              |
| 业务code的正确值     | array     | JAVA | -     | 2.0.0        | -            | 配置正确的业务状态码的值，业务状态码不在该范围的值定义为错误的调用链。                                       |
| 慢请求阈值定义        | integer   | JAVA | 800   | 2.0.0        | -            | 定义慢请求阈值,超过该阈值的url会定义为慢url，默认提高调用链采样率。                                     |
| url配置          | obj_array | JAVA | -     | 2.0.0        | -            | 单独配置每个url的慢请求阈值和采样率。采样方式包含：百分比采样、每分钟固定数量采样以及自动采样三种采样方式。                   |
| 错误状态码定义        | radio     | JAVA | 500   | 2.0.0        | -            | 设置统计为错误的状态码范围。                                                            |
| Url自动规整        | radio     | JAVA | false | 2.3.11       | -            | Url自动规整。                                                                  |
| url最大采集行数      | integer   | JAVA | 500   | 2.4.1        | -            | 允许url最大采集行数                                                               |
   
表2URL监控指标说明 
| 指标类别                                 | 指标               | 指标名称       | 指标说明                 | 单位 | 数据类型   | 默认聚合方式 |
|:---|:---|:---|:---|:---|:---|:---|
| 汇总（total ，url接口调用汇总统计数据。）            | errorCount       | 错误次数       | 总错误次数                | -  | INT    | SUM    |
| 汇总（total ，url接口调用汇总统计数据。）            | invokeCount      | 调用次数       | 总调用次数                | -  | INT    | SUM    |
| 汇总（total ，url接口调用汇总统计数据。）            | totalTime        | 总响应时间      | 总响应时间                | ms | INT    | SUM    |
| 汇总（total ，url接口调用汇总统计数据。）            | satisfiedCount   | 满意请求数      | 满意请求数                | -  | INT    | SUM    |
| 汇总（total ，url接口调用汇总统计数据。）            | toleratingCount  | 可容忍请求数     | 可容忍请求数               | -  | INT    | SUM    |
| 状态码（statuscode，以接口返回的状态码维度统计接口调用数据。） | code             | 状态码        | 状态码                  | -  | ENUM   | LAST   |
| 状态码（statuscode，以接口返回的状态码维度统计接口调用数据。） | count            | 调用次数       | 该状态码的发生次数            | -  | INT    | SUM    |
| 状态码（statuscode，以接口返回的状态码维度统计接口调用数据。） | url              | 采样url      | 该状态码在采集周内采样的url      | -  | STRING | LAST   |
| url监控（url，以url维度统计接口调用数据。）           | url              | url        | 请求的url               | -  | ENUM   | LAST   |
| url监控（url，以url维度统计接口调用数据。）           | method           | httpmethod | 请求的httpmethod        | -  | ENUM   | LAST   |
| url监控（url，以url维度统计接口调用数据。）           | concurrentMax    | 最大并发       | 该url的最大并发            | -  | INT    | MAX    |
| url监控（url，以url维度统计接口调用数据。）           | errorCount       | 错误数        | 该url的错误数             | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | invokeCount      | 调用次数       | 该url的调用次数            | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | lastError        | 错误信息       | 该url发生错误时产生的错误信息     | -  | STRING | LAST   |
| url监控（url，以url维度统计接口调用数据。）           | maxTime          | 最大响应时间     | 该url在采集周期内最大响应时间     | ms | INT    | MAX    |
| url监控（url，以url维度统计接口调用数据。）           | maxTimeNativeUrl | 最慢url      | 该url在采集周期内最慢url      | -  | STRING | LAST   |
| url监控（url，以url维度统计接口调用数据。）           | runningCount     | 正在执行数      | 该url在采集时间点正在执行数量     | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | range1           | 0-10ms     | 响应时间在0-10ms范围请求数     | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | range2           | 10-100ms   | 响应时间在10-100ms范围请求数   | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | range3           | 100-500ms  | 响应时间在100-500ms范围请求数  | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | range4           | 500-1000ms | 响应时间在500-1000ms范围请求数 | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | range5           | 1-10s      | 响应时间在1-10s范围请求数      | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | range6           | 10s以上      | 响应时间在10s以上请求数        | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | totalTime        | 总响应时间      | 该url的总响应时间           | ms | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | isRoot           | 是否根调用      | 是否是根调用               | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | satisfiedCount   | 满意请求数      | 满意请求数                | -  | INT    | SUM    |
| url监控（url，以url维度统计接口调用数据。）           | toleratingCount  | 可容忍请求数     | 可容忍请求数               | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | clusterId        | 集群id       | 调用方的集群id             | -  | ENUM   | LAST   |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | invokeCount      | 调用次数       | 该集群的调用次数             | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | total1xxCount    | 1xx次数      | 状态码为1xx的调用次数         | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | total2xxCount    | 2xx次数      | 状态码为2xx的调用次数         | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | total3xxCount    | 3xx次数      | 状态码为3xx的调用次数         | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | total4xxCount    | 4xx次数      | 状态码为4xx的调用次数         | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | total5xxCount    | 5xx次数      | 状态码为5xx的调用次数         | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | totalTime        | 总响应时间      | 该集群调用的总响应时间          | ms | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | errorCount       | 错误次数       | 该集群调用的错误次数           | -  | INT    | SUM    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | concurrentMax    | 最大并发       | 该集群的最大并发             | -  | INT    | MAX    |
| 集群调用（user，以调用方集群id维度统计接口调用数据。）       | maxTime          | 最大响应时间     | 该url在采集周期内最大响应时间     | ms | INT    | MAX    |
   
