自定义 API 输入集成

编辑

自定义 API 输入集成

编辑

版本

1.21.1 (查看全部)

兼容的 Kibana 版本

8.13.0 或更高版本

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

安全
可观测性

订阅级别
这是什么?

基本

支持级别
这是什么?

Elastic

自定义 API 输入集成用于从当前没有现有集成的自定义 RESTful API 中提取数据。

输入本身支持发送 GET 和 POST 请求,在运行时转换请求和响应,分页,并保持上次收集事件的信息的运行状态。

如果您正在开始开发新的自定义 HTTP API 输入,我们建议您使用通用表达式语言输入,它提供了更大的灵活性和改进的开发者体验。

配置

编辑

该输入的详细文档目前可在此处找到。

最常用的配置选项在主集成页面上提供,而更高级和可自定义的选项目前位于集成设置页面的“高级选项”部分下。

配置分为三个主要类别:请求、响应和游标。

配置的请求部分处理诸如要通信的 URL 端点、请求正文、在发送请求之前必须进行的特定转换以及一些自定义选项(如请求代理、超时和类似选项)之类的问题。

配置的响应部分处理诸如转换、速率限制、分页以及在将响应发送到 Elasticsearch 之前将其拆分为不同文档的选项。

当需要在每个 API 请求之间保持状态时,例如,如果在响应中返回了一个时间戳,该时间戳应该在下一个请求中用作过滤器,则使用配置的游标部分,这是存储信息的地方。

变更日志

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

1.21.1

Bug 修复 (查看拉取请求)
修复了使用通用表达式语言的自定义 API 中的断开链接。

8.13.0 或更高版本

1.21.0

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

8.13.0 或更高版本

1.20.0

增强 (查看拉取请求)
将敏感值设置为 secret。

8.12.0 或更高版本

1.19.0

增强 (查看拉取请求)
建议新项目使用 CEL。

8.7.1 或更高版本

1.18.1

增强 (查看拉取请求)
更改了所有者

8.7.1 或更高版本

1.18.0

增强 (查看拉取请求)
将请求跟踪器日志计数限制为五。

8.7.1 或更高版本

1.17.0

增强 (查看拉取请求)
ECS 版本更新为 8.11.0。

8.7.1 或更高版本

1.16.0

增强 (查看拉取请求)
ECS 版本更新为 8.10.0。

8.7.1 或更高版本

1.15.0

增强 (查看拉取请求)
程序包清单中的 format_version 从 2.11.0 更改为 3.0.0。从程序包清单中删除了点 YAML 键。将 *owner.type: elastic* 添加到程序包清单。

8.7.1 或更高版本

1.14.0

增强 (查看拉取请求)
添加 tags.yml 文件,以便使用“安全解决方案”标记集成的仪表板和已保存的搜索,并在安全解决方案 UI 中显示。

8.7.1 或更高版本

1.13.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.9.0。

8.7.1 或更高版本

1.12.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.8.0。

8.7.1 或更高版本

1.11.0

增强 (查看拉取请求)
将 package-spec 版本更新为 2.7.0。

8.7.1 或更高版本

1.10.0

增强 (查看拉取请求)
添加对 chain 属性的支持。

8.7.1 或更高版本

1.9.0

增强 (查看拉取请求)
添加一个新标志以启用请求跟踪

8.7.1 或更高版本

1.8.1

增强 (查看拉取请求)
添加了可选切换开关以启用调试跟踪日志记录。

8.4.0 或更高版本

1.8.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.7.0。

1.7.1

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

8.4.0 或更高版本

1.7.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.6.0。

8.4.0 或更高版本

1.6.1

Bug 修复 (查看拉取请求)
次要文档修复。

8.4.0 或更高版本

1.6.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.5.0。

8.4.0 或更高版本

1.5.1

增强 (查看拉取请求)
将文档中的 Custom HTTPJSON 剩余部分更新为 Custom API

8.4.0 或更高版本

1.5.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.4.0

8.4.0 或更高版本

1.4.2

增强 (查看拉取请求)
更新程序包名称和描述以与标准措辞对齐

8.4.0 或更高版本

1.4.1

Bug 修复 (查看拉取请求)
从清单中删除默认值。

8.4.0 或更高版本

1.4.0

增强 (查看拉取请求)
添加 oauth_google_jwt_json 选项

8.4.0 或更高版本

1.3.0

增强 (查看拉取请求)
将程序包更新为 ECS 8.3.0。

7.16.0 或更高版本
8.0.0 或更高版本

1.2.4

Bug 修复 (查看拉取请求)
为 event.created 添加正确的字段映射

7.16.0 或更高版本
8.0.0 或更高版本

1.2.3

Bug 修复 (查看拉取请求)
修复 oauth2 配置渲染

7.16.0 或更高版本
8.0.0 或更高版本

1.2.2

Bug 修复 (查看拉取请求)
修复自定义 oauth2 范围的渲染问题

7.16.0 或更高版本
8.0.0 或更高版本

1.2.1

Bug 修复 (查看拉取请求)
为 Google Oauth2 添加缺少的 delegated_account 选项

7.16.0 或更高版本
8.0.0 或更高版本

1.2.0

增强 (查看拉取请求)
将 ECS 更新到 8.2

7.16.0 或更高版本
8.0.0 或更高版本

1.1.1

Bug 修复 (查看拉取请求)
修复配置模板中的拼写错误

7.16.0 或更高版本
8.0.0 或更高版本

1.1.0

Bug 修复 (查看拉取请求)
修复某些配置字段不起作用的问题

7.16.0 或更高版本
8.0.0 或更高版本

1.0.0

增强 (查看拉取请求)
初始实现

7.16.0 或更高版本
8.0.0 或更高版本