弹簧启动执行器-MAX属性

Question

我正在使用Spring Boot Actuator依赖项来获取应用程序的见解。 为此，我使用了Spring Boot Admin。 客户端服务器的配置工作正常。 我必须测量要执行的端点的计数，总时间，最大值。

uri:/user/asset/getAllAssets
TOTAL_TIME: 831ms
MAX: 0ms 

uri:/user/getEmployee/{employeeId}
TOTAL_TIME: 98ms
MAX: 0ms

为什么MAX（时间）为0而TOTAL_TIME：为Xms

当我执行概括形式

localhost:8889/actuator/metrics/http.server.requests我将MAX设为3.00 ..

我也看到了生产就绪功能，但无法找到有关如何计算MAX或代表MAX的任何描述。

注意：随着请求数量的增加（COUNT），TOTAL_TIME也有所增加，但MAX有时有所减少 （有关详细信息，请参见请求1，请求2）

请求1：http.server.requests

 {
        "name": "http.server.requests",
        "description": null,
        "baseUnit": "seconds",
        "measurements": [
            {
                "statistic": "COUNT",
                "value": 597
            },
            {
                "statistic": "TOTAL_TIME",
                "value": 144.9057076
            },
            {
                "statistic": "MAX",
                "value": 3.0002913
            }
        ],
        "availableTags": [
            {
                "tag": "exception",
                "values": [
                    "None"
                ]
            },
            {
                "tag": "method",
                "values": [
                    "GET"
                ]
            },
            {
                "tag": "uri",
                "values": [
                    "/actuator/metrics/{requiredMetricName}",
                    "/**/favicon.ico",
                    "/actuator",
                    "/user/getEmployee/{employeeId}",
                    "/user/asset/getAllAssets",
                    "/actuator/health",
                    "/actuator/info",
                    "/actuator/env/{toMatch}",
                    "/actuator/metrics",
                    "/**"
                ]
            },
            {
                "tag": "outcome",
                "values": [
                    "CLIENT_ERROR",
                    "SUCCESS"
                ]
            },
            {
                "tag": "status",
                "values": [
                    "404",
                    "200"
                ]
            }
        ]
    }

---

UPDATE

localhost:8889/actuator/metrics/http.server.requests?tag=uri:/user/getEmployee/2

响应404 （我在请求执行器之前已执行/ user / getEmployee / 2）

---

localhost:8889/actuator/metrics/http.server.requests?tag=uri:/user/getEmployee/{employeeId}

回应400

---

localhost:8889/actuator/metrics/http.server.requests?tag=uri:/user/asset/getAllAssets

{
    "name": "http.server.requests",
    "description": null,
    "baseUnit": "seconds",
    "measurements": [
        {
            "statistic": "COUNT",
            "value": 1
        },
        {
            "statistic": "TOTAL_TIME",
            "value": 0.8311609
        },
        {
            "statistic": "MAX",
            "value": 0
        }
    ],
    "availableTags": [
        {
            "tag": "exception",
            "values": [
                "None"
            ]
        },
        {
            "tag": "method",
            "values": [
                "GET"
            ]
        },
        {
            "tag": "outcome",
            "values": [
                "SUCCESS"
            ]
        },
        {
            "tag": "status",
            "values": [
                "200"
            ]
        }
    ]
}

要求2：http.server.requests

localhost:8889/actuator/metrics/http.server.requests

{
    "name": "http.server.requests",
    "description": null,
    "baseUnit": "seconds",
    "measurements": [
        {
            "statistic": "COUNT",
            "value": 3346
        },
        {
            "statistic": "TOTAL_TIME",
            "value": 559.7992767999998
        },
        {
            "statistic": "MAX",
            "value": 2.3612968
        }
    ],

Answer 1

您可以使用根/actuator/metrics/http.server.requests调用响应中定义的?tag=url:{endpoint_tag}来查看各个指标。 measurements值的详细信息是；

• COUNT：每秒的通话速率。
• TOTAL_TIME：记录的时间总和。 报告监视系统的基本时间单位

• 最大：记录的最大数量。 当它表示时间时，将以监视系统的基本时间单位进行报告。

正如这里所给，也在这里 。

---

您看到的差异是由于存在计时器造成的。 这意味着一段时间后，可以将任何标记的指标的当前定义的MAX值重置为0 。 您是否可以向/user/asset/getAllAssets添加一些新调用，然后立即对/actuator/metrics/http.server.requests进行调用，以查看给定标记的MAX值非零？

这是由于在每个较小的周期获得MAX指标的想法所致。 看到这些指标时，您将能够长时间获取一个MAX值数组，而不是单个值。

您可以在Micrometer源代码中看到这一点。 有一个rotate()方法专注于重置MAX值以创建上述行为。

您可以看到每个poll()调用都会调用此方法，该调用每隔一段时间收集一次指标。

Answer 2

• MAX代表什么

MAX表示执行端点所需的最长时间。

分析/user/asset/getAllAssets

COUNT  TOTAL_TIME  MAX
5      115         17
6      122         17  (Execution Time = 122 - 115 = 17)
7      131         17  (Execution Time = 131 - 122 = 17)
8      187         56  (Execution Time = 187 - 131 = 56)  
9      204         56  From Now MAX will be 56 (Execution Time = 204 - 187 = 17)  

---

• 如果我们对特定端点的请求（或请求数）更少，MAX会为0吗？

特定端点的请求数量不影响MAX

---

• 当MAX为0时

有一个将值设置为0的计时器。当一段时间未调用或执行端点时，计时器将MAX设置为0。此处， 计时器的近似值为2.30分钟（150秒）。

---

• 如何确定计时器值？

为此，我采取了6个样本（对同一端点执行了6次）。 为此，我确定了调用端点的时间之间的时差-MAX设置为零的时间

DistributionStatisticConfig具有.expiry(Duration.ofMinutes(2)).bufferLength(3) ，如果在到期时间或轮换时间之间未进行任何请求，则该方法.expiry(Duration.ofMinutes(2)).bufferLength(3)某些度量设置为0。

---

MAX属性属于由Measurement使用的枚举统计信息 （在Measurement中，我们获得COUNT，TOTAL_TIME，MAX）

公共静态最终统计MAX

记录的最大数量。 当它表示时间时，将以监视系统的基本时间单位进行报告。

---

注意：这是来自度量标准的特定端点的情况（此处为/actuator/metrics/http.server.requests?tag=uri:/user/asset/getAllAssets ）。

用于概括actuator/metrics/http.server.requests

从请求1，请求2（有问题的）中可以看到，MAX已减少（ 从3.0002913减少到2.3612968），因此可能由于某个端点的MAX而由于计时器而将其设置为0。 在我看来，/ /http.server.requests MAX将与特定的端点相同。 （但请对此进行调查）

Answer 3

MAX指标是滚动的最大值。 因此，它代表滚动窗口中的最大测量值。

例如，如果您要每分钟抓取指标：

          Total    Count   Max
Minute 1    100        1   100  
Minute 2    500      101    90
Minute 3   4500     1000    10
Minute 4   4500     1000     0

在分钟1中，您有1个请求，总计100毫秒，因此平均持续时间为100毫秒，最慢的（最大）为100毫秒

在第2分钟内，总数增加了400（因为累计是累积的），计数增加了100。因此平均为4毫秒。 但是，由于最大时间是90毫秒，因此您知道虽然那一秒中的大多数请求都很快，但仍有一些请求较慢。

在第3分钟，您又增加了899个请求（计数），并增加了4000ms。 （4000/899 =〜4.4ms）因此，您的平均测量值为4.4ms，最大值为10ms。

因此，MAX的目的是测量最差的离群值，以便您了解代码执行的一致性。

从第4分钟看，总数和计数没有增加，因为没有请求。 由于没有请求，因此不可能有对MAX的“最慢”请求，这就是MAX为0的原因。