> For the complete documentation index, see [llms.txt](https://ilogtail.gitbook.io/ilogtail-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/shu-ru-cha-jian/inputs.md).

# 什么是输入插件

输入插件是 LoongCollector 的核心组件之一，负责从各类数据源高效采集数据。LoongCollector 提供两种类型的输入插件，分别针对不同的使用场景:

* 原生插件(C++): 高性能、低开销的首选方案
* 扩展插件(Golang): 灵活可扩展的补充方案

## 插件类型介绍

### 原生插件

原生插件采用 C++实现，具有以下显著优势:

* 卓越的性能表现和极低的资源开销
* 专注于常见数据源的高效采集
* 生产环境首选的稳定采集方案

| 名称                                                                                                                                                                     | 提供方    | 功能简介                  |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------- |
| <p><code>input\_container\_stdio</code><br><a href="/pages/sLrQxfevslrBNsPwieoD">容器标准输出</a></p>                                                                        | SLS 官方 | 从容器标准输出/标准错误流中采集日志。   |
| <p><code>input\_cpu\_profiling</code><br><a href="https://github.com/alibaba/ilogtail/blob/main/docs/cn/plugins/input/native/input-cpu-profiling.md">CPU性能剖析数据</a></p> | SLS 官方 | CPU性能剖析数据采集。          |
| <p><code>input\_file</code><br><a href="/pages/qQqxCMGvQ9cYj9qmzsdT">文本日志</a></p>                                                                                      | SLS 官方 | 文本采集。                 |
| <p><code>input\_file\_security</code><br><a href="/pages/JPUF6q5FcegJg3vCPmco">文件安全数据</a></p>                                                                          | SLS 官方 | 文件安全数据采集。             |
| <p><code>input\_forward</code><br><a href="/pages/PcgPrxdpYvQjxcLpSncx">转发输入</a></p>                                                                                   | SLS 官方 | 接收来自其他实例或系统的数据转发。     |
| <p><code>input\_host\_meta</code><br><a href="/pages/WbLNajhG55v0NNex953e">主机元数据</a></p>                                                                               | SLS 官方 | 定时采集主机、进程及关联关系等元数据。   |
| <p><code>input\_host\_monitor</code><br><a href="/pages/6hIztB4ISNAnseKSENcg">主机监控数据</a></p>                                                                           | SLS 官方 | 采集主机 CPU/内存/磁盘/网络等指标。 |
| <p><code>input\_internal\_alarms</code><br><a href="/pages/JWIDENpEv9rqDUGSSCgJ">自监控告警数据</a></p>                                                                       | SLS 官方 | 导出自监控告警数据。            |
| <p><code>input\_internal\_metrics</code><br><a href="/pages/M8oVuFwZI2noCpTePsuO">自监控指标数据</a></p>                                                                      | SLS 官方 | 导出自监控指标数据。            |
| <p><code>input\_network\_observer</code><br><a href="/pages/hNcu2r3RopjMGSpmcQ7w">网络可观测数据</a></p>                                                                      | SLS 官方 | 网络可观测数据采集。            |
| <p><code>input\_network\_security</code><br><a href="/pages/Go0xwoT7vdBI4ovxIM2n">网络安全数据</a></p>                                                                       | SLS 官方 | 网络安全数据采集。             |
| <p><code>input\_process\_security</code><br><a href="/pages/KW1xA8ZPTNSfZefKcbyp">进程安全数据</a></p>                                                                       | SLS 官方 | 进程安全数据采集。             |
| <p><code>input\_prometheus</code><br><a href="/pages/fwjqSlmHV6SCgkd9qwWM">Prometheus 抓取</a></p>                                                                       | SLS 官方 | 按 ScrapeConfig 抓取指标。  |
| <p><code>input\_static\_file\_onetime</code><br><a href="/pages/j5myIZEJzFEqIFTUQazA">一次性文件采集</a></p>                                                                  | SLS 官方 | 一次性文件采集。              |

上表按插件 **Type** 字典序排列。

### 扩展插件

扩展插件基于 Golang 实现，具有以下特点:

* 性能与资源开销均衡
* 支持丰富多样的数据源接入
* 开发门槛低，易于定制与扩展
* 适用于特定场景的数据采集需求

| 名称                                                                                                         | 提供方                                                                   | 功能简介                                                        |
| ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------- |
| <p><code>input\_command</code><br><a href="/pages/0SivmrwqbicL73MDxNC2">脚本执行数据</a></p>                     | <p>社区<br><a href="https://github.com/didachuxing">didachuxing</a></p> | 采集脚本执行数据。                                                   |
| <p><code>metric\_debug\_file</code><br><a href="/pages/Yu3Q2AZaegr7CqJ45nTG">文本日志（debug）</a></p>           | SLS 官方                                                                | 用于调试的读取文件内容的插件。                                             |
| <p><code>metric\_input\_example</code><br><a href="/pages/PQNxlMdtknsPzV1V3goJ">MetricInput 示例插件</a></p>   | SLS 官方                                                                | MetricInput 示例插件。                                           |
| <p><code>metric\_meta\_host</code><br><a href="/pages/9gWhuBu6lt7rY71WoTS2">主机 Meta 数据</a></p>             | SLS 官方                                                                | 主机 Meta 数据。                                                 |
| <p><code>metric\_mock</code><br><a href="/pages/9YpuEsB4KW61XRppjcWN">Mock 数据-Metric</a></p>               | SLS 官方                                                                | 生成 metric 模拟数据的插件。                                          |
| <p><code>metric\_system\_v2</code><br><a href="/pages/7jtQRiWHUab6EmiiJJXn">主机监控数据</a></p>                 | SLS 官方                                                                | 主机监控数据。                                                     |
| <p><code>service\_canal</code><br><a href="/pages/XoDwGVY9WaL6TjUdPCJO">MySQL Binlog</a></p>               | SLS 官方                                                                | 将 MySQL Binlog 输入到 LoongCollector。                          |
| <p><code>service\_docker\_stdout</code><br><a href="/pages/VtyCQgvujKdC8DLZ8vqS">容器标准输出</a></p>            | SLS 官方                                                                | 从容器标准输出/标准错误流中采集日志。                                         |
| <p><code>service\_go\_profile</code><br><a href="/pages/wIZ1xXgZJFcCeDzIiAwY">GO Profile</a></p>           | SLS 官方                                                                | 采集 Golang pprof 性能数据。                                       |
| <p><code>service\_gpu\_metric</code><br><a href="/pages/1TquePp9lUoFF9ba3enL">GPU 数据</a></p>               | SLS 官方                                                                | 支持收集英伟达 GPU 指标。                                             |
| <p><code>service\_http\_server</code><br><a href="/pages/MJvy9GT0PNE7M0JKwGRF">HTTP 数据</a></p>             | SLS 官方                                                                | 接收来自 unix socket、http/https、tcp 的请求，并支持 sls 协议、otlp 等多种协议。  |
| <p><code>service\_input\_example</code><br><a href="/pages/msEQ2PhEeu3r2hpniWNa">ServiceInput 示例插件</a></p> | SLS 官方                                                                | ServiceInput 示例插件。                                          |
| <p><code>service\_journal</code><br><a href="/pages/04N9O53lhlBPUkI1EU08">Journal 数据</a></p>               | SLS 官方                                                                | 从原始的二进制文件中采集 Linux 系统的 Journal（systemd）日志。                  |
| <p><code>service\_kafka</code><br><a href="/pages/JVfqOBCitStjcDoEuenh">Kafka</a></p>                      | SLS 官方                                                                | 将 Kafka 数据输入到 LoongCollector。                               |
| <p><code>service\_kubernetes\_meta</code><br><a href="/pages/VjafEnw5BqDHIcggChlX">Kubernetes 元数据</a></p>  | SLS 官方                                                                | 在集群内采集 K8s 资源元数据并提供查询接口（插件 Type：`service_kubernetes_meta`）。 |
| <p><code>service\_mock</code><br><a href="/pages/96G0ttjjLLDqHAiGWXLX">Mock 数据-Service</a></p>             | SLS 官方                                                                | 生成 service 模拟数据的插件。                                         |
| <p><code>service\_mssql</code><br><a href="/pages/Nv60nV5qarNI50LczaxH">SqlServer 查询数据</a></p>             | SLS 官方                                                                | 将 Sql Server 数据输入到 LoongCollector。                          |
| <p><code>service\_otlp</code><br><a href="/pages/3sEwJsXwnv7aWqnoua9A">OTLP 数据</a></p>                     | <p>社区<br><a href="https://github.com/shunjiazhu">Zhu Shunjia</a></p>  | 通过 http/grpc 协议，接收 OTLP 数据。                                 |
| <p><code>service\_pgsql</code><br><a href="/pages/UGoSA2ie4Hg8Pzq6K31u">PostgreSQL 查询数据</a></p>            | SLS 官方                                                                | 将 PostgresSQL 数据输入到 LoongCollector。                         |
| <p><code>service\_snmp</code><br><a href="/pages/G3omXHV4CxtqAZL8pDuQ">收集 SNMP 协议机器信息</a></p>              | SLS 官方                                                                | 收集 SNMP 协议机器信息.                                             |
| <p><code>service\_syslog</code><br><a href="/pages/SJcfmjAY5uZxAiy8gE2c">Syslog 数据</a></p>                 | SLS 官方                                                                | 采集 syslog 数据。                                               |

上表按插件 **Type** 字典序排列。

## 插件特性对比

| 特性   | 原生插件   | 扩展插件   |
| ---- | ------ | ------ |
| 实现语言 | C++    | Golang |
| 性能表现 | 极致性能   | 性能适中   |
| 资源开销 | 极低开销   | 开销适中   |
| 功能覆盖 | 专注常见场景 | 广泛覆盖   |
| 开发难度 | 中等     | 较低     |

## 选型建议

1. 推荐使用原生插件的场景:
   * 对性能和资源消耗有严格要求
   * 采集常见标准数据源
   * 部署在资源受限环境
2. 适合使用扩展插件的场景:
   * 需要采集特殊或自定义数据源
   * 有特定的定制化需求
   * 需要快速开发和迭代
   * 性能要求相对灵活

## 使用说明

* 插件组合规则:
  * 原生 Input 插件: 可配合原生/扩展 Processor 插件使用，支持 SPL 插件
  * 扩展 Input 插件: 仅支持扩展 Processor 插件
  * 详细说明请参考[处理插件文档](/ilogtail-docs/pre-release/plugins/chu-li-cha-jian/processors.md)
