status

了解 status 服务。

/status 展示了服务器内各服务的主要统计数据。其数据来源与 /vars 相同，但统计的分组方式不同。

上述各字段的含义如下：

non_service_error：在服务处理代码之外产生的错误数量。当成功获取到有效服务时，后续出现的错误被视为 service_error，否则被视为 non_service_error（例如请求解析失败、服务名不存在、请求并发数超过限制等）。作为对比，在处理过程中访问后端服务器失败属于该服务的错误，而非 non_service_error。即使写出的响应代表失败，该错误也计入服务本身，而不是 non_service_error。
connection_count：客户端到服务器的连接数量，不包含对外的连接数，后者显示在 /vars/rpc_channel_connection_count 中。
example.EchoService：服务的完整名称，包含在 proto 中定义的包名。
Echo (EchoRequest) returns (EchoResponse)：方法的签名。一个服务可以包含多个方法。点击请求/响应上的链接可以查看对应的 protobuf 消息定义。
count：成功处理的请求数量。
error：处理失败的请求数量。
latency：在 html 页面上，表示从右到左最近 60s/60m/24h/30d 的平均延迟；在纯文本上，表示最近 10 秒（默认值，可通过 -bvar_dump_interval 指定）的平均延迟。
latency_percentiles：最近 10 秒（由 -bvar_dump_interval 指定）内延迟的 80%、90%、99%、99.9% 分位数。在 html 页面上会展示包含历史值的曲线。
latency_cdf：以 CDF 的形式展示分位数，仅在 html 页面上可用。
max_latency：在 html 页面上，表示从右到左最近 60s/60m/24h/30d 的最大延迟；在纯文本上，表示最近 10 秒（默认值，可通过 -bvar_dump_interval 指定）的最大延迟。
qps：在 html 页面上，表示从右到左最近 60s/60m/24h/30d 的 QPS（每秒查询数）；在纯文本上，表示最近 10 秒（默认值，可通过 -bvar_dump_interval 指定）的 QPS。
processing：（在 master 中已改名为 concurrency）该方法当前正在处理的请求数量。如果当该服务的流量变为零时该计数器仍无法归零，说明服务器可能存在 bug，例如忘记调用 done->Run() 或者卡在了某个处理步骤上。

用户可以通过让服务实现 brpc::Describable 来自定义 /status 上的描述信息。

class MyService : public XXXService, public brpc::Describable {
public:
    ...
    void Describe(std::ostream& os, const brpc::DescribeOptions& options) const {
        os << "my_status: blahblah";
    }
};

例如：

最后修改于 2022 年 2 月 26 日：brpc 网站 1.0 修复概览页面中链接跳转问题 (14eec1ac1)](https://github.com/apache/brpc-website/commit/14eec1ac1805c1dde9f10d0353984bde2127294c)

状态

status

评论