SQL 输入

编辑

版本

0.5.0 [beta] 此功能为 beta 版本,可能会发生更改。设计和代码不如官方 GA 功能成熟,按原样提供,不提供任何保证。Beta 功能不受官方 GA 功能的支持 SLA 约束。 (查看全部)

兼容的 Kibana 版本

8.13.0 或更高版本

支持的 Serverless 项目类型
这是什么?

安全性
可观测性

订阅级别
这是什么?

基础

SQL 输入包允许您针对 SQL 数据库执行自定义查询,并将结果存储在 Elasticsearch 中。

此输入包支持以下列出的数据库

  • MySQL
  • Oracle
  • Microsoft SQL
  • PostgreSQL

用户配置选项

编辑

主机

编辑

应指定从中获取指标的主机配置。它根据您运行的驱动程序而有所不同

MySQL
编辑

支持的配置采用以下形式

  • <user>:<password>@tcp(<host>:<port>)/

支持的配置示例,如下所示

  • root:root@tcp(localhost:3306)/
Oracle
编辑

支持以下两种类型的主机配置

  1. 旧式主机配置

    1. hosts: ["user/[email protected]:1521/ORCLPDB1.localdomain"]
    2. hosts: ["user/[email protected]:1521/ORCLPDB1.localdomain as sysdba"]
  2. DSN 主机配置

    1. hosts: ['user="user" password="pass" connectString="0.0.0.0:1521/ORCLPDB1.localdomain"']
    2. hosts: ['user="user" password="password" connectString="host:port/service_name" sysdba=true']
MSSQL
编辑

支持的配置采用以下形式

  • sqlserver://<user>:<password>@<host>

支持的配置示例如下所示

  • sqlserver://root:test@localhost
PostgreSQL
编辑

支持的配置采用以下形式

  • postgres://<user>:<password>@<connection_string>

支持的配置示例,如下所示

  • postgres://postgres:postgres@localhost:5432/stuff?sslmode=disable

如果密码包含反斜杠 (\) 字符,则必须使用反斜杠进行转义。例如,如果密码是 my_password,则应将其写为 my\_password

驱动程序

编辑

指定要为其运行查询的驱动程序。以下是支持的驱动程序

  • mysql
  • oracle
  • mssql
  • postgres

SQL_Queries

编辑

接收要执行的查询列表。重复查询和 response_format 以获取多个查询输入。

例如
sql_queries

  • query: SHOW GLOBAL STATUS LIKE Innodb_system%

    response_format: variables

response_format: 这可以是 variables 或 table

variables:期望一个看起来像键/值结果的两列表格。左列被视为键,右列被视为值。此模式在每次获取操作时生成单个事件。

table:期望任意数量的列。此模式为每行生成单个事件。

有关 response format 的更多示例,请参考此处

合并结果

编辑

将多个查询合并到单个事件中。

多个查询将创建多个事件,每个查询一个事件。最好通过将指标合并到单个事件中来创建一个事件。

可以使用 merge_results 配置启用此功能。

merge_results 可以合并 response format 为“variable”的查询。但是,对于 response format 为“table”的查询,只有在每个 table 查询生成单行时才可能合并。

例如,如果我们有以下 2 个针对 PostgreSQL 的查询

sql_queries

  • query: "SELECT blks_hit,blks_read FROM pg_stat_database LIMIT 1;" response_format: table
  • query: "SELECT checkpoints_timed,checkpoints_req FROM pg_stat_bgwriter;" response_format: table

merge_results 功能将创建一个组合事件,其中 blks_hitblks_readcheckpoints_timedcheckpoints_req 是同一事件的一部分。

变更日志

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

0.5.0

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

0.4.0

增强 (查看拉取请求)
添加 conditionprocessors 设置。

0.3.0

增强 (查看拉取请求)
添加 merge_results 功能

0.2.1

增强 (查看拉取请求)
添加系统测试用例。

0.2.0

增强 (查看拉取请求)
将 Kibana 版本更新至 8.8.0

0.1.0

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

0.0.3

增强 (查看拉取请求)
添加基本字段映射

0.0.2

增强 (查看拉取请求)
更新徽标

0.0.1

增强 (查看拉取请求)
SQL 输入包的初始草案