« Oracle Oracle WebLogic 集成 »
Elastic 文档 ›Elastic 集成 ›Oracle

Oracle 集成

编辑

Oracle 集成

编辑

版本

1.28.0 (查看全部)

兼容的 Kibana 版本

8.13.0 或更高版本

支持的无服务器项目类型
这是什么？

安全性
可观测性

订阅级别
这是什么？

基本

支持级别
这是什么？

Elastic

此集成用于从 Oracle 数据库中提取审计跟踪日志和获取性能、表空间和系统指标。

此集成需要默认情况下由 Oracle 数据库生成的 *.aud 审计文件。如果已禁用此功能，请参阅 Oracle 数据库审计跟踪文档。

要求
编辑

可以通过两种方式连接到 Oracle，一种是使用官方 Oracle 库，另一种是使用 JDBC 驱动程序。目前 Metricbeat 不支持使用 JDBC 连接。可以使用 Oracle 库来实现连接，具体步骤如下所述。

Oracle 数据库连接先决条件
编辑

要连接到 Oracle 数据库，应设置 ORACLE_SID、ORACLE_BASE、ORACLE_HOME 环境变量。

例如：假设使用 RPM 手动按照 Oracle 安装说明安装 Oracle 数据库 21c。应按如下方式设置环境变量：ORACLE_SID=ORCLCDB ORACLE_BASE=/opt/oracle/oradata ORACLE_HOME=/opt/oracle/product/21c/dbhome_1 此外，将 $ORACLE_HOME/bin 添加到 PATH 环境变量。

Oracle 即时客户端
编辑

Oracle 即时客户端使开发和部署连接到 Oracle 数据库的应用程序成为可能。即时客户端库提供了必要的网络连接和高级数据功能，可以充分利用 Oracle 数据库。如果您的 OCI Oracle 服务器预装了这些库，则无需单独安装客户端。

OCI 库安装了一些客户端共享库，这些库必须在安装 Metricbeat 的计算机上引用。请按照 Oracle 客户端安装链接中的说明设置 OCI 即时客户端。OCI 即时客户端可通过 Oracle Universal Installer、RPM 文件或 ZIP 文件获取。下载链接可以在 Oracle 即时客户端下载页面找到。

如果 Elastic Agent 作为 systemd 服务运行，而不是使用 ldconfig 作为更新共享库链接的选项，则可以使用 LD_LIBRARY_PATH 环境变量代替。请按照以下步骤操作，以确保 Elastic Agent 及其衍生的进程遵循 LD_LIBRARY_PATH 环境变量。

先决条件：确保您拥有修改 Elastic Agent systemd 服务配置的管理权限。

步骤

  1. 运行以下命令检查 Elastic Agent systemd 服务的状态：systemctl status elastic-agent.service 记下 elastic-agent.service 文件的路径，该文件通常位于 systemd 服务目录中。示例路径：/etc/systemd/system/elastic-agent.service
  2. 在您首选的文本编辑器中打开 elastic-agent.service 文件，找到 EnvironmentFile 键（通常位于 /etc/sysconfig/elastic-agent），并验证其内容，因为这些配置对于 elastic-agent 的运行时环境初始化至关重要。如果 EnvironmentFile 不存在，请创建它并设置必要的权限，以确保 elastic-agent 具有完全访问权限。

  3. 将 LD_LIBRARY_PATH 环境变量添加到配置的 EnvironmentFile。您可以将其设置为库 (libclntsh.so) 所在的目录。例如，如果您的库位于 /opt/oracle/instantclient_21_1 目录，请将以下行添加到 EnvironmentFile (即 /etc/systemd/system/elastic-agent.service)

    LD_LIBRARY_PATH=/opt/oracle/instantclient_21_1

  4. 保存对配置的 EnvironmentFile 所做的更改。

  5. 通过运行以下命令重新启动 Elastic Agent systemd 服务以应用更改

    systemctl restart elastic-agent.service

请确保将 /opt/oracle/instantclient_21_1 替换为所需库 (libclntsh.so) 所在的目录的实际路径。这将设置 Elastic Agent 服务的库搜索路径以包含指定的目录，使其能够找到所需的库。

启用监听器
编辑

Oracle 监听器是在数据库主机上运行的服务，它接收来自 Oracle 客户端的请求。请确保 监听器正在运行。要检查监听器是否正在运行，请运行

lsnrctl STATUS

如果监听器未运行，请使用以下命令启动

lsnrctl START

然后，可以启动 Metricbeat。

Oracle DSN 配置
编辑

支持以下两种配置格式

oracle://<user>:<password>@<connection_string>
user="<user>" password="<password>" connectString="<connection_string>" sysdba=<true|false>

示例值如下

oracle://sys:[email protected]:1521/ORCLCDB.localdomain?sysdba=1
user="sys" password="Oradoc_db1" connectString="0.0.0.0:1521/ORCLCDB.localdomain" sysdba=true

在第一种基于 URL 的格式中，特殊字符应进行 URL 编码。

在第二种 logfmt 编码的 DSN 格式中，如果密码包含反斜杠字符 (\)，则必须使用另一个反斜杠进行转义。例如，如果密码为 my_password，则必须写为 my\_password。

要屏蔽 DSN 中显示的密码，请从 DSN 字符串中删除用户名和密码，并将 DSN 配置为仅包含主机地址和连接所需的任何其他参数。随后，使用高级选项下的 username 和 password 字段对其进行配置。

兼容性

编辑

此集成已在 Oracle 数据库 19c 上进行过测试，并且应该也适用于 18c，尽管尚未经过测试。

审计日志
编辑

database_audit 数据集收集 Oracle 审计日志。

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型

@timestamp

事件时间戳。

日期

cloud.image.id

云实例的镜像 ID。

关键字

data_stream.dataset

数据流数据集。

常量关键字

data_stream.namespace

数据流命名空间。

常量关键字

data_stream.type

数据流类型。

常量关键字

event.dataset

事件数据集

常量关键字

event.module

事件模块

常量关键字

host.containerized

如果主机是容器。

布尔值

host.os.build

操作系统构建信息。

关键字

host.os.codename

操作系统代号（如果有）。

关键字

input.type

输入类型

关键字

log.file.device_id

包含文件所在文件系统的设备的 ID。

关键字

log.file.fingerprint

启用指纹识别时，文件的 sha256 指纹标识。

关键字

log.file.idxhi

与文件关联的唯一标识符的高位部分。（仅限 Windows）

关键字

log.file.idxlo

与文件关联的唯一标识符的低位部分。（仅限 Windows）

关键字

log.file.inode

日志文件的 inode 编号。

关键字

log.file.vol

包含文件的卷的序列号。（仅限 Windows）

关键字

log.flags

相关日志标志

log.offset

日志偏移量

长整型

message

事件的人可读摘要

文本

oracle.database_audit.action

在审计事件期间执行的操作。例如，这可以是原始查询。

关键字

oracle.database_audit.action_number

操作是一个数值，表示用户执行的操作。操作类型的对应名称位于 AUDIT_ACTIONS 表中。例如，操作 100 表示 LOGON。

关键字

oracle.database_audit.client.address

客户端使用的 IP 地址或域名。

关键字

oracle.database_audit.client.terminal

如果可用，客户端终端类型，例如 “pty”。

关键字

oracle.database_audit.client.user

运行客户端或连接到数据库的用户。

关键字

oracle.database_audit.comment_text

有关相关审计记录的其他注释。

文本

oracle.database_audit.database.host

客户端主机名。

关键字

oracle.database_audit.database.id

创建数据库时计算的数据库标识符。它对应于 V$DATABASE 数据字典视图的 DBID 列。

关键字

oracle.database_audit.database.user

用于身份验证的数据库用户。

关键字

oracle.database_audit.entry.id

指示当前审计条目编号，分配给每个审计跟踪记录。审计 entry.id 序列号在细粒度审计记录和常规审计记录之间共享。

长整型

oracle.database_audit.length

指此审计记录中使用的总字节数。此数字包括审计记录末尾的任何尾随换行符字节 (\n)。

长整型

oracle.database_audit.obj_creator

对象的所有者，DBA_AUDIT_Trail 中的等效字段为 OWNER。

关键字

oracle.database_audit.obj_name

对象的名称。

关键字

oracle.database_audit.os_userid

相关的操作系统用户。

关键字

oracle.database_audit.privilege

与数据库用户相关的权限组。

关键字

oracle.database_audit.returncode

指示审计的操作是否成功。0 表示成功。如果操作失败，则返回代码将列出 Oracle 数据库错误编号。

关键字

oracle.database_audit.ses_actions

使用 12 个字符定义执行的操作类型，每个位置指示操作的结果。它们是：ALTER、AUDIT、COMMENT、DELETE、GRANT、INDEX、INSERT、LOCK、RENAME、SELECT、UPDATE 和 FLASHBACK。

关键字

oracle.database_audit.ses_tid

与审计事件相关的对象的 ID。

关键字

oracle.database_audit.session_id

指示审计会话 ID 编号。

关键字

oracle.database_audit.statement

与审计事件相关的语句 ID。

关键字

oracle.database_audit.status

数据库审计状态。

关键字

oracle.database_audit.terminal

终端标识符。

关键字
示例

以下是一个 database_audit 的示例事件

{
    "@timestamp": "2020-10-07T14:57:51.000Z",
    "agent": {
        "ephemeral_id": "c8ada4ef-14e4-462f-b998-dd8c711b4ec7",
        "id": "50560b92-4232-4158-b79d-9e6be7098c58",
        "name": "docker-fleet-agent",
        "type": "filebeat",
        "version": "8.10.2"
    },
    "client": {
        "user": {
            "name": "oracle"
        }
    },
    "data_stream": {
        "dataset": "oracle.database_audit",
        "namespace": "ep",
        "type": "logs"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "50560b92-4232-4158-b79d-9e6be7098c58",
        "snapshot": false,
        "version": "8.10.2"
    },
    "event": {
        "action": "database_audit",
        "agent_id_status": "verified",
        "category": [
            "database"
        ],
        "dataset": "oracle.database_audit",
        "ingested": "2023-10-05T12:18:05Z",
        "kind": "event",
        "outcome": "success",
        "timezone": "-04:00",
        "type": [
            "access"
        ]
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-fleet-agent",
        "id": "efe661d97f0c4d9883075c393da6b0d8",
        "ip": [
            "172.28.0.7"
        ],
        "mac": [
            "02-42-AC-1C-00-07"
        ],
        "name": "docker-fleet-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "5.15.90.1-microsoft-standard-WSL2",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.6 LTS (Focal Fossa)"
        }
    },
    "input": {
        "type": "filestream"
    },
    "log": {
        "file": {
            "device_id": 2080,
            "inode": 827222,
            "path": "/tmp/service_logs/ORCLCDB_ora_13765_20201007105751904399925443.aud.log"
        },
        "flags": [
            "multiline"
        ],
        "offset": 858
    },
    "oracle": {
        "database_audit": {
            "action": "CONNECT",
            "action_number": "100",
            "client": {
                "terminal": "pts/0"
            },
            "length": 253,
            "session_id": "4294967295",
            "status": "0"
        }
    },
    "process": {
        "pid": 13765
    },
    "related": {
        "hosts": [
            "testlab.local"
        ],
        "user": [
            "/",
            "oracle"
        ]
    },
    "server": {
        "address": "testlab.local",
        "domain": "testlab.local",
        "user": {
            "name": "/"
        }
    },
    "tags": [
        "oracle-database_audit"
    ],
    "user": {
        "roles": [
            "SYSDBA"
        ]
    }
}
表空间指标
编辑

表空间指标描述 Oracle 数据库中所有类型的表空间的表空间使用情况指标。

表空间指标还描述所有类型的表空间的扩展空间。

要收集表空间指标，Oracle 集成依赖于一组特定的视图。请确保在 Oracle DSN 配置中配置的用户具有对以下视图的 READ 访问权限

  • SYS.DBA_DATA_FILES
  • SYS.DBA_TEMP_FILES
  • DBA_FREE_SPACE
  • DBA_TABLESPACE_USAGE_METRICS
  • DBA_TABLESPACES

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型 单位 指标类型

@timestamp

事件时间戳。

日期

agent.id

此代理的唯一标识符（如果存在）。例如：对于 Beats，这将是 beat.id。

关键字

cloud.account.id

云账户或组织 ID，用于在多租户环境中标识不同的实体。示例：AWS 账户 ID、Google Cloud ORG ID 或其他唯一标识符。

关键字

cloud.availability_zone

此主机、资源或服务所在的可用区。

关键字

cloud.instance.id

主机机器的实例 ID。

关键字

cloud.provider

云提供商的名称。示例值包括 aws、azure、gcp 或 digitalocean。

关键字

cloud.region

此主机、资源或服务所在的区域。

关键字

container.id

唯一的容器 ID。

关键字

data_stream.dataset

数据流数据集。

常量关键字

data_stream.namespace

数据流命名空间。

常量关键字

data_stream.type

数据流类型。

常量关键字

event.dataset

事件模块

常量关键字

event.module

事件模块

常量关键字

host.name

主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。推荐值为主机的小写 FQDN。

关键字

oracle.tablespace.data_file.id

表空间唯一标识符。

长整型

oracle.tablespace.data_file.name

数据文件的文件名

关键字

oracle.tablespace.data_file.online_status

数据文件的最后已知在线状态。可以是 SYSOFF、SYSTEM、OFFLINE、ONLINE 或 RECOVER 之一。

关键字

oracle.tablespace.data_file.size.bytes

文件大小，以字节为单位

长整型

byte

gauge

oracle.tablespace.data_file.size.free.bytes

可供用户数据使用的文件大小。文件的实际大小减去此值用于存储文件相关的元数据。

长整型

byte

gauge

oracle.tablespace.data_file.size.max.bytes

最大文件大小，以字节为单位

长整型

byte

gauge

oracle.tablespace.data_file.status

文件状态：AVAILABLE 或 INVALID（INVALID 表示文件号未使用，例如，已删除的表空间中的文件）

关键字

oracle.tablespace.extended_space.free.bytes

总扩展可用表空间。

长整型

byte

gauge

oracle.tablespace.extended_space.total.bytes

总扩展表空间。

长整型

byte

gauge

oracle.tablespace.extended_space.used.bytes

总扩展已用表空间。

长整型

byte

gauge

oracle.tablespace.name

表空间名称

关键字

oracle.tablespace.query_id

自动生成的 ID，表示为获取结果而执行的 Oracle 查询。

关键字

oracle.tablespace.space.free.bytes

表空间总可用空闲空间，以字节为单位。

长整型

byte

gauge

oracle.tablespace.space.total.bytes

表空间总大小，以字节为单位。

长整型

byte

gauge

oracle.tablespace.space.used.bytes

表空间已用空间，以字节为单位。

长整型

byte

gauge

service.address

从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址（ipv4:port 或 [ipv6]:port）或资源路径（套接字）。

关键字

示例

关于 tablespace 的示例事件如下所示

{
    "@timestamp": "2024-07-16T06:22:19.048Z",
    "agent": {
        "ephemeral_id": "08f5dbe3-f515-4c7f-ab2c-711c048f294a",
        "id": "08b0c5bb-472a-42be-9e47-d06e205296b9",
        "name": "docker-custom-agent",
        "type": "metricbeat",
        "version": "8.13.0"
    },
    "data_stream": {
        "dataset": "oracle.tablespace",
        "namespace": "69805",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.0.0"
    },
    "elastic_agent": {
        "id": "08b0c5bb-472a-42be-9e47-d06e205296b9",
        "snapshot": false,
        "version": "8.13.0"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "oracle.tablespace",
        "duration": 1980031830,
        "ingested": "2024-07-16T06:22:31Z",
        "module": "sql"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-custom-agent",
        "id": "8259e024976a406e8a54cdbffeb84fec",
        "ip": [
            "192.168.253.5",
            "192.168.254.3"
        ],
        "mac": [
            "02-42-C0-A8-FD-05",
            "02-42-C0-A8-FE-03"
        ],
        "name": "docker-custom-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "4.18.0-348.7.1.el8_5.x86_64",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.6 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "query",
        "period": 60000
    },
    "oracle": {
        "tablespace": {
            "extended_space": {
                "free": {
                    "bytes": 32566738944
                },
                "total": {
                    "bytes": 32567787520
                }
            },
            "name": "USERS",
            "query_id": "0hxB8g4C+JnF8EuTG/7JQRJZ1oE="
        }
    },
    "service": {
        "address": "oracle:1521/ORCLCDB.localdomain",
        "type": "sql"
    }
}
Sysmetrics
编辑

下表列出了为长时间（60 秒）捕获的最新时间间隔的系统指标值。

为了收集 Sysmetrics 指标，Oracle 集成依赖于一组特定的视图。请确保在 Oracle DSN 配置中配置的用户具有对以下视图的 READ 访问权限

  • V$SYSMETRIC

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型 单位 指标类型

@timestamp

事件产生的日期/时间。这是从事件中提取的日期/时间，通常表示源生成事件的时间。如果事件源没有原始时间戳，则此值通常由管道第一次接收到事件的时间填充。所有事件的必填字段。

日期

agent.id

此代理的唯一标识符（如果存在）。例如：对于 Beats，这将是 beat.id。

关键字

cloud.account.id

云账户或组织 ID，用于在多租户环境中标识不同的实体。示例：AWS 账户 ID、Google Cloud ORG ID 或其他唯一标识符。

关键字

cloud.availability_zone

此主机、资源或服务所在的可用区。

关键字

cloud.project.id

云项目标识符。示例：Google Cloud 项目 ID，Azure 项目 ID。

关键字

cloud.provider

云提供商的名称。示例值包括 aws、azure、gcp 或 digitalocean。

关键字

cloud.region

此主机、资源或服务所在的区域。

关键字

container.id

唯一的容器 ID。

关键字

data_stream.dataset

该字段可以包含任何对于表示数据来源有意义的内容。示例包括 nginx.access、prometheus、endpoint 等。对于其他方面都符合条件，但没有设置数据集的数据流，我们使用值“generic”作为数据集值。event.dataset 应该与 data_stream.dataset 的值相同。除了上面提到的 Elasticsearch 数据流命名标准之外，dataset 值还有其他限制：* 不能包含 - * 长度不得超过 100 个字符

常量关键字

data_stream.namespace

用户定义的命名空间。命名空间对于允许数据分组很有用。许多用户已经以这种方式组织他们的索引，并且数据流命名方案现在将这种最佳实践作为默认值提供。许多用户将使用 default 填充此字段。如果不使用值，则会回退到 default。除了上面提到的 Elasticsearch 索引命名标准之外，namespace 值还有其他限制：* 不能包含 - * 长度不得超过 100 个字符

常量关键字

data_stream.type

数据流的总体类型。目前允许的值是“logs”和“metrics”。我们预计在不久的将来还会添加“traces”和“synthetics”。

常量关键字

event.dataset

事件模块

常量关键字

event.module

事件模块

常量关键字

host.name

主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。推荐值为主机的小写 FQDN。

关键字

oracle.sysmetric.active_parallel_sessions

活动的并行会话数

double

gauge

oracle.sysmetric.active_serial_sessions

活动的串行会话数。

double

gauge

oracle.sysmetric.average_active_sessions

平均活动会话数。

double

gauge

oracle.sysmetric.average_synchronous_single-block_read_latency

平均同步单块读取延迟。

double

gauge

oracle.sysmetric.background_checkpoints_per_sec

每秒后台检查点数。

double

gauge

oracle.sysmetric.background_cpu_usage_per_sec

每秒后台 CPU 使用率

double

gauge

oracle.sysmetric.background_time_per_sec

每秒后台时间。

double

gauge

oracle.sysmetric.branch_node_splits_per_sec

每秒分支节点拆分数。

double

gauge

oracle.sysmetric.branch_node_splits_per_txn

每个事务的分支节点拆分数。

double

gauge

oracle.sysmetric.buffer_cache_hit_ratio

缓冲区缓存命中率

double

gauge

oracle.sysmetric.captured_user_calls

捕获的用户调用数。

double

gauge

oracle.sysmetric.cell_physical_io_interconnect_bytes

单元物理 IO 互连字节数。

double

gauge

oracle.sysmetric.consistent_read_changes_per_sec

每秒一致性读取更改数。

double

gauge

oracle.sysmetric.consistent_read_changes_per_txn

每个事务的一致性读取更改数。

double

gauge

oracle.sysmetric.consistent_read_gets_per_sec

每秒一致性读取获取数。

double

gauge

oracle.sysmetric.consistent_read_gets_per_txn

每个事务的一致性读取获取数。

double

gauge

oracle.sysmetric.cpu_usage_per_sec

每秒 CPU 使用率。

double

gauge

oracle.sysmetric.cpu_usage_per_txn

每个事务的 CPU 使用率。

double

gauge

oracle.sysmetric.cr_blocks_created_per_sec

每秒创建的 CR 块数。

double

gauge

oracle.sysmetric.cr_blocks_created_per_txn

每个事务创建的 CR 块数。

double

gauge

oracle.sysmetric.cr_undo_records_applied_per_sec

每秒应用的 CR 撤消记录数。

double

gauge

oracle.sysmetric.cr_undo_records_applied_per_txn

每个事务应用的 CR 撤消记录数。

double

gauge

oracle.sysmetric.current_logons_count

当前登录数。

double

gauge

oracle.sysmetric.current_open_cursors_count

当前打开的游标数

double

gauge

oracle.sysmetric.current_os_load

当前操作系统负载

double

gauge

oracle.sysmetric.cursor_cache_hit_ratio

游标缓存命中率。

double

gauge

oracle.sysmetric.database_cpu_time_ratio

数据库 CPU 时间比率

double

gauge

oracle.sysmetric.database_time_per_sec

每秒数据库时间。

double

gauge

oracle.sysmetric.database_wait_time_ratio

数据库等待时间比率。

double

gauge

oracle.sysmetric.db_block_changes_per_sec

每秒数据库块更改数。

double

gauge

oracle.sysmetric.db_block_changes_per_txn

每个事务的数据库块更改数。

double

gauge

oracle.sysmetric.db_block_changes_per_user_call

每个用户调用的数据库块更改数。

double

gauge

oracle.sysmetric.db_block_gets_per_sec

每秒数据库块获取数

double

gauge

oracle.sysmetric.db_block_gets_per_txn

每个事务的数据库块获取数

double

gauge

oracle.sysmetric.db_block_gets_per_user_call

每个用户调用的数据库块获取数。

double

gauge

oracle.sysmetric.dbwr_checkpoints_per_sec

每秒数据库写入器检查点数。

double

gauge

oracle.sysmetric.ddl_statements_parallelized_per_sec

每秒并行化 DDL 语句数

double

gauge

oracle.sysmetric.disk_sort_per_sec

每秒磁盘排序数。

double

gauge

oracle.sysmetric.disk_sort_per_txn

每个事务的磁盘排序数。

double

gauge

oracle.sysmetric.dml_statements_parallelized_per_sec

每秒并行化 DML 语句数

double

gauge

oracle.sysmetric.enqueue_deadlocks_per_sec

每秒排队死锁数

double

gauge

oracle.sysmetric.enqueue_deadlocks_per_txn

每个事务的排队死锁数。

double

gauge

oracle.sysmetric.enqueue_requests_per_sec

每秒排队请求数。

double

gauge

oracle.sysmetric.enqueue_requests_per_txn

每个事务的排队请求数

double

gauge

oracle.sysmetric.enqueue_timeouts_per_sec

每秒排队超时数。

double

gauge

oracle.sysmetric.enqueue_timeouts_per_txn

每个事务的排队超时数。

double

gauge

oracle.sysmetric.enqueue_waits_per_sec

每秒排队等待数。

double

gauge

oracle.sysmetric.enqueue_waits_per_txn

每个事务的排队等待数。

double

gauge

oracle.sysmetric.execute_without_parse_ratio

无解析执行比率

double

gauge

oracle.sysmetric.executions_per_sec

每秒执行数。

double

gauge

oracle.sysmetric.executions_per_txn

每个事务的执行数。

double

gauge

oracle.sysmetric.executions_per_user_call

每个用户调用的执行数

double

gauge

oracle.sysmetric.full_index_scans_per_sec

每秒全索引扫描数。

double

gauge

oracle.sysmetric.full_index_scans_per_txn

每个事务的全索引扫描数。

double

gauge

oracle.sysmetric.gc_cr_block_received_per_second

每秒接收的 GC CR 块数。

double

gauge

oracle.sysmetric.gc_cr_block_received_per_txn

每个事务接收的 GC CR 块数。

double

gauge

oracle.sysmetric.gc_current_block_received_per_second

每秒接收的 GC 当前块数。

double

gauge

oracle.sysmetric.gc_current_block_received_per_txn

每个事务接收的 GC 当前块数

double

gauge

oracle.sysmetric.global_cache_average_cr_get_time

全局缓存平均 CR 获取时间。

double

gauge

oracle.sysmetric.global_cache_average_current_get_time

全局缓存平均当前获取时间

double

gauge

oracle.sysmetric.global_cache_blocks_corrupted

全局缓存块损坏数。

double

gauge

oracle.sysmetric.global_cache_blocks_lost

全局缓存块丢失数。

double

gauge

oracle.sysmetric.hard_parse_count_per_sec

每秒硬解析计数

double

gauge

oracle.sysmetric.hard_parse_count_per_txn

每个事务的硬解析计数。

double

gauge

oracle.sysmetric.host_cpu_usage_per_sec

每秒主机 CPU 使用率。

double

gauge

oracle.sysmetric.host_cpu_utilization_pct

主机 CPU 利用率百分比。

double

percent

gauge

oracle.sysmetric.io_megabytes_per_second

每秒 IO 兆字节数

double

gauge

oracle.sysmetric.io_requests_per_second

每秒 IO 请求数

double

gauge

oracle.sysmetric.leaf_node_splits_per_sec

每秒叶节点拆分数。

double

gauge

oracle.sysmetric.leaf_node_splits_per_txn

每个事务的叶节点拆分数。

double

gauge

oracle.sysmetric.library_cache_hit_ratio

库缓存命中率。

double

gauge

oracle.sysmetric.library_cache_miss_ratio

库缓存未命中率。

double

gauge

oracle.sysmetric.logical_reads_per_sec

每秒逻辑读取数。

double

gauge

oracle.sysmetric.logical_reads_per_txn

每个事务的逻辑读取数。

double

gauge

oracle.sysmetric.logical_reads_per_user_call

每个用户调用的逻辑读取数。

double

gauge

oracle.sysmetric.logons_per_sec

每秒登录数

double

gauge

oracle.sysmetric.logons_per_txn

每个事务的登录数。

double

gauge

oracle.sysmetric.long_table_scans_per_sec

每秒长表扫描数。

double

gauge

oracle.sysmetric.long_table_scans_per_txn

每个事务的长表扫描数。

double

gauge

oracle.sysmetric.memory_sorts_ratio

内存排序比率。

double

gauge

oracle.sysmetric.network_traffic_volume_per_sec

每秒网络流量。

double

gauge

oracle.sysmetric.open_cursors_per_sec

每秒打开的游标数

double

gauge

oracle.sysmetric.open_cursors_per_txn

每个事务打开的游标数

double

gauge

oracle.sysmetric.parse_failure_count_per_sec

每秒解析失败计数

double

gauge

oracle.sysmetric.parse_failure_count_per_txn

每个事务的解析失败计数。

double

gauge

oracle.sysmetric.pga_cache_hit_pct

Pga 缓存命中百分比。

double

percent

gauge

oracle.sysmetric.physical_read_bytes_per_sec

每秒物理读取字节数。

double

gauge

oracle.sysmetric.physical_read_io_requests_per_sec

每秒物理读取 IO 请求数。

double

gauge

oracle.sysmetric.physical_read_total_bytes_per_sec

每秒物理读取总字节数。

double

gauge

oracle.sysmetric.physical_read_total_io_requests_per_sec

每秒物理读取总 IO 请求数

double

gauge

oracle.sysmetric.physical_reads_direct_lobs_per_sec

每秒物理直接读取 LOB 数。

double

gauge

oracle.sysmetric.physical_reads_direct_lobs_per_txn

每个事务的物理直接读取 LOB 数。

double

gauge

oracle.sysmetric.physical_reads_direct_per_sec

每秒物理直接读取数。

double

gauge

oracle.sysmetric.physical_reads_direct_per_txn

每个事务的物理直接读取数。

double

gauge

oracle.sysmetric.physical_reads_per_sec

每秒物理读取数。

double

gauge

oracle.sysmetric.physical_reads_per_txn

每个事务的物理读取数。

double

gauge

oracle.sysmetric.physical_write_bytes_per_sec

每秒物理写入字节数。

double

gauge

oracle.sysmetric.physical_write_io_requests_per_sec

每秒物理写入 IO 请求数。

double

gauge

oracle.sysmetric.physical_write_total_bytes_per_sec

每秒物理写入总字节数。

double

gauge

oracle.sysmetric.physical_write_total_io_requests_per_sec

每秒物理写入总 IO 请求数。

double

gauge

oracle.sysmetric.physical_writes_direct_lobs__per_txn

每个事务的物理直接写入 LOB 数

double

gauge

oracle.sysmetric.physical_writes_direct_lobs_per_sec

每秒物理直接写入 LOB 数

double

gauge

oracle.sysmetric.physical_writes_direct_per_sec

每秒物理直接写入数。

double

gauge

oracle.sysmetric.physical_writes_direct_per_txn

每个事务的物理直接写入数。

double

gauge

oracle.sysmetric.physical_writes_per_sec

每秒物理写入次数。

double

gauge

oracle.sysmetric.physical_writes_per_txn

每次事务的物理写入次数。

double

gauge

oracle.sysmetric.pq_qc_session_count

Pq qc 会话计数。

double

gauge

oracle.sysmetric.pq_slave_session_count

Pq slave 会话计数。

double

gauge

oracle.sysmetric.process_limit_pct

进程限制百分比。

double

percent

gauge

oracle.sysmetric.px_downgraded_1_to_25pct_per_sec

每秒降级的 Px 1 到 25 百分比。

double

percent

gauge

oracle.sysmetric.px_downgraded_25_to_50pct_per_sec

每秒降级的 Px 25 到 50 百分比

double

percent

gauge

oracle.sysmetric.px_downgraded_50_to_75pct_per_sec

每秒降级的 Px 50 到 75 百分比。

double

percent

gauge

oracle.sysmetric.px_downgraded_75_to_99pct_per_sec

每秒降级的 Px 75 到 99 百分比。

double

percent

gauge

oracle.sysmetric.px_downgraded_to_serial_per_sec

每秒降级为串行的 Px。

double

gauge

oracle.sysmetric.px_operations_not_downgraded_per_sec

每秒未降级的 Px 操作次数。

double

gauge

oracle.sysmetric.queries_parallelized_per_sec

每秒并行化的查询次数。

double

gauge

oracle.sysmetric.recursive_calls_per_sec

每秒递归调用次数。

double

gauge

oracle.sysmetric.recursive_calls_per_txn

每次事务的递归调用次数。

double

gauge

oracle.sysmetric.redo_allocation_hit_ratio

重做分配命中率。

double

gauge

oracle.sysmetric.redo_generated_per_sec

每秒生成的重做次数。

double

gauge

oracle.sysmetric.redo_generated_per_txn

每次事务生成的重做次数。

double

gauge

oracle.sysmetric.redo_writes_per_sec

每秒重做写入次数。

double

gauge

oracle.sysmetric.redo_writes_per_txn

每次事务的重做写入次数。

double

gauge

oracle.sysmetric.replayed_user_calls

重放的用户调用。

double

gauge

oracle.sysmetric.response_time_per_txn

每次事务的响应时间。

double

gauge

oracle.sysmetric.row_cache_hit_ratio

行缓存命中率。

double

gauge

oracle.sysmetric.row_cache_miss_ratio

行缓存未命中率。

double

gauge

oracle.sysmetric.rows_per_sort

每次排序的行数。

double

gauge

oracle.sysmetric.run_queue_per_sec

每秒运行队列。

double

gauge

oracle.sysmetric.session_count

会话计数。

double

gauge

oracle.sysmetric.session_limit_pct

会话限制百分比。

double

percent

gauge

oracle.sysmetric.shared_pool_free_pct

共享池可用百分比。

double

percent

gauge

oracle.sysmetric.soft_parse_ratio

软解析率。

double

gauge

oracle.sysmetric.sql_service_response_time

Sql 服务响应时间。

double

gauge

oracle.sysmetric.streams_pool_usage_percentage

流池使用百分比。

double

gauge

oracle.sysmetric.temp_space_used

已使用的临时空间。

double

gauge

oracle.sysmetric.total_index_scans_per_sec

每秒总索引扫描次数。

double

gauge

oracle.sysmetric.total_index_scans_per_txn

每次事务的总索引扫描次数。

double

gauge

oracle.sysmetric.total_parse_count_per_sec

每秒总解析计数。

double

gauge

oracle.sysmetric.total_parse_count_per_txn

每次事务的总解析计数。

double

gauge

oracle.sysmetric.total_pga_allocated

已分配的总 pga。

double

gauge

oracle.sysmetric.total_pga_used_by_sql_workareas

sql 工作区使用的总 pga。

double

gauge

oracle.sysmetric.total_sorts_per_user_call

每次用户调用的总排序次数。

double

gauge

oracle.sysmetric.total_table_scans_per_sec

每秒总表扫描次数。

double

gauge

oracle.sysmetric.total_table_scans_per_txn

每次事务的总表扫描次数。

double

gauge

oracle.sysmetric.total_table_scans_per_user_call

每次用户调用的总表扫描次数。

double

gauge

oracle.sysmetric.txns_per_logon

每次登录的事务数。

double

gauge

oracle.sysmetric.user_calls_per_sec

每秒用户调用次数。

double

gauge

oracle.sysmetric.user_calls_per_txn

每次事务的用户调用次数。

double

gauge

oracle.sysmetric.user_calls_ratio

用户调用比率。

double

gauge

oracle.sysmetric.user_commits_per_sec

每秒用户提交次数。

double

gauge

oracle.sysmetric.user_commits_percentage

用户提交百分比。

double

gauge

oracle.sysmetric.user_limit_pct

用户限制百分比。

double

percent

gauge

oracle.sysmetric.user_rollback_undo_records_applied_per_txn

每次事务应用的用户回滚撤消记录数。

double

gauge

oracle.sysmetric.user_rollback_undorec_applied_per_sec

每秒应用的用户回滚撤消记录数。

double

gauge

oracle.sysmetric.user_rollbacks_per_sec

每秒用户回滚次数。

double

gauge

oracle.sysmetric.user_rollbacks_percentage

用户回滚百分比。

double

gauge

oracle.sysmetric.user_transaction_per_sec

每秒用户事务数。

double

gauge

oracle.sysmetric.vm_in_bytes_per_sec

每秒虚拟机输入字节数。

double

gauge

oracle.sysmetric.vm_out_bytes_per_sec

每秒虚拟机输出字节数。

double

gauge

oracle.sysmetric.workload_capture_and_replay_status

工作负载捕获和重放状态。

double

gauge

service.address

从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址（ipv4:port 或 [ipv6]:port）或资源路径（套接字）。

关键字

示例

以下是 sysmetric 的一个示例事件

{
    "@timestamp": "2022-11-09T04:28:12.009Z",
    "agent": {
        "ephemeral_id": "4d613e69-65ae-4c3a-9f60-8b600554574c",
        "id": "f4169ed3-d5c6-4775-bcad-5f4c0cca8a9f",
        "name": "docker-custom-agent",
        "type": "metricbeat",
        "version": "8.4.3"
    },
    "cloud": {
        "account": {
            "id": "elastic-obs-integrations-dev"
        },
        "availability_zone": "asia-south1-c",
        "instance": {
            "id": "3010911784348669868",
            "name": "service-integration-dev-idc-01"
        },
        "machine": {
            "type": "n1-standard-8"
        },
        "project": {
            "id": "elastic-obs-integrations-dev"
        },
        "provider": "gcp",
        "service": {
            "name": "GCE"
        }
    },
    "data_stream": {
        "dataset": "oracle.sysmetric",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "f4169ed3-d5c6-4775-bcad-5f4c0cca8a9f",
        "snapshot": false,
        "version": "8.4.3"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "oracle.sysmetric",
        "duration": 81013699,
        "ingested": "2022-11-09T04:28:12Z",
        "module": "sql"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-custom-agent",
        "id": "702b305d5bf3433b8efe81033888bd28",
        "ip": [
            "172.27.0.3",
            "192.168.240.4"
        ],
        "mac": [
            "02-42-AC-1F-00-07"
        ],
        "name": "docker-custom-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "5.4.0-1078-gcp",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.5 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "query",
        "period": 60000
    },
    "oracle": {
        "sysmetric": {
            "active_parallel_sessions": 0,
            "active_serial_sessions": 1,
            "average_active_sessions": 1.3158911021814,
            "average_synchronous_single-block_read_latency": 2.48382983655964,
            "background_checkpoints_per_sec": 0,
            "background_cpu_usage_per_sec": 5.41525258323766,
            "background_time_per_sec": 0.349192881745121,
            "branch_node_splits_per_sec": 0,
            "branch_node_splits_per_txn": 0,
            "buffer_cache_hit_ratio": 95.3592643642205,
            "captured_user_calls": 0,
            "cell_physical_io_interconnect_bytes": 2304267631,
            "consistent_read_changes_per_sec": 221.622655951014,
            "consistent_read_changes_per_txn": 214.481481481481,
            "consistent_read_gets_per_sec": 5360.58170685036,
            "consistent_read_gets_per_txn": 5187.85185185185,
            "cpu_usage_per_sec": 19.6512265595101,
            "cpu_usage_per_txn": 19.0180203703704,
            "cr_blocks_created_per_sec": 4.07577497129736,
            "cr_blocks_created_per_txn": 3.94444444444444,
            "cr_undo_records_applied_per_sec": 219.077688480674,
            "cr_undo_records_applied_per_txn": 212.018518518519,
            "current_logons_count": 58,
            "current_open_cursors_count": 23,
            "current_os_load": 2.939453125,
            "cursor_cache_hit_ratio": 290.424008021773,
            "database_cpu_time_ratio": 14.9337787351351,
            "database_time_per_sec": 131.58911021814,
            "database_wait_time_ratio": 85.0662212648649,
            "db_block_changes_per_sec": 631.094527363184,
            "db_block_changes_per_txn": 610.759259259259,
            "db_block_changes_per_user_call": 85.0025773195876,
            "db_block_gets_per_sec": 511.844623038653,
            "db_block_gets_per_txn": 495.351851851852,
            "db_block_gets_per_user_call": 68.9407216494845,
            "dbwr_checkpoints_per_sec": 0.0574052812858783,
            "ddl_statements_parallelized_per_sec": 0,
            "disk_sort_per_sec": 0,
            "disk_sort_per_txn": 0,
            "dml_statements_parallelized_per_sec": 0,
            "enqueue_deadlocks_per_sec": 0,
            "enqueue_deadlocks_per_txn": 0,
            "enqueue_requests_per_sec": 343.073096058171,
            "enqueue_requests_per_txn": 332.018518518519,
            "enqueue_timeouts_per_sec": 0.0765403750478377,
            "enqueue_timeouts_per_txn": 0.0740740740740741,
            "enqueue_waits_per_sec": 0.68886337543054,
            "enqueue_waits_per_txn": 0.666666666666667,
            "execute_without_parse_ratio": 57.5272325686462,
            "executions_per_sec": 762.380405663988,
            "executions_per_txn": 737.814814814815,
            "executions_per_user_call": 102.685567010309,
            "full_index_scans_per_sec": 13.4711060084194,
            "full_index_scans_per_txn": 13.037037037037,
            "gc_cr_block_received_per_second": 0,
            "gc_cr_block_received_per_txn": 0,
            "gc_current_block_received_per_second": 0,
            "gc_current_block_received_per_txn": 0,
            "global_cache_average_cr_get_time": 0,
            "global_cache_average_current_get_time": 0,
            "global_cache_blocks_corrupted": 0,
            "global_cache_blocks_lost": 0,
            "hard_parse_count_per_sec": 56.6398775353999,
            "hard_parse_count_per_txn": 54.8148148148148,
            "host_cpu_usage_per_sec": 118.637581324148,
            "host_cpu_utilization_pct": 14.8453213293746,
            "io_megabytes_per_second": 42.0398009950249,
            "io_requests_per_second": 209.395331037122,
            "leaf_node_splits_per_sec": 0.0765403750478377,
            "leaf_node_splits_per_txn": 0.0740740740740741,
            "library_cache_hit_ratio": 85.9758358371156,
            "library_cache_miss_ratio": 14.0241641628844,
            "logical_reads_per_sec": 5872.42632988902,
            "logical_reads_per_txn": 5683.2037037037,
            "logical_reads_per_user_call": 790.961340206186,
            "logons_per_sec": 2.39188672024493,
            "logons_per_txn": 2.31481481481481,
            "long_table_scans_per_sec": 0,
            "long_table_scans_per_txn": 0,
            "memory_sorts_ratio": 100,
            "network_traffic_volume_per_sec": 258.036739380023,
            "open_cursors_per_sec": 662.456946039036,
            "open_cursors_per_txn": 641.111111111111,
            "parse_failure_count_per_sec": 0.516647531572905,
            "parse_failure_count_per_txn": 0.5,
            "pga_cache_hit_pct": 100,
            "physical_read_bytes_per_sec": 2234538.07883659,
            "physical_read_io_requests_per_sec": 154.994259471871,
            "physical_read_total_bytes_per_sec": 23205621.1251435,
            "physical_read_total_io_requests_per_sec": 196.19211634137,
            "physical_reads_direct_lobs_per_sec": 0.0191350937619594,
            "physical_reads_direct_lobs_per_txn": 0.0185185185185185,
            "physical_reads_direct_per_sec": 0.248756218905473,
            "physical_reads_direct_per_txn": 0.240740740740741,
            "physical_reads_per_sec": 272.770761576732,
            "physical_reads_per_txn": 263.981481481481,
            "physical_write_bytes_per_sec": 3918.86720244929,
            "physical_write_io_requests_per_sec": 0.478377344048986,
            "physical_write_total_bytes_per_sec": 20886756.0466896,
            "physical_write_total_io_requests_per_sec": 34.7110600841944,
            "physical_writes_direct_lobs__per_txn": 0.0185185185185185,
            "physical_writes_direct_lobs_per_sec": 0.0191350937619594,
            "physical_writes_direct_per_sec": 0.191350937619594,
            "physical_writes_direct_per_txn": 0.185185185185185,
            "physical_writes_per_sec": 0.478377344048986,
            "physical_writes_per_txn": 0.462962962962963,
            "pq_qc_session_count": 0,
            "pq_slave_session_count": 0,
            "process_limit_pct": 32,
            "px_downgraded_1_to_25pct_per_sec": 0,
            "px_downgraded_25_to_50pct_per_sec": 0,
            "px_downgraded_50_to_75pct_per_sec": 0,
            "px_downgraded_75_to_99pct_per_sec": 0,
            "px_downgraded_to_serial_per_sec": 0,
            "px_operations_not_downgraded_per_sec": 0.114810562571757,
            "queries_parallelized_per_sec": 0.0382701875239189,
            "recursive_calls_per_sec": 3231.72598545733,
            "recursive_calls_per_txn": 3127.59259259259,
            "redo_allocation_hit_ratio": 99.9710060887214,
            "redo_generated_per_sec": 89624.2632988902,
            "redo_generated_per_txn": 86736.3703703704,
            "redo_writes_per_sec": 6.29544584768465,
            "redo_writes_per_txn": 6.09259259259259,
            "replayed_user_calls": 0,
            "response_time_per_txn": 127.349016666667,
            "row_cache_hit_ratio": 92.9547727525281,
            "row_cache_miss_ratio": 7.04522724747194,
            "rows_per_sort": 16.1167552157574,
            "run_queue_per_sec": 0,
            "session_count": 69,
            "session_limit_pct": 14.6186440677966,
            "shared_pool_free_pct": 15.3352475166321,
            "soft_parse_ratio": 82.5079777804042,
            "sql_service_response_time": 0.0406245755502782,
            "streams_pool_usage_percentage": 0,
            "temp_space_used": 0,
            "total_index_scans_per_sec": 732.548794489093,
            "total_index_scans_per_txn": 708.944444444445,
            "total_parse_count_per_sec": 323.804056639878,
            "total_parse_count_per_txn": 313.37037037037,
            "total_pga_allocated": 295197696,
            "total_pga_used_by_sql_workareas": 0,
            "total_sorts_per_user_call": 19.889175257732,
            "total_table_scans_per_sec": 42.7860696517413,
            "total_table_scans_per_txn": 41.4074074074074,
            "total_table_scans_per_user_call": 5.76288659793814,
            "txns_per_logon": 0.432,
            "user_calls_per_sec": 7.42441637964026,
            "user_calls_per_txn": 7.18518518518519,
            "user_calls_ratio": 0.229208757192311,
            "user_commits_per_sec": 1.01415996938385,
            "user_commits_percentage": 98.1481481481482,
            "user_limit_pct": 0.00000135041773350686,
            "user_rollback_undo_records_applied_per_txn": 25.7777777777778,
            "user_rollback_undorec_applied_per_sec": 26.6360505166475,
            "user_rollbacks_per_sec": 0.0191350937619594,
            "user_rollbacks_percentage": 1.85185185185185,
            "user_transaction_per_sec": 1.03329506314581,
            "vm_in_bytes_per_sec": 0,
            "vm_out_bytes_per_sec": 0,
            "workload_capture_and_replay_status": 0
        }
    },
    "service": {
        "address": "oracle:1521",
        "type": "sql"
    }
}
内存指标
编辑

程序全局区域 (PGA) 是一个内存区域，其中包含服务器进程的数据和控制信息。它是 Oracle 数据库在启动服务器进程时创建的非共享内存。对 PGA 的访问是服务器进程专有的。下面提到了有关程序全局区域 (PGA) 内存的指标。

要收集内存指标，Oracle 集成依赖于一组特定的视图。请确保在 Oracle DSN 配置中配置的用户具有对以下视图的 READ 访问权限

  • V$SGASTAT
  • V$PGASTAT

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型 单位 指标类型

@timestamp

事件时间戳。

日期

agent.id

此代理的唯一标识符（如果存在）。例如：对于 Beats，这将是 beat.id。

关键字

cloud.account.id

云账户或组织 ID，用于在多租户环境中标识不同的实体。示例：AWS 账户 ID、Google Cloud ORG ID 或其他唯一标识符。

关键字

cloud.availability_zone

此主机、资源或服务所在的可用区。

关键字

cloud.instance.id

主机机器的实例 ID。

关键字

cloud.provider

云提供商的名称。示例值包括 aws、azure、gcp 或 digitalocean。

关键字

cloud.region

此主机、资源或服务所在的区域。

关键字

container.id

唯一的容器 ID。

关键字

data_stream.dataset

数据流数据集。

常量关键字

data_stream.namespace

数据流命名空间。

常量关键字

data_stream.type

数据流类型。

常量关键字

event.dataset

事件模块

常量关键字

event.module

事件模块

常量关键字

host.name

主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。推荐值为主机的小写 FQDN。

关键字

oracle.memory.pga.aggregate_auto_target

Oracle 数据库可以用于在自动模式下运行的工作区的 PGA 内存量。

double

byte

gauge

oracle.memory.pga.aggregate_target_parameter

PGA_AGGREGATE_TARGET 初始化参数的当前值。如果未设置此参数，则其值为 0，并且禁用 PGA 内存的自动管理。

double

byte

gauge

oracle.memory.pga.cache_hit_pct

由 Oracle 数据库计算的指标，用于反映自实例启动以来 PGA 内存组件的性能。

double

percent

gauge

oracle.memory.pga.global_memory_bound

在自动模式下执行的工作区的最大大小。

double

byte

gauge

oracle.memory.pga.maximum_allocated

自实例启动以来一次分配的最大 PGA 内存字节数。

double

byte

gauge

oracle.memory.pga.total_allocated

实例当前分配的 PGA 内存量。

double

byte

gauge

oracle.memory.pga.total_freeable_memory

所有进程中可以释放回操作系统的 PGA 内存字节数。

double

byte

gauge

oracle.memory.pga.total_inuse

指示工作区当前消耗的 PGA 内存量。此数字可用于确定 PGA 内存的其他使用者（例如，PL/SQL 或 Java）消耗了多少内存。

double

byte

gauge

oracle.memory.pga.total_used_for_auto_workareas

指示在自动内存管理模式下运行的工作区当前消耗的 PGA 内存量。此数字可用于确定 PGA 内存的其他使用者（例如，PL/SQL 或 Java）消耗了多少内存。

double

byte

gauge

oracle.memory.sga.free_memory

共享池中的可用内存量。

double

byte

gauge

oracle.memory.sga.total_memory

共享池中的总内存量。

double

byte

gauge

service.address

从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址（ipv4:port 或 [ipv6]:port）或资源路径（套接字）。

关键字

示例

以下是 memory 的一个示例事件

{
    "@timestamp": "2022-11-09T04:21:05.327Z",
    "agent": {
        "ephemeral_id": "df8a2ae5-c832-4b31-a31d-226a455aff19",
        "id": "c2cd9bb5-503e-492f-b6b7-fd5c845a7574",
        "name": "docker-custom-agent",
        "type": "metricbeat",
        "version": "8.4.3"
    },
    "cloud": {
        "account": {
            "id": "elastic-obs-integrations-dev"
        },
        "availability_zone": "asia-south1-c",
        "instance": {
            "id": "3010911784348669868",
            "name": "service-integration-dev-idc-01"
        },
        "machine": {
            "type": "n1-standard-8"
        },
        "project": {
            "id": "elastic-obs-integrations-dev"
        },
        "provider": "gcp",
        "service": {
            "name": "GCE"
        }
    },
    "data_stream": {
        "dataset": "oracle.memory",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "c2cd9bb5-503e-492f-b6b7-fd5c845a7574",
        "snapshot": false,
        "version": "8.4.3"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "oracle.memory",
        "duration": 104106525,
        "ingested": "2022-11-09T04:21:06Z",
        "module": "sql"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-custom-agent",
        "id": "702b305d5bf3433b8efe81033888bd28",
        "ip": [
            "172.25.0.3",
            "192.168.240.4"
        ],
        "mac": [
            "02-42-AC-1F-00-07"
        ],
        "name": "docker-custom-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "5.4.0-1078-gcp",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.5 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "query",
        "period": 60000
    },
    "oracle": {
        "memory": {
            "pga": {
                "aggregate_auto_target": 593971200,
                "aggregate_target_parameter": 805306368,
                "cache_hit_pct": 100,
                "global_memory_bound": 104857600,
                "maximum_allocated": 361708544,
                "total_allocated": 197623808,
                "total_freeable_memory": 35061760,
                "total_inuse": 147043328,
                "total_used_for_auto_workareas": 0
            },
            "sga": {
                "free_memory": 33630360,
                "total_memory": 335544320
            }
        }
    },
    "service": {
        "address": "oracle:1521",
        "type": "sql"
    }
}
系统统计指标
编辑

系统全局区域 (SGA) 是一组共享内存结构，其中包含一个 Oracle 数据库实例的数据和控制信息。下面提到了有关系统全局区域 (SGA) 内存的指标。

要收集系统统计指标，Oracle 集成依赖于一组特定的视图。请确保在 Oracle DSN 配置中配置的用户具有对以下视图的 READ 访问权限

  • V$SYSSTAT

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型 单位 指标类型

@timestamp

事件时间戳。

日期

agent.id

此代理的唯一标识符（如果存在）。例如：对于 Beats，这将是 beat.id。

关键字

cloud.account.id

云账户或组织 ID，用于在多租户环境中标识不同的实体。示例：AWS 账户 ID、Google Cloud ORG ID 或其他唯一标识符。

关键字

cloud.availability_zone

此主机、资源或服务所在的可用区。

关键字

cloud.instance.id

主机机器的实例 ID。

关键字

cloud.provider

云提供商的名称。示例值包括 aws、azure、gcp 或 digitalocean。

关键字

cloud.region

此主机、资源或服务所在的区域。

关键字

container.id

唯一的容器 ID。

关键字

data_stream.dataset

数据流数据集。

常量关键字

data_stream.namespace

数据流命名空间。

常量关键字

data_stream.type

数据流类型。

常量关键字

event.dataset

事件模块

常量关键字

event.module

事件模块

常量关键字

host.name

主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。推荐值为主机的小写 FQDN。

关键字

oracle.system_statistics.bytes_received_via_sqlnet_from_client

通过 Oracle Net Services 从客户端收到的总字节数。

double

byte

计数器

oracle.system_statistics.bytes_received_via_sqlnet_from_dblink

通过 Oracle Net Services 从数据库链接收到的总字节数。

double

byte

计数器

oracle.system_statistics.bytes_sent_via_sqlnet_to_client

从前台进程发送到客户端的总字节数。

double

byte

计数器

oracle.system_statistics.bytes_sent_via_sqlnet_to_dblink

通过数据库链接发送的总字节数。

double

byte

计数器

oracle.system_statistics.cpu_used_by_this_session

从用户调用开始到结束，会话使用的 CPU 时间量（以十分之一毫秒为单位）。

double

毫秒

计数器

oracle.system_statistics.db_block_changes

此统计信息计算作为更新或删除操作的一部分对 SGA 中所有块进行的更改的总数。

double

计数器

oracle.system_statistics.db_block_gets_from_cache

从缓冲区缓存请求 CURRENT 块的次数。

double

计数器

oracle.system_statistics.db_time

所有 Oracle 进程的 CPU 消耗之和与非空闲等待时间之和。

double

计数器

oracle.system_statistics.dbwr_checkpoint_buffers_written

为检查点写入的缓冲区数。

double

计数器

oracle.system_statistics.dbwr_checkpoints

DBWR 被要求扫描缓存并写入标记为检查点或恢复结束的所有块的次数。

double

计数器

oracle.system_statistics.dml_statements_parallelized

以并行方式执行的 DML 语句的数量。

double

计数器

oracle.system_statistics.enqueue_conversions

表或行锁状态转换的总数。

double

计数器

oracle.system_statistics.enqueue_deadlocks

不同会话中表锁或行锁之间的死锁总数。

double

计数器

oracle.system_statistics.enqueue_releases

释放的表锁或行锁的总数。

double

计数器

oracle.system_statistics.enqueue_requests

获取的表锁或行锁的总数。

double

计数器

oracle.system_statistics.enqueue_timeouts

在完成之前超时的表锁和行锁（获取和转换）的总数。

double

计数器

oracle.system_statistics.enqueue_waits

在入队转换或获取期间，由于入队获取被延迟而发生的等待总数。

double

计数器

oracle.system_statistics.exchange_deadlocks

进程在交换两个缓冲区时检测到潜在的死锁并引发内部可重启错误的次数。索引扫描是唯一执行交换的操作。

double

计数器

oracle.system_statistics.execute_count

执行 SQL 语句的调用（用户调用和递归调用）总数。

double

计数器

oracle.system_statistics.gc_current_block_receive_time

完成一致性读取请求所需的总时间。它记录所有一致性读取块请求的往返时间。

double

计数器

oracle.system_statistics.index_fast_full_scans_direct_read

使用直接读取启动的快速全扫描次数。

double

计数器

oracle.system_statistics.index_fast_full_scans_full

使用直接读取启动的快速全扫描次数。

double

计数器

oracle.system_statistics.index_fast_full_scans_rowid_ranges

使用指定的 rowid 端点启动的快速全扫描次数。

double

计数器

oracle.system_statistics.java_call_heap_live_size

Java 调用堆的实时大小。

double

计数器

oracle.system_statistics.java_call_heap_total_size

Java 调用堆的总大小。

double

byte

计数器

oracle.system_statistics.java_call_heap_used_size

Java 调用堆的已用大小。

double

计数器

oracle.system_statistics.lob_reads

在会话/系统中执行的 LOB API 读取操作次数。

double

计数器

oracle.system_statistics.lob_writes

在会话/系统中执行的 LOB API 写入操作次数。

double

计数器

oracle.system_statistics.logons_current

当前登录的总数。

double

计数器

oracle.system_statistics.opened_cursors_current

当前打开的游标总数。

double

计数器

oracle.system_statistics.os_system_time_used

用于系统调用的总 CPU 时间。

double

计数器

oracle.system_statistics.os_user_time_used

用于用户调用的总 CPU 时间。

double

计数器

oracle.system_statistics.parallel_operations_not_downgraded

并行执行以请求的并行度执行的次数。

double

计数器

oracle.system_statistics.parse_count_hard

解析调用的总数（实际解析）。

double

计数器

oracle.system_statistics.parse_count_total

解析调用的总数（硬解析、软解析和描述）。

double

计数器

oracle.system_statistics.parse_time_cpu

用于解析的总 CPU 时间（硬解析和软解析），以十分之一毫秒为单位。

double

毫秒

计数器

oracle.system_statistics.parse_time_elapsed

解析的总经过时间，以十分之一毫秒为单位。

double

毫秒

计数器

oracle.system_statistics.physical_read_bytes

仅由应用程序活动（而不是其他实例活动）进行的所有磁盘读取的总大小（以字节为单位）。

double

byte

计数器

oracle.system_statistics.physical_read_io_requests

应用程序活动的读取请求数（主要是缓冲区缓存和直接加载操作），每次请求读取一个或多个数据库块。

double

计数器

oracle.system_statistics.physical_read_total_bytes

所有数据库实例活动（包括应用程序读取、备份和恢复以及其他实用程序）的磁盘读取的总大小（以字节为单位）。

double

byte

计数器

oracle.system_statistics.physical_read_total_io_requests

所有实例活动（包括应用程序、备份和恢复以及其他实用程序）读取一个或多个数据库块的读取请求数。

double

计数器

oracle.system_statistics.physical_reads

从磁盘读取的数据块总数。

double

计数器

oracle.system_statistics.physical_write_bytes

来自数据库应用程序活动（而非其他类型的实例活动）的所有磁盘写入的总大小（以字节为单位）。

double

byte

计数器

oracle.system_statistics.physical_write_io_requests

应用程序活动（主要是缓冲区缓存和直接加载操作）的写入请求数，每个请求写入一个或多个数据库块。

double

计数器

oracle.system_statistics.physical_write_total_bytes

数据库实例的所有磁盘写入的总大小（以字节为单位），包括应用程序活动、备份和恢复以及其他实用程序。

double

byte

计数器

oracle.system_statistics.physical_write_total_io_requests

来自所有实例活动（包括应用程序活动、备份和恢复以及其他实用程序）写入一个或多个数据库块的写入请求数。

double

计数器

oracle.system_statistics.physical_writes

写入磁盘的数据块总数。此统计值等于直接物理写入和来自缓存的物理写入值的总和。

double

计数器

oracle.system_statistics.physical_writes_direct

直接写入磁盘，绕过缓冲区缓存（如在直接加载操作中）的写入次数。

double

计数器

oracle.system_statistics.physical_writes_from_cache

从缓冲区缓存写入磁盘的数据块总数。这是“物理写入”统计的子集。

double

计数器

oracle.system_statistics.process_last_non_idle_time

此进程上次执行的时间。

double

计数器

oracle.system_statistics.queries_parallelized

并行执行的 SELECT 语句的数量。

double

计数器

oracle.system_statistics.recovery_blocks_read

恢复期间读取的块数。

double

计数器

oracle.system_statistics.recursive_calls

在用户和系统级别生成的递归调用数。

double

计数器

oracle.system_statistics.recursive_cpu_usage

非用户调用（递归调用）使用的总 CPU 时间。

double

计数器

oracle.system_statistics.redo_blocks_written

写入的重做块总数。

double

计数器

oracle.system_statistics.redo_buffer_allocation_retries

在重做缓冲区中分配空间所需的重试总数。

double

计数器

oracle.system_statistics.redo_log_space_requests

活动日志文件已满，Oracle 必须等待为重做日志条目分配磁盘空间的次数。

double

计数器

oracle.system_statistics.redo_log_space_wait_time

在重做日志缓冲区中等待可用空间的等待总时间（以百分之一秒为单位）。

double

计数器

oracle.system_statistics.redo_size

生成的重做总大小（以字节为单位）。

double

byte

计数器

oracle.system_statistics.redo_synch_time

所有重做同步写入调用的总耗时（以 10 毫秒为单位）。

double

毫秒

计数器

oracle.system_statistics.redo_write_time

从重做日志缓冲区写入当前重做日志文件的总耗时（以微秒为单位）。

double

微秒

计数器

oracle.system_statistics.redo_writes

LGWR 向重做日志文件写入的总次数。

double

计数器

oracle.system_statistics.session_cursor_cache_count

缓存的游标总数。

double

计数器

oracle.system_statistics.session_cursor_cache_hits

缓存的游标总数。

double

计数器

oracle.system_statistics.session_logical_reads

db block gets 加 consistent gets 的总和。这包括从缓冲区缓存或进程私有内存进行的数据库块的逻辑读取。

double

计数器

oracle.system_statistics.session_stored_procedure_space

此会话用于存储过程的内存量。

double

计数器

oracle.system_statistics.smon_posted_for_instance_recovery

SMON 为实例恢复发布的总次数或次数。

double

计数器

oracle.system_statistics.smon_posted_for_txn_recovery_for_other_instances

SMON 为实例恢复发布的总次数或次数。

double

计数器

oracle.system_statistics.sorts_disk

需要至少一次磁盘写入的排序操作数。

double

计数器

oracle.system_statistics.sorts_memory

完全在内存中执行且不需要任何磁盘写入的排序操作数。

double

计数器

oracle.system_statistics.sorts_rows

排序的行总数。

double

计数器

oracle.system_statistics.table_scan_rows_gotten

扫描操作期间处理的行数。

double

计数器

oracle.system_statistics.table_scans_direct_read

执行直接读取（绕过缓冲区缓存）的表扫描数。

double

计数器

oracle.system_statistics.table_scans_long_tables

长表（或相反的短表）可以定义为不满足短表标准的表。

double

计数器

oracle.system_statistics.table_scans_rowid_ranges

在并行查询期间，使用指定的 ROWID 范围进行的表扫描数。

double

计数器

oracle.system_statistics.transaction_rollbacks

成功回滚的事务数。

double

计数器

oracle.system_statistics.user_calls

用户调用（如登录、解析、提取或执行）的次数。

double

计数器

oracle.system_statistics.user_commits

用户提交的次数。当用户提交事务时，必须将反映对数据库块所做更改的生成的重做写入磁盘。

double

计数器

oracle.system_statistics.user_rollbacks

用户手动发出 ROLLBACK 语句或用户事务期间发生错误的次数。

double

计数器

service.address

从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址（ipv4:port 或 [ipv6]:port）或资源路径（套接字）。

关键字

示例

以下是 system_statistics 的示例事件

{
    "@timestamp": "2022-11-09T04:31:54.386Z",
    "agent": {
        "ephemeral_id": "a4fc8cc8-ffc8-41ca-95c0-84e4f17bf1d1",
        "id": "cb76e254-12e8-4c08-9044-4fe4255975da",
        "name": "docker-custom-agent",
        "type": "metricbeat",
        "version": "8.4.3"
    },
    "cloud": {
        "account": {
            "id": "elastic-obs-integrations-dev"
        },
        "availability_zone": "asia-south1-c",
        "instance": {
            "id": "3010911784348669868",
            "name": "service-integration-dev-idc-01"
        },
        "machine": {
            "type": "n1-standard-8"
        },
        "project": {
            "id": "elastic-obs-integrations-dev"
        },
        "provider": "gcp",
        "service": {
            "name": "GCE"
        }
    },
    "data_stream": {
        "dataset": "oracle.system_statistics",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "cb76e254-12e8-4c08-9044-4fe4255975da",
        "snapshot": false,
        "version": "8.4.3"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "oracle.system_statistics",
        "duration": 79970148,
        "ingested": "2022-11-09T04:31:55Z",
        "module": "sql"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-custom-agent",
        "id": "702b305d5bf3433b8efe81033888bd28",
        "ip": [
            "172.28.0.3",
            "192.168.240.4"
        ],
        "mac": [
            "02-42-AC-1F-00-07"
        ],
        "name": "docker-custom-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "5.4.0-1078-gcp",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.5 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "query",
        "period": 60000
    },
    "oracle": {
        "system_statistics": {
            "bytes_received_via_sqlnet_from_client": 15982,
            "bytes_received_via_sqlnet_from_dblink": 0,
            "bytes_sent_via_sqlnet_to_client": 25891,
            "bytes_sent_via_sqlnet_to_dblink": 0,
            "cpu_used_by_this_session": 1794,
            "db_block_changes": 31677,
            "db_block_gets_from_cache": 27540,
            "db_time": 64115,
            "dbwr_checkpoint_buffers_written": 0,
            "dbwr_checkpoints": 3,
            "dml_statements_parallelized": 0,
            "enqueue_conversions": 610,
            "enqueue_deadlocks": 0,
            "enqueue_releases": 28193,
            "enqueue_requests": 28233,
            "enqueue_timeouts": 9,
            "enqueue_waits": 53,
            "exchange_deadlocks": 0,
            "execute_count": 53587,
            "gc_current_block_receive_time": 0,
            "index_fast_full_scans_direct_read": 0,
            "index_fast_full_scans_full": 858,
            "index_fast_full_scans_rowid_ranges": 0,
            "java_call_heap_live_size": 0,
            "java_call_heap_total_size": 0,
            "java_call_heap_used_size": 0,
            "lob_reads": 126,
            "lob_writes": 206,
            "logons_current": 41,
            "opened_cursors_current": 25,
            "os_system_time_used": 0,
            "os_user_time_used": 0,
            "parallel_operations_not_downgraded": 8,
            "parse_count_hard": 4131,
            "parse_count_total": 20224,
            "parse_time_cpu": 560,
            "parse_time_elapsed": 1338,
            "physical_read_bytes": 143785984,
            "physical_read_io_requests": 10758,
            "physical_read_total_bytes": 1264044544,
            "physical_read_total_io_requests": 13539,
            "physical_reads": 17552,
            "physical_write_bytes": 188416,
            "physical_write_io_requests": 23,
            "physical_write_total_bytes": 1094185289,
            "physical_write_total_io_requests": 2209,
            "physical_writes": 23,
            "physical_writes_direct": 14,
            "physical_writes_from_cache": 9,
            "process_last_non_idle_time": 1667968313,
            "queries_parallelized": 2,
            "recovery_blocks_read": 0,
            "recursive_calls": 220113,
            "recursive_cpu_usage": 1462,
            "redo_blocks_written": 9478,
            "redo_buffer_allocation_retries": 4,
            "redo_log_space_requests": 4,
            "redo_log_space_wait_time": 2,
            "redo_size": 4568196,
            "redo_synch_time": 73,
            "redo_write_time": 277,
            "redo_writes": 476,
            "session_cursor_cache_count": 4017,
            "session_cursor_cache_hits": 52537,
            "session_logical_reads": 371800,
            "session_stored_procedure_space": 0,
            "smon_posted_for_instance_recovery": 0,
            "smon_posted_for_txn_recovery_for_other_instances": 0,
            "sorts_disk": 0,
            "sorts_memory": 11360,
            "sorts_rows": 153397,
            "table_scan_rows_gotten": 3049493,
            "table_scans_direct_read": 0,
            "table_scans_long_tables": 0,
            "table_scans_rowid_ranges": 0,
            "transaction_rollbacks": 6,
            "user_calls": 564,
            "user_commits": 62,
            "user_rollbacks": 1
        }
    },
    "service": {
        "address": "oracle:1521",
        "type": "sql"
    }
}
性能指标
编辑

性能指标概述了系统中花费时间的位置，并可以比较系统中不同位置的等待时间。

要收集性能指标，Oracle 集成依赖于一组特定的视图。请确保在 Oracle DSN 配置中配置的用户对以下视图具有 READ 访问权限

  • V$BUFFER_POOL_STATISTICS
  • V$SESSTAT
  • V$SYSSTAT
  • V$LIBRARYCACHE
  • DBA_JOBS
  • GV$SESSION
  • V$SYSTEM_WAIT_CLASS

ECS 字段参考

有关 ECS 字段的详细信息，请参阅以下文档。

导出的字段
字段 描述 类型 单位 指标类型

@timestamp

事件产生的日期/时间。这是从事件中提取的日期/时间，通常表示源生成事件的时间。如果事件源没有原始时间戳，则此值通常由管道第一次接收到事件的时间填充。所有事件的必填字段。

日期

agent.id

此代理的唯一标识符（如果存在）。例如：对于 Beats，这将是 beat.id。

关键字

cloud.account.id

云账户或组织 ID，用于在多租户环境中标识不同的实体。示例：AWS 账户 ID、Google Cloud ORG ID 或其他唯一标识符。

关键字

cloud.availability_zone

此主机、资源或服务所在的可用区。

关键字

cloud.instance.id

主机机器的实例 ID。

关键字

cloud.provider

云提供商的名称。示例值包括 aws、azure、gcp 或 digitalocean。

关键字

cloud.region

此主机、资源或服务所在的区域。

关键字

container.id

唯一的容器 ID。

关键字

data_stream.dataset

该字段可以包含任何对于表示数据来源有意义的内容。示例包括 nginx.access、prometheus、endpoint 等。对于其他方面都符合条件，但没有设置数据集的数据流，我们使用值“generic”作为数据集值。event.dataset 应该与 data_stream.dataset 的值相同。除了上面提到的 Elasticsearch 数据流命名标准之外，dataset 值还有其他限制：* 不能包含 - * 长度不得超过 100 个字符

常量关键字

data_stream.namespace

用户定义的命名空间。命名空间对于允许数据分组很有用。许多用户已经以这种方式组织他们的索引，并且数据流命名方案现在将这种最佳实践作为默认值提供。许多用户将使用 default 填充此字段。如果不使用值，则会回退到 default。除了上面提到的 Elasticsearch 索引命名标准之外，namespace 值还有其他限制：* 不能包含 - * 长度不得超过 100 个字符

常量关键字

data_stream.type

数据流的总体类型。目前允许的值是“logs”和“metrics”。我们预计在不久的将来还会添加“traces”和“synthetics”。

常量关键字

event.dataset

事件模块

常量关键字

event.module

事件模块

常量关键字

host.name

主机的名称。它可以包含 Unix 系统上 hostname 返回的内容、完全限定域名 (FQDN) 或用户指定的名称。推荐值为主机的小写 FQDN。

关键字

oracle.performance.buffer_pool

实例中缓冲区池的名称。

关键字

oracle.performance.cache.buffer.hit.pct

指定缓冲区池的缓存命中率。

double

percent

gauge

oracle.performance.cache.get.consistent

一致性获取统计信息。

长整型

gauge

oracle.performance.cache.get.db_blocks

获取的数据库块。

长整型

gauge

oracle.performance.cache.physical_reads

物理读取。此指标表示在一段时间内每秒从磁盘读取的数据块数。

长整型

gauge

oracle.performance.cursors.avg

按用户名和机器打开的平均游标数。

double

gauge

oracle.performance.cursors.cache_hit.pct

会话游标缓存命中率与游标总数的比率。

double

percent

gauge

oracle.performance.cursors.max

按用户名和机器打开的最大游标数。

double

gauge

oracle.performance.cursors.opened.current

当前打开的游标总数。

长整型

gauge

oracle.performance.cursors.opened.total

自实例启动以来打开的游标总数。

长整型

计数器

oracle.performance.cursors.parse.real

发生的“实际解析数：会话游标缓存命中数 - 解析计数（总数）”。

double

gauge

oracle.performance.cursors.parse.total

解析调用（硬解析和软解析）的总数。软解析是检查共享池中已有的对象，以验证基础对象的权限是否已更改。

长整型

gauge

oracle.performance.cursors.session.cache_hits

会话游标缓存中的命中数。命中表示 SQL 语句不必重新解析。

double

gauge

oracle.performance.cursors.total

按用户名和机器打开的游标总数。

double

gauge

oracle.performance.failed_db_jobs

此指标检查失败的 DBMS 作业。

double

gauge

oracle.performance.io_reloads

引脚重载比率。重载是指自创建对象句柄以来执行的任何非第一次执行的对象引脚，并且需要从磁盘加载对象。引脚是请求此命名空间的对象引脚的次数。

double

gauge

oracle.performance.lock_requests

gethits 和 gets 之间的比率的平均值，其中 gethits 是在内存中找到对象句柄的次数，gets 是请求此命名空间的对象锁的次数。

double

gauge

oracle.performance.machine

操作系统计算机名称。

关键字

oracle.performance.pin_requests

所有 pinhits/pins 比率的平均值，其中 PinHits 是在内存中找到库对象的所有元数据部分的次数，pins 是请求此命名空间的对象引脚的次数。

double

gauge

oracle.performance.query_id

自动生成的 ID，表示为获取结果而执行的 Oracle 查询。

关键字

oracle.performance.session_count.active

会话总数。

double

gauge

oracle.performance.session_count.inactive

非活动会话的总数。

double

gauge

oracle.performance.session_count.inactive_morethan_onehr

超过一小时的非活动会话总数。

double

gauge

oracle.performance.username

Oracle 用户名

关键字

oracle.performance.wait.pct_time

不是空闲等待类的等待时间的百分比。

double

percent

gauge

oracle.performance.wait.pct_waits

不是空闲等待类的 pct 时间等待数的百分比。

double

percent

gauge

oracle.performance.wait.time_waited_secs

会话在等待类中花费的时间量。

double

秒

gauge

oracle.performance.wait.total_waits

会话发生此类等待的次数。

double

计数器

oracle.performance.wait.wait_class

每个等待事件都属于一类等待事件。等待类可以是以下之一 - 管理、应用程序、集群、提交、并发、配置、空闲、网络、其他、调度程序、系统 IO、用户 IO

关键字

service.address

从中收集有关此服务的数据的地址。这应该是一个 URI、网络地址（ipv4:port 或 [ipv6]:port）或资源路径（套接字）。

关键字

示例

以下是 performance 的示例事件

{
    "@timestamp": "2022-11-09T04:24:38.581Z",
    "agent": {
        "ephemeral_id": "622d8585-de9d-4fbf-8a16-0f16a7cc5429",
        "id": "a7ec6f52-409e-4f25-80e6-a221e04812c7",
        "name": "docker-custom-agent",
        "type": "metricbeat",
        "version": "8.4.3"
    },
    "cloud": {
        "account": {
            "id": "elastic-obs-integrations-dev"
        },
        "availability_zone": "asia-south1-c",
        "instance": {
            "id": "3010911784348669868",
            "name": "service-integration-dev-idc-01"
        },
        "machine": {
            "type": "n1-standard-8"
        },
        "project": {
            "id": "elastic-obs-integrations-dev"
        },
        "provider": "gcp",
        "service": {
            "name": "GCE"
        }
    },
    "data_stream": {
        "dataset": "oracle.performance",
        "namespace": "ep",
        "type": "metrics"
    },
    "ecs": {
        "version": "8.11.0"
    },
    "elastic_agent": {
        "id": "a7ec6f52-409e-4f25-80e6-a221e04812c7",
        "snapshot": false,
        "version": "8.4.3"
    },
    "event": {
        "agent_id_status": "verified",
        "dataset": "oracle.performance",
        "duration": 93046359,
        "ingested": "2022-11-09T04:24:38Z",
        "module": "sql"
    },
    "host": {
        "architecture": "x86_64",
        "containerized": true,
        "hostname": "docker-custom-agent",
        "id": "702b305d5bf3433b8efe81033888bd28",
        "ip": [
            "172.26.0.3",
            "192.168.240.4"
        ],
        "mac": [
            "02-42-AC-1F-00-07"
        ],
        "name": "docker-custom-agent",
        "os": {
            "codename": "focal",
            "family": "debian",
            "kernel": "5.4.0-1078-gcp",
            "name": "Ubuntu",
            "platform": "ubuntu",
            "type": "linux",
            "version": "20.04.5 LTS (Focal Fossa)"
        }
    },
    "metricset": {
        "name": "query",
        "period": 60000
    },
    "oracle": {
        "performance": {
            "buffer_pool": "DEFAULT",
            "cache": {
                "buffer": {
                    "hit": {
                        "pct": 0.952424765502866
                    }
                },
                "get": {
                    "consistent": 344187,
                    "db_blocks": 24261
                },
                "physical_reads": 17529
            }
        }
    },
    "service": {
        "address": "oracle:1521",
        "type": "sql"
    }
}

变更日志

编辑
变更日志
版本 详细信息 Kibana 版本

1.28.0

增强 (查看拉取请求)
添加扩展表空间指标。

8.13.0 或更高版本

1.27.0

增强 (查看拉取请求)
ECS 版本已更新至 8.11.0。将 kibana 约束更新为 ^8.13.0。修改了字段定义，以删除 ecs@mappings 组件模板中已变得冗余的 ECS 字段。

8.13.0 或更高版本

1.26.1

错误修复 (查看拉取请求)
修复表空间数据流的 oracle.tablespace.space.used.bytes 逻辑。

8.12.0 或更高版本

1.26.0

增强 (查看拉取请求)
为 password 字段启用密钥，并添加 username 和 password 字段。

8.12.0 或更高版本

1.25.0

增强 (查看拉取请求)
在 data_stream.dataset 上添加全局筛选器以提高性能。

8.10.2 或更高版本

1.24.3

错误修复 (查看拉取请求)
关于强制用户权限的自述文件更新。

8.10.2 或更高版本

1.24.2

错误修复 (查看拉取请求)
关于 DSN 格式的自述文件更新。

8.10.2 或更高版本

1.24.1

增强 (查看拉取请求)
使 Oracle DSN 配置详细信息更易于发现。

8.10.2 或更高版本

1.24.0

增强 (查看拉取请求)
记录添加运行时库路径的替代方法。

8.10.2 或更高版本

1.23.0

增强 (查看拉取请求)
向可视化添加自定义数字格式。

8.10.2 或更高版本

1.22.0

增强 (查看拉取请求)
将软件包 format_version 更新为 3.0.0。

8.8.0 或更高版本

1.21.0

增强功能 (查看拉取请求)
调整字段以适应文件系统信息的更改

8.8.0 或更高版本

1.20.2

缺陷修复 (查看拉取请求)
为重命名处理器添加空值检查和 ignore_missing 检查

8.8.0 或更高版本

1.20.1

缺陷修复 (查看拉取请求)
解决 Performance 数据流中的 ORA-01476 错误。

8.8.0 或更高版本

1.20.0

增强功能 (查看拉取请求)
添加对处理器的支持

8.8.0 或更高版本

1.19.0

增强功能 (查看拉取请求)
为指标数据集启用时间序列数据流。这大大减少了指标的存储空间，并有望逐步提高查询性能。有关更多详细信息，请参阅 https://elastic.ac.cn/guide/en/elasticsearch/reference/current/tsds.html。

8.8.0 或更高版本

1.18.0

增强功能 (查看拉取请求)
将所有权从 obs-service-integrations 重命名为 obs-infraobs-integrations

8.6.0 或更高版本

1.17.2

缺陷修复 (查看拉取请求)
修复所有数据流的维度字段。

8.6.0 或更高版本

1.17.1

缺陷修复 (查看拉取请求)
修复 Performance 数据流可视化的聚合。

8.6.0 或更高版本

1.17.0

增强功能 (查看拉取请求)
将 Overview 仪表板可视化迁移到 lens

8.6.0 或更高版本

1.16.0

增强功能 (查看拉取请求)
将 Performance 仪表板可视化迁移到 lens

—

1.15.0

增强功能 (查看拉取请求)
将 System Statistics 仪表板可视化迁移到 lens

—

1.14.0

增强功能 (查看拉取请求)
将 Tablespace 仪表板可视化迁移到 lens

—

1.13.0

增强功能 (查看拉取请求)
将 Memory 仪表板可视化迁移到 lens

—

1.12.0

增强功能 (查看拉取请求)
将 Sysmetric 仪表板可视化迁移到 lens

—

1.11.2

增强功能 (查看拉取请求)
更新了所有数据流的维度字段映射。

8.3.0 或更高版本

1.11.1

增强功能 (查看拉取请求)
添加了类别和/或子类别。

8.3.0 或更高版本

1.11.0

增强功能 (查看拉取请求)
向所有数据集添加维度字段，以支持 TSDB 启用。

8.3.0 或更高版本

1.10.1

缺陷修复 (查看拉取请求)
仪表板修复，以表示“解析计数”和“缓存命中百分比值”

8.3.0 或更高版本

1.10.0

增强功能 (查看拉取请求)
将包更新到 ECS 8.6.0。

8.3.0 或更高版本

1.9.2

增强功能 (查看拉取请求)
在 README 中包含了支持的主机配置的详细信息。

8.3.0 或更高版本

1.9.1

增强功能 (查看拉取请求)
添加了系统测试文件。

8.3.0 或更高版本

1.9.0

增强功能 (查看拉取请求)
添加了基础设施类别。

8.3.0 或更高版本

1.8.0

增强功能 (查看拉取请求)
将包更新到 ECS 8.5.0。

8.3.0 或更高版本

1.7.0

增强功能 (查看拉取请求)
添加了对仅包含操作的其他数据库审计事件的支持。

8.3.0 或更高版本

1.6.0

增强功能 (查看拉取请求)
添加了对数据库审计事件的支持，最初它仅支持对象。

8.3.0 或更高版本

1.5.0

缺陷修复 (查看拉取请求)
添加了对特殊格式的操作行的支持。

8.3.0 或更高版本

1.4.2

缺陷修复 (查看拉取请求)
修复了 Performance 数据流中的管道问题。

8.3.0 或更高版本

1.4.1

缺陷修复 (查看拉取请求)
删除重复字段。

8.3.0 或更高版本

1.4.0

增强功能 (查看拉取请求)
增强功能，以捕获系统统计信息指标、pga 指标、sga 指标。

8.3.0 或更高版本

1.3.0

增强功能 (查看拉取请求)
将包更新到 ECS 8.4.0

8.3.0 或更高版本

1.2.0

增强功能 (查看拉取请求)
增强功能，以捕获 Oracle 数据库的性能、表空间和系统指标数据

8.3.0 或更高版本

1.1.1

增强功能 (查看拉取请求)
更新包名称和描述，以与标准措辞保持一致

7.17.0 或更高版本
8.0.0 或更高版本

1.1.0

增强功能 (查看拉取请求)
将包更新到 ECS 8.3.0。

7.17.0 或更高版本
8.0.0 或更高版本

1.0.2

缺陷修复 (查看拉取请求)
支持在 oracle 日志的摄取管道中解析两位数日期

7.17.0 或更高版本
8.0.0 或更高版本

1.0.1

增强功能 (查看拉取请求)
添加了多字段的文档

7.17.0 或更高版本
8.0.0 或更高版本

1.0.0

增强功能 (查看拉取请求)
初始发布

7.17.0 或更高版本
8.0.0 或更高版本
« Oracle Oracle WebLogic 集成 »