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

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

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

目录

• Attention 日志位置
• Attention 日志内容
• 从 SQL 查询 Attention 日志
• 思考

Attention 日志位置

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

set linesize 100 pagesize 20
column name format a25
column value format a70

select name, value
from   v$diag_info
order by 1;

NAME                      VALUE
------------------------- ----------------------------------------------------------------------
ADR Base                  /u01/app/oracle
ADR Home                  /u01/app/oracle/diag/rdbms/cdb1/cdb1
Active Incident Count     2
Active Problem Count      1
Attention Log             /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace/attention_cdb1.log
Default Trace File        /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace/cdb1_ora_12511.trc
Diag Alert                /u01/app/oracle/diag/rdbms/cdb1/cdb1/alert
Diag Cdump                /u01/app/oracle/diag/rdbms/cdb1/cdb1/cdump
Diag Enabled              TRUE
Diag Incident             /u01/app/oracle/diag/rdbms/cdb1/cdb1/incident
Diag Trace                /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace
Health Monitor            /u01/app/oracle/diag/rdbms/cdb1/cdb1/hm
ORACLE_HOME               /u01/app/oracle/product/21.0.0/dbhome_1

13 rows selected.

SQL>

AI写代码sql

* 1
* 2
* 3
* 4
* 5
* 6
* 7
* 8
* 9
* 10
* 11
* 12
* 13
* 14
* 15
* 16
* 17
* 18
* 19
* 20
* 21
* 22
* 23
* 24
* 25
* 26
* 27

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

select name, value
from   v$diag_info
where  name = 'Attention Log';

NAME                      VALUE
------------------------- ----------------------------------------------------------------------
Attention Log             /u01/app/oracle/diag/rdbms/cdb1/cdb1/trace/attention_cdb1.log

SQL>

AI写代码sql

* 1
* 2
* 3
* 4
* 5
* 6
* 7
* 8
* 9

Attention 日志内容

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

{
  "ERROR"        : "PMON (ospid: 2070): terminating the instance due to ORA error 12752",
  "URGENCY"      : "IMMEDIATE",
  "INFO"         : "Additional Information Not Available",
  "CAUSE"        : "The instance termination routine was called",
  "ACTION"       : "Check alert log for more information relating to instance termination rectify the error and restart the instance",
  "CLASS"        : "CDB Instance / CDB ADMINISTRATOR / AL-1003",
  "TIME"         : "2021-10-13T03:36:50.671+00:00"
}

{
  "NOTIFICATION" : "Starting ORACLE instance (normal) (OS id: 1146)",
  "URGENCY"      : "INFO",
  "INFO"         : "Additional Information Not Available",
  "CAUSE"        : "A command to startup the instance was executed",
  "ACTION"       : "Check alert log for progress and completion of command",
  "CLASS"        : "CDB Instance / CDB ADMINISTRATOR / AL-1000",
  "TIME"         : "2021-10-13T10:46:01.949+00:00"
}

AI写代码json

* 1
* 2
* 3
* 4
* 5
* 6
* 7
* 8
* 9
* 10
* 11
* 12
* 13
* 14
* 15
* 16
* 17
* 18
* 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”目录，但是里面没有文件。目前尚不清楚该目录的用途。

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