文档中心

云搜索服务

管道管理

使用调试功能

当数据在 Logstash 内部流转时，数据格式不直观，可能会导致写入目标端的数据或格式不符合预期，调试时需要反复执行修改、上线、确认数据的流程，增加工作量。因此，云搜索服务 Logstash 提供管道调试功能，在管道配置完成后，可以直接在日志中查看数据及其格式，降低调试成本。本文介绍如何使用调试功能。

说明

调试功能仅支持普通管道，不支持元数据迁移管道。

前提条件

已创建 Logstash 实例，且 Logstash 实例处于运行中状态。具体操作，请参见创建 Logstash 实例。

操作步骤

登录云搜索服务控制台。

在左侧导航栏，选择数据处理 > Logstash。

在 Logstash 实例列表，单击目标实例的名称，进入基本信息页签。

在左侧选择管道管理页签，然后点击创建管道。

在创建管道面板，配置以下参数。

参数	说明
管道类型	选择普通管道。
管道名称	管道的唯一标识。命名规则如下：只能以字母开头。长度为 1~128 个字符。只能包含字母、数字、下划线（_）和中划线（-）。
管道描述	（可选）管道的描述信息。长度需为 1~256 个字符。
Config配置	单击右侧的引用模板按钮，在弹出的模板列表中勾选以下模板，然后单击确定。 Filter-debug：将时间转成当前时区时间以确保日志展示不会乱序。 Output-debug_with_filter ：输出转换后的时间。修改 Config 配置，增加 input 插件，并修改 output 插件的 format 行，输出所有信息。具体代码如下所示。 input { generator { lines => ["logstash debug model usage example"] count => 1 } } filter { ruby { code => ' require "time" require "json" local_time = Time.now.getlocal.strftime("%Y-%m-%dT%H:%M:%S.%3N") event.set("rfc3339_local", local_time) # rfc3339_local 是字段名 event.set("message", event.to_hash.to_json) ' } } output { file { path => "/logstash-logs/user-debug.log" # 路径必须符合 /logstash-logs/user-debug.log 格式，其中目录不可修改，可替换为其他字符。不符合格式的日志将无法正常解析。 codec => line { format => "[%{rfc3339_local}] %{message}" } } }

点击保存并部署。

等待 Logstash 实例状态再次变成运行中，然后在左侧导航栏中选择可观测 > 日志查询。

在日志类型中选择 DEBUG 日志即可查看调试日志。

最近更新时间：2025.11.21 18:09:50

这个页面对您有帮助吗？

有用

无用