blob: 1cec53ec10f7b2fa34de0beb290cef1d7f5b2a95 [file] [view]
[English version](../en/builtin_service.md)
# 什么是内置服务?
内置服务以多种形式展现服务器内部状态,提高你开发和调试服务的效率。brpc通过HTTP协议提供内置服务,可通过浏览器或curl访问,服务器会根据User-Agent返回纯文本或html,你也可以添加?console=1要求返回纯文本。我们在自己的开发机上启动了[一个长期运行的例子](http://brpc.baidu.com:8765/)(只能百度内访问),你可以点击后随便看看。如果服务端口被限(比如百度内不是所有的端口都能被笔记本访问到),可以使用[rpc_view](rpc_view.md)转发。
下面是分别从浏览器和终端访问的截图,注意其中的logo是百度内部的名称,在开源版本中是brpc
**从浏览器访问**
![img](../images/builtin_service_more.png)
**从命令行访问** ![img](../images/builtin_service_from_console.png)
# 安全模式
出于安全考虑,直接对外服务需要隐藏内置服务(包括经过nginx或其他http server转发流量的),具体方法请阅读[这里](server.md#安全模式)。
# 主要服务
[/status](status.md): 显示所有服务的主要状态。
[/vars](vars.md): 用户可定制的,描绘各种指标的计数器。
[/connections](connections.md): 所有连接的统计信息。
[/flags](flags.md): 所有gflags的状态,可动态修改。
[/rpcz](rpcz.md): 查看所有的RPC的细节。
[cpu profiler](cpu_profiler.md): 分析cpu热点。
[heap profiler](heap_profiler.md): 分析内存占用。
[contention profiler](contention_profiler.md): 分析锁竞争。
# 其他服务
[/version](http://brpc.baidu.com:8765/version): 查看服务器的版本。用户可通过Server::set_version()设置Server的版本,如果用户没有设置,框架会自动为用户生成,规则:`brpc_server_<service-name1>_<service-name2> ...`
![img](../images/version_service.png)
[/health](http://brpc.baidu.com:8765/health): 探测服务的存活情况。
![img](../images/health_service.png)
[/protobufs](http://brpc.baidu.com:8765/protobufs): 查看程序中所有的protobuf结构体。
![img](../images/protobufs_service.png)
[/vlog](http://brpc.baidu.com:8765/vlog): 查看程序中当前可开启的[VLOG](streaming_log.md#VLOG) (对glog无效)。
![img](../images/vlog_service.png)
/dir: 浏览服务器上的所有文件,方便但非常危险,默认关闭。
/threads: 查看进程内所有线程的运行状况,调用时对程序性能影响较大,默认关闭。