> 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/yuan-sheng-shu-ru-cha-jian/input-forward.md).

# 转发输入插件

## 简介

`input_forward` 插件用于接收来自其他系统的数据转发请求，目前支持LoongSuite协议。该插件可以作为数据转发的接收端，通过配置的匹配规则来处理接收到的数据。[源代码](https://github.com/alibaba/loongcollector/blob/main/core/plugin/input/InputForward.h)

## 事件能力

列含义见 [概览 · 事件能力列说明](https://ilogtail.gitbook.io/ilogtail-docs/pre-release/plugins/shu-ru-cha-jian/yuan-sheng-shu-ru-cha-jian/pages/V3l051tHPlzCBkmzOfvu#事件能力列说明)。

| Log | Metric | Span |
| --- | ------ | ---- |
| ✓   | ✓      | ✓    |

## 版本

[Stable](/ilogtail-docs/pre-release/plugins/stability-level.md)

## 版本说明

* 推荐版本：LoongCollector v2.0.0 及以上

## 配置参数

| 参数       | 类型，默认值          | 说明                                                                                |
| -------- | --------------- | --------------------------------------------------------------------------------- |
| Type     | String，无默认值（必填） | 插件类型，固定为`input_forward`。                                                          |
| Protocol | String，无默认值（必填） | 转发协议类型。目前支持：`LoongSuite`。                                                         |
| Endpoint | String，无默认值（必填） | 监听地址和端口，格式为`IP:PORT`，例如`0.0.0.0:7899`。或者本地通信socket，例如`/root/loongcollector.sock`。 |

## 转发规则

### LoongSuite

LoongCollector 根据请求中的采集配置名进行转发，如果没有匹配的路由规则，则返回错误状态码。

#### GRPC

metadata 中配置 key 为 `X-Loongsuite-Apm-Configname`，value 为采集配置名。 返回状态码：

* OK：转发成功
* NOT\_FOUND：没有匹配的采集配置
* INVALID\_ARGUMENT：请求参数错误
* UNAVAILABLE：转发阻塞，请重试

## 样例

### 接收LoongSuite协议数据

* 采集配置

```yaml
enable: true
inputs:
  - Type: input_forward
    Protocol: LoongSuite
    Endpoint: 0.0.0.0:7899
flushers:
  - Type: flusher_sls
    Project: "your-project"
    Logstore: "your-logstore"
    Region: cn-shanghai
    Endpoint: cn-shanghai.log.aliyuncs.com
```

* 输入

通过gRPC客户端发送LoongSuite协议的转发请求，请求需要在metadata中包含`x-loongsuite-apm-configname: <采集配置名>`字段，数据内容在请求的data字段中，为 `PipelineEventGroup` PB 序列化的结果。

* 输出

以下为示意：实际字段取决于上游 PB 解析后的事件内容及下游 Flusher 序列化方式。

```json
{
    "content": "接收到的原始数据内容",
    "__time__": "1642502400"
}
```