1.13 命令参考手册

从 2.0.5 版本开始，dubbo 开始支持通过 telnet 命令来进行服务治理。

使用

telnet localhost 20880

或者：

echo status | nc -i 1 localhost 20880

status命令所检查的资源也可以扩展，参见：扩展参考手册。

命令

以下展示了 dubbo 内建的 telnet 命令的说明和用法，此外，telnet 命令还支持用户自行扩展，参见：Telnet 命令扩展。

ls

1. ls: 显示服务列表
2. ls -l: 显示服务详细信息列表
3. ls XxxService: 显示服务的方法列表
4. ls -l XxxService: 显示服务的方法详细信息列表

ps

1. ps: 显示服务端口列表
2. ps -l: 显示服务地址列表
3. ps 20880: 显示端口上的连接信息
4. ps -l 20880: 显示端口上的连接详细信息

cd

1. cd XxxService: 改变缺省服务，当设置了缺省服务，凡是需要输入服务名作为参数的命令，都可以省略服务参数
2. cd /: 取消缺省服务

pwd

pwd: 显示当前缺省服务

trace

1. trace XxxService: 跟踪 1 次服务任意方法的调用情况
2. trace XxxService 10: 跟踪 10 次服务任意方法的调用情况
3. trace XxxService xxxMethod: 跟踪 1 次服务方法的调用情况
4. trace XxxService xxxMethod 10: 跟踪 10 次服务方法的调用情况

count

1. count XxxService: 统计 1 次服务任意方法的调用情况
2. count XxxService 10: 统计 10 次服务任意方法的调用情况
3. count XxxService xxxMethod: 统计 1 次服务方法的调用情况
4. count XxxService xxxMethod 10: 统计 10 次服务方法的调用情况

invoke

1. invoke XxxService.xxxMethod(1234, "abcd", {"prop" : "value"}): 调用服务的方法
2. invoke com.xxx.XxxService.XxxService.xxxMethod(1234, "abcd", {"prop" : "value"}): 调用全路径服务的方法
3. invoke xxxMethod(1234, "abcd", {"prop" : "value"}): 调用服务的方法(自动查找包含此方法的服务)
4. invoke xxxMethod({"name":"zhangsan","age":12,"class":"org.apache.dubbo.qos.legacy.service.Person"}) :当有参数重载，或者类型转换失败的时候，可以通过增加class属性指定需要转换类
5. 当参数为Map，key的类型为Integer时，建议指定类型。例如invoke com.xxx.xxxApiService({"3":0.123, "class":"java.util.HashMap"})

select ²

1. select 1: 当 invoke 命令匹配到多个方法时使用，根据提示列表选择需要调用的方法

status

1. status: 显示汇总状态，该状态将汇总所有资源的状态，当全部 OK 时则显示 OK，只要有一个 ERROR 则显示 ERROR，只要有一个 WARN 则显示 WARN
2. status -l: 显示状态列表

log ¹

1. log debug: 修改 dubbo logger 的日志级别
2. log 100: 查看 file logger 的最后 100 字符的日志

help

1. help: 显示 telnet 命帮助信息
2. help xxx: 显示xxx命令的详细帮助信息

clear

1. clear: 清除屏幕上的内容
2. clear 100: 清除屏幕上的指定行数的内容

exit

exit: 退出当前 telnet 命令行

shutdown ²

1. shutdown: 关闭 dubbo 应用
2. shutdown -t 1000: 延迟 1000 毫秒关闭 dubbo 应用

¹. 2.0.6 以上版本支持 ↩

². 2.7.1 以上版本支持 ↩