内置stack工具

可获得性

本特性自3.0.0版本开始引入。

特性简介

stack工具是获取数据库中各线程的调用栈的工具，用于辅助数据库运维人员定位死锁、hang等问题。

客户价值

提供函数级别的调用栈信息，提升数据库内核运维人员分析、定位死锁、hang等问题的效率。

特性描述

可以通过函数gs_stack()或者工具gs_ctl stack两种方式获取数据库中线程的调用栈。

  1. gs_stack()函数方式

  2. select * from gs_stack(pid)获取指定线程调用栈。

    1. openGauss=# select * from gs_stack(139663481165568); 2. gs_stack 3. -------------------------------------------------------------------- 4. __poll + 0x2d + 5. WaitLatchOrSocket(Latch volatile*, int, int, long) + 0x29f + 6. WaitLatch(Latch volatile*, int, long) + 0x2e + 7. JobScheduleMain() + 0x90f + 8. int GaussDbThreadMain<(knl_thread_role)9>(knl_thread_arg*) + 0x456+ 9. InternalThreadFunc(void*) + 0x2d + 10. ThreadStarterFunc(void*) + 0xa4 + 11. start_thread + 0xc5 + 12. clone + 0x6d + 13. (1 row) - select * from gs_stack()获取所有线程的调用栈。

    1. openGauss=# select * from gs_stack(); 2. -[ RECORD 1 ]------------------------------------------------------------------------------------------------------- 3. tid | 139670364324352 4. lwtid | 308 5. stack | __poll + 0x2d 6. | CommWaitPollParam::caller(int (*)(pollfd*, unsigned long, int), unsigned long) + 0x34 7. | int comm_socket_call<CommWaitPollParam, int (*)(pollfd*, unsigned long, int)>(CommWaitPollParam*, int (*)(pollfd*, unsigned long 8. , int)) + 0x28 9. | comm_poll(pollfd*, unsigned long, int) + 0xb1 10. | ServerLoop() + 0x72b 11. | PostmasterMain(int, char**) + 0x314e 12. | main + 0x617 13. | __libc_start_main + 0xf5 14. | 0x55d38f8db3a7 15. [ RECORD 2 ]------------------------------------------------------------------------------------------------------- 16. tid | 139664851859200 17. lwtid | 520 18. stack | __poll + 0x2d 19. | WaitLatchOrSocket(Latch volatile*, int, int, long) + 0x29f 20. | SysLoggerMain(int) + 0xc86 21. | int GaussDbThreadMain<(knl_thread_role)17>(knl_thread_arg*) + 0x45d 22. | InternalThreadFunc(void*) + 0x2d 23. | ThreadStarterFunc(void*) + 0xa4 24. | start_thread + 0xc5 25. | clone + 0x6d 2. gs_ctl stack方式获取调用栈

  3. 执行以下命令获取指定线程的调用栈。

    1. gs_ctl stack -D data_dir -I lwtid

    上述命令中-D data_dir用于指定需要获取调用栈的gaussdb进程的数据目录，-I lwtid用于指定目标线程的lwtid，lwpid可以ls /proc/pid/task/获取。具体步骤如下所示。

    1. 获取gaussdb进程号和数据目录。

      1. ps -ux | more 2. USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND 3. perfadm 308 9.3 10.1 8719348 1649108 ? Sl May20 58:58 /xxx/bin/gaussdb -u 92617 -D /xxx/openGauss/cluster/data1/dn1 -M pending 2. 通过进程号获取lwtid，task目录下的目录名就是lwtid。

      1. ls /proc/308/task/ 2. 1096 505 522 525 529 532 536 539 542 546 549 552 555 558 561 565 569 575 584 833 923 926 929 932 935 938 3. 获取指定lwtid的调用栈。

      1. gs_ctl stack -D /xxx/openGauss/cluster/data1/dn1 -I 1096 2. [2022-05-21 10:52:51.354][24520][][gs_ctl]: gs_stack start: 3. tid<140409677575616> lwtid<1096> 4. __poll + 0x2d 5. CommWaitPollParam::caller(int (*)(pollfd*, unsigned long, int), unsigned long) + 0x34 6. int comm_socket_call<CommWaitPollParam, int (*)(pollfd*, unsigned long, int)>(CommWaitPollParam*, int (*)(pollfd*, unsigned long, int)) + 0x28 7. comm_poll(pollfd*, unsigned long, int) + 0xb1 8. ServerLoop() + 0x72b 9. PostmasterMain(int, char**) + 0x329a 10. main + 0x617 11. __libc_start_main + 0xf5 12. 0x55cf616e7647 13. [2022-05-21 10:52:51.354][24520][][gs_ctl]: gs_stack finished! - 执行以下命令获取所有线程的调用栈。

    1. gs_ctl stack -D data_dir

    上述命令中，-D data_dir用于指定需要获取调用栈的gaussdb进程的数据目录。具体步骤如下所示。

    1. 获取gaussdb进程号和数据目录。

      1. ps -ux | more 2. USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND 3. perfadm 308 9.3 10.1 8719348 1649108 ? Sl May20 58:58 /xxx/bin/gaussdb -u 92617 -D /xxx/openGauss/cluster/data1/dn1 -M pending 2. 获取所有线程的调用栈。

      ``` 1. [panhongchang@euler_phy_194 panhongchang]$ gs_ctl stack -D /xxx/openGauss/cluster/data1/dn1 2. [2022-05-21 10:59:44.063][34511][][gs_ctl]: gs_stack start: 3. Thread 0 tid<140409677575616> lwtid<21045> 4. __poll + 0x2d 5. CommWaitPollParam::caller(int ()(pollfd, unsigned long, int), unsigned long) + 0x34 6. int comm_socket_call(CommWaitPollParam, int ()(pollfd, unsigned long, int)) + 0x28 7. comm_poll(pollfd, unsigned long, int) + 0xb1 8. ServerLoop() + 0x72b 9. PostmasterMain(int, char**) + 0x329a 10. main + 0x617 11. __libc_start_main + 0xf5 12. 0x55cf616e7647

      1. Thread 1 tid<140405343516416> lwtid<21060>
      2. __poll + 0x2d
      3. WaitLatchOrSocket(Latch volatile*, int, int, long) + 0x29f
      4. SysLoggerMain(int) + 0xc86
      5. int GaussDbThreadMain<(knl_thread_role)17>(knl_thread_arg*) + 0x45d
      6. InternalThreadFunc(void*) + 0x2d
      7. ThreadStarterFunc(void*) + 0xa4
      8. start_thread + 0xc5
      9. clone + 0x6d ```

      此处省略剩余调用栈。

特性增强

无。

特性约束

  1. 仅用于gaussdb进程，其他进程，如cms、gtm等不支持。
  2. 如果使用SQL的方式执行，则需要CN、DN进程处于正常状态，可连接和执行SQL。
  3. 如果使用gs_ctl的方式执行，则需要CN、DN进程处于可响应信号的状态。
  4. 不支持并发，在获取全线程栈的场景，各个线程的调用栈不处于同一时间点。
  5. 最多支持128层调用栈，如果实际情况超过128层，则仅保留栈顶的128层。
  6. 符号表没有被trip（当前release版本，使用的是strip –d，仅去掉了debug信息，符号表没有被trip，如果改为strip –s，则仅能显示指针，无法显示出符号名）。
  7. SQL执行方式仅支持monadmin、sysadmin用户。
  8. 注册了SIGURG信号的线程，才能获取调用栈。
  9. 对于屏蔽操作系统SIGUSR2的代码段，无法获取调用栈 ，如果线程没有注册signal_slot，同样无法获取调用栈。

依赖关系

无。