[译] Oracle Database 21c 中的 Attention 日志

原文地址：https://oracle-base.com/articles/21c/attention-log-oracle-database-21c 原文作者：Tim Hall

多年来，数据库的告警日志变得非常庞大，很难从海量的告警信息中找到重要的日志内容。Attention 日志是 Oracle 21c 中引入的 JSON 格式文件，用于捕获关键事件，使系统诊断更加容易。

Attention 日志位置

本章目标：掌握本章核心知识点 前置要求：完成前序章节学习 预计时长：60 分钟

每个数据库都有一个 Attention 日志，Attention 日志的位置可以通过查询 V$DIAG_INFO 视图找到。下面的查询显示了来自 V$DIAG_INFO 视图的所有信息：

SQL

1set linesize 100 pagesize 20
2column name format a25
3column value format a70
4
5select name, value
6from   v$diag_info
7order by 1;
8
9NAME                      VALUE
10------------------------- ----------------------------------------------------------------------
11ADR Base                  /u01/app/oracle
12ADR Home                  /u01/app/oracle/diag/rdbms/cdb1/cdb1
13Active Incident Count     2
14Active Problem Count      1
15Attention Log             /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace/attention_cdb1.log
16Default Trace File        /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace/cdb1_ora_12511.trc
17Diag Alert                /u01/app/oracle/diag/rdbms/cdb1/cdb1/alert
18Diag Cdump                /u01/app/oracle/diag/rdbms/cdb1/cdb1/cdump
19Diag Enabled              TRUE
20Diag Incident             /u01/app/oracle/diag/rdbms/cdb1/cdb1/incident
21Diag Trace                /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace
22Health Monitor            /u01/app/oracle/diag/rdbms/cdb1/cdb1/hm
23ORACLE_HOME               /u01/app/oracle/product/21.0.0/dbhome_1
24
2513 rows selected.
26
27SQL>

通过设置查询条件，仅查询 Attention 日志路径：

SQL

1select name, value
2from   v$diag_info
3where  name = 'Attention Log';
4
5NAME                      VALUE
6------------------------- ----------------------------------------------------------------------
7Attention Log             /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace/attention_cdb1.log
8
9SQL>

Attention 日志内容

Attention 日志包含 JSON 格式的消息，以下是来自我的测试数据库的两条示例消息：

JSON

1{
2  "ERROR"        : "PMON (ospid: 2070): terminating the instance due to ORA error 12752",
3  "URGENCY"      : "IMMEDIATE",
4  "INFO"         : "Additional Information Not Available",
5  "CAUSE"        : "The instance termination routine was called",
6  "ACTION"       : "Check alert log for more information relating to instance termination rectify the error and restart the instance",
7  "CLASS"        : "CDB Instance / CDB ADMINISTRATOR / AL-1003",
8  "TIME"         : "2021-10-13T03:36:50.671+00:00"
9}
10
11{
12  "NOTIFICATION" : "Starting ORACLE instance (normal) (OS id: 1146)",
13  "URGENCY"      : "INFO",
14  "INFO"         : "Additional Information Not Available",
15  "CAUSE"        : "A command to startup the instance was executed",
16  "ACTION"       : "Check alert log for progress and completion of command",
17  "CLASS"        : "CDB Instance / CDB ADMINISTRATOR / AL-1000",
18  "TIME"         : "2021-10-13T10:46:01.949+00:00"
19}

我们可以看到，对于不同类型的消息，呈现的元素可能会有所不同。文档将这些分解如下，我用粗体添加了我自己的评论。

Attention ID：消息的唯一标识符。但是貌似没有出现在上述消息中，除非他们将“TIME”元素归类为唯一标识符。
Attention type：消息的类型。可选值为 Error, Warning, Notification, or Additional information，Attention 类型可以动态修改。我们似乎可以将 Attention 类型值和 Attention 主题结合起来，而不是拥有一个名为“ATTENTION_TYPE”的元素，其值与这些允许值之一匹配。但是我不清楚“可以动态修改”是什么意思。
Message text：我认为这一定是来自信息元素的值。
Urgency：可选值是 Immediate,Soon,Deferrable, or Information。这看起来基本没问题，但是 Attention 日志中的允许值与列出的不匹配。如果他们可以列出确切的允许值，那就太好了。
Scope：可能的值为 Session、Process、PDB Instance、CDB Instance、CDB Cluster、PDB（用于数据库重启无法修复的持久存储问题）或 CDB（用于数据库重启无法修复的持久存储问题）。我认为这必须是“CLASS”元素。
Target user：必须对此 Attention 日志消息采取行动的用户。可能的值为 Clusterware Admin、CDB admin 或 PDB admin。我不认为这是存在的，但也许它是由“CLASS”元素暗示的？
Cause：无需说明。
Action：无需说明。

Attention 日志内容的解释后面是一个示例消息，该示例消息与文档中的解释或我在 21c 注意日志中看到的消息样式不匹配。

从 SQL 查询 Attention 日志

Attention 日志似乎没有专门的 V$ 视图。文档建议使用 V$DIAG_ALERT_EXT 视图，但这是 XML 告警日志的视图，而不是 Attention 日志，我们可以自己解析。

思考

以下是我在查看 Attention 日志时的一些思考：

Attention 日志的文档相当模糊和不准确。看起来它可能是针对数据库的 beta 版本编写的，并且没有更正以匹配生产版本。
不同类型的消息可以包含不同的元素，这使得解析文件更加困难。在上面的示例中，我们有一个带有“ERROR”元素的消息，另一个带有“NOTIFICATION”元素的消息。如果他们为每种类型的消息保留共同的元素名称，并且只包含一个“TYPE”元素，那就更容易了。
数据库应用特性说明 Attention 日志采用 JSON 和 XML 格式。要查找此语句，请在此处搜索“attention log”，然后单击生成的“Enhanced Diagnosability of Oracle Database”标题。在主文档中没有提到 XML 格式，只有 JSON 格式的文件。有两个隐藏参数（_diag_attn_log_format_error 和 _diag_attn_log_format_standard）看起来相关，但没有关于如何使用它们的文档，因此显然不支持它们。
Attention 日志文件位于我的数据库的“/u01/app/oracle/diag/rdbms/cdb1/cdb1/trace”目录中。还有一个“/u01/app/oracle/diag/rdbms/cdb1/cdb1/log/attention”目录，但是里面没有文件。目前尚不清楚该目录的用途。

总的来说，我的理解是这是一个好主意，但我不确定我是否赞同这个方式，并且文档方面还需要大量补充修正。