本章节介绍通过日志服务控制台创建采集 Syslog 日志的操作步骤。

说明

邀测功能，若有相关业务需求，可联系客户经理开通白名单。

## 功能介绍 Syslog‌ 是一种标准化的日志传递协议，主要用于收集、转发和存储系统日志，支持 UDP 和 TCP 等传输协议，但传统实现功能相对基础，例如在 Linux 系统中常作为默认日志服务运行。‌ 日志服务支持通过控制台采集或使用 Syslog 协议上传 Syslog 日志到日志服务，通过日志服务的检索分析、加工、消费、投递、监控告警、可视化等功能，实现业务运维监控、数据统计分析等场景。 ## 限制说明 * 仅适用于 Linux 系统。 * 仅支持部署 LogCollector 2.4.2 及以后版本的宿主机。 ## 前提条件 * 已创建日志项目和日志主题。详情请参考[创建日志项目](https://docs.volcengine.com/docs/6470/72005)和[创建日志主题](https://docs.volcengine.com/docs/6470/72004)。 * 已创建机器组，并确认机器组的服务器心跳状态正常。详情请参考[创建机器组（IP 地址）](https://docs.volcengine.com/docs/6470/93978)或[创建机器组（机器标识）](https://docs.volcengine.com/docs/6470/107375)。 * 安装 LogCollector 的宿主机需具备访问远端服务器 80 端口和 443 端口的能力。 * 已在原始日志所在的宿主机上安装最新版本的 LogCollector。详情请参考[安装与升级 LogCollector](https://docs.volcengine.com/docs/6470/145552)。 ## 操作步骤 ### 步骤一选择日志空间 1. 登录[日志服务控制台](https://console.volcengine.com/tls)。 2. 在顶部导航栏中，选择日志服务所在的地域。 3. 在左侧导航栏中，选择**常用功能** \> **日志接入**。 4. 在**日志接入**页面的 **LogCollector日志采集**页签中，单击**创建采集配置**。

说明

以下地域需在 LogCollector日志采集页签中，手动选择日志采集模式。

地域：中国香港、亚太东南（柔佛）、亚太东南（雅加达）。

5. 选择**日志项目**和**日志主题**，单击**下一步：选择机器组**。采集到的日志数据将被存储到该日志主题中。 ### 步骤二选择机器组 1. 在**全部机器组**区域中，选择需要被采集日志的机器组。如果列表中无可用的机器组，您需要先创建机器组。具体操作，请参考[创建机器组（机器标识）](https://docs.volcengine.com/docs/6470/107375)、[创建机器组（IP 地址）](https://docs.volcengine.com/docs/6470/93978) 2. 在**已选机器组**区域中确认机器组无误后，单击**下一步：采集规则**。 ### 步骤三配置采集规则 1. 选择**采集类型**，选择 **syslog** **采集**。 2. 填写**规则名称**。 * 长度范围为3~64个字符。 * 只能包含中文、字母、数字、下划线（_）和连字符（\-）。 * 不能以连字符（\-）开头/结尾。 3. 填写**插件配置**，然后单击**下一步：检查索引配置**。插件配置示例： ```Bash { "input": "syslog", "detail": [ { "address": "tcp://0.0.0.0:9998", "parse_protocol": "auto", "ignore_parse_failure": true }, { "address": "udp://0.0.0.0:9999", "parse_protocol": "auto", "ignore_parse_failure": true } ] } ``` 参数说明： |参数 |类型 |是否必选 |说明 | |---|---|---|---| |input |string |是 |采集数据源类型，固定为`syslog`。 | |address |string |否 |指定 LogCollector 采集日志监听的协议、地址和端口。

* 格式为`[tcp/udp]://[ip]:[port]`。

* 不配置时，默认为`tcp://127.0.0.1:9999`，表示只接收本地转发的日志。

说明

需与rsyslog配置文件设置的转发规则相同。

如果安装 LogCollector 的服务器有多个 IP 地址可接收日志，可配置为0.0.0.0，表示监听服务器的所有IP地址。

| |parse_protocol |string |否 |指定解析日志所使用的协议。

* 空：不解析。

* rfc3164：使用 RFC3164 协议解析日志。

* rfc5424：使用 RFC5424 协议解析日志。

* auto：根据日志内容自动选择合适的解析协议。 | |ignore_parse_failure |boolean |否 |指定解析失败后的操作。

* true（默认）：不配置或配置为`true`，表示放弃解析，直接填充所返回的`__content__`字段。

* false ：表示解析失败时丢弃日志。 | ### 步骤四检查索引配置 1. 检查索引配置。根据页面提示，按需设置或更新索引，您也可以单击**导入已有索引配置**，导入其他日志主题的索引。 * 若此日志主题未设置索引，可以参考[配置索引](https://docs.volcengine.com/docs/6470/1206703)进行设置。 * 若此日志主题已设置索引，可以根据采集规则中解析的日志字段判断是否需要更新索引。

说明

启用索引后，您才能检索分析采集到的日志数据。

更新后的索引设置仅对后续写入的新数据生效。其他检索分析的使用说明及限制请参考检索概述和分析概述。

2. 单击**提交**。 ## 后续步骤创建采集配置之后，LogCollector 将采集日志并保存至指定的日志主题中，您可以在日志主题中执行检索分析操作。具体操作，请参考[检索分析流程](https://docs.volcengine.com/docs/6470/1335024)。