生成 ASH 报告

使用 SYS 用户登录到集群的 Oracle 租户，进入 OceanBase 数据库。

$ obclient -h172.xx.xxx.xxx -Pxxxx -usys@oracle -pxxxx -A

通过 SET SERVEROUTPUT ON 语句输出打印内容。

obclient [SYS]> SET SERVEROUTPUT ON;

在控制台界面展示报告信息。

调用 ASH PL 包，输入需要诊断的开始时间、结束时间以及结束后以何种类型展示报告。

• 在界面上以 TEXT 的类型展示报告内容。

  设置诊断开始时间为 2024-02-22 19:26:47，诊断结束时间为 2024-06-22 19:27:07，报告展示类型为 TEXT，其他字段值根据是否需要来设置。

  obclient [SYS]>CALL DBMS_WORKLOAD_REPOSITORY.ASH_REPORT(TO_DATE('2024-02-22 19:26:47', 'YYYY-MM-DD HH24:MI:SS'), TO_DATE('2024-06-22 19:27:07', 'YYYY-MM-DD HH24:MI:SS'), REPORT_TYPE=> 'TEXT');
  

  截取生成的部分内容：

          ASH Report
              Cluster Name: test424
          Observer Version: OceanBase 4.2.4.0 (200000342024061210-c4c0c18741e45a1d40889b6147c313257xxxxxxxxx)
      Operation System Info: Linux(3.10.0-327.ali2019.alios7.x86_64)_x86_64
      User Input Begin Time: 2024-02-2219:26:47
        User Input End Time: 2024-06-2219:27:07
        Analysis Begin Time: 2024-06-1318:26:41
          Analysis End Time: 2024-06-1414:51:12
              Elapsed Time: 73471
              Num of Sample: 14750
    Average Active Sessions: 0.20
    Top Active Tenants:
      - this section lists top active tenant information
      - Total Count: num of records during ash report analysis time period
      - Wait Event Count: num of records when session is on wait event
      - On CPU Count: num of records when session is on cpu
      - Avg Active Sessions: average active sessions during ash report analysis time period
      - % Activity: activity(cpu + wait) percentage for given tenant
    +---------+------------+------------------+-----------------------+-------------------+--------------------+-----------+
    |Tenant ID|Session Type|       Total Count|       Wait Event Count|       On CPU Count| Avg Active Sessions| % Activity|
    +---------+------------+------------------+-----------------------+-------------------+--------------------+-----------+
    |     1004|  BACKGROUND|             14725|                   1670|              13055|                0.20|     99.83%|
    |     1004|  FOREGROUND|                25|                     11|                 14|                0.00|      0.17%|
    +---------+------------+------------------+-----------------------+-------------------+--------------------+-----------+
  

• 在界面上以 HTML 的类型展示报告内容。

  设置诊断开始时间为 2024-02-22 19:26:47，诊断结束时间为 2024-06-22 19:27:07，报告展示格式为 HTML，其他字段值根据是否需要来设置。

  obclient [SYS]>CALL DBMS_WORKLOAD_REPOSITORY.ASH_REPORT(TO_DATE('2024-02-22 19:26:47', 'YYYY-MM-DD HH24:MI:SS'), TO_DATE('2024-06-22 19:27:07', 'YYYY-MM-DD HH24:MI:SS'), REPORT_TYPE=> 'HTML');
  

  截取生成的部分内容：

          Observer Version: OceanBase 4.2.4.0 (200000342024061210-c4c0c18741e45a1d40889b6147c313257xxxxxxxxx)
      Operation System Info: Linux(3.10.0-327.ali2019.alios7.x86_64)_x86_64
      User Input Begin Time: 2024-02-2219:26:47
        User Input End Time: 2024-06-2219:27:07
        Analysis Begin Time: 2024-06-1318:26:41
          Analysis End Time: 2024-06-1414:54:29
              Elapsed Time: 73668
              Num of Sample: 14806
    Average Active Sessions: 0.20
    </pre><ul id=110></ul><a class="ash_html" name='Top Active Tenants'></a>          <h2 class="ash_html">Top Active Tenants<br></h2><ul><li class='ash_html'>this section lists top active tenant information</li>
    <li class='ash_html'>Total Count: num of records during ash report analysis time period</li>
    <li class='ash_html'>Wait Event Count: num of records when session is on wait event</li>
    <li class='ash_html'>On CPU Count: num of records when session is on cpu</li>
    <li class='ash_html'>Avg Active Sessions: average active sessions during ash report analysis time period</li>
    <li class='ash_html'>% Activity: activity(cpu + wait) percentage for given tenant</li>
  

（可选）在本地查看报告信息。

将报告内容以 TXT 文件或 HTML 网页的形式查看，这里以生成 HTML 类型为例。

1. 登录进入物理机。

   [admin@xxxxxx.eu95sqa /home/admin]
   

2. 制作 ASH 报告脚本文件 ash_report.html，该脚本文件只需要放在 OBServer 所在机器上即可。

   [admin@xxxxxx.eu95sqa /home/admin]
   $vim ash_report.html
   

3. 生成脚本内容。

   set serveroutput on;
   tee ash_report.html
   CALL DBMS_WORKLOAD_REPOSITORY.ASH_REPORT(        TO_DATE('2024-02-22 19:26:47', 'YYYY-MM-DD HH24:MI:SS'),        TO_DATE('2024-06-22 19:27:07', 'YYYY-MM-DD HH24:MI:SS'), REPORT_TYPE=> 'HTML'   );
   notee
   

4. 登录数据库，运行 ash_report.html 脚本。

   $ obclient -h172.xx.xxx.xxx -Pxxxx -usys@oracle -pxxxx -A
   

   obclient [SYS]> source ash_report.html;
   

   脚本运行成功后，会在界面上打印 HTML 类型的报告内容。

5. 退出数据库，进入物理机查看 ash_report.html 文件路径。

   [admin@k08j13249.eu95sqa /home/admin]
   $ls
   ALTER                              ash_report.html
   

   查询到 ash_report.html 文件路径为 home/admin/ash_report.html。

6. 从物理机导出文件到本地。

   1. 打开一个新的 Shell 界面，进入到需要保存文件的路径下。

      PS C:\Users\xxx\Desktop\ASH>
      

   2. 使用 scp 命令将 ash_report.html 文件从物理机导入到本机。

      scp admin@xx.xx.xx.xx:/home/admin/ash_report.html  /
      

   3. 在本地路径下打开 ash_report.html 文件查看报告信息。。