> 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/ju-he-cha-jian/aggregator-context.md).

# 按上下文分组

## 简介

`aggregator_context` `aggregator` 插件可以根据数据来源对**单条数据**进行聚合。

## 事件能力

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

| v1 接口 | v2 接口 | Log | Metric | Span |
| ----- | ----- | --- | ------ | ---- |
| ✓     | —     | v1  | 透传未知   | 透传未知 |

## 版本

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

## 版本说明

* 推荐版本：iLogtail v1.2.0 及以上

## 配置参数

| 参数               | 类型     | 是否必选 | 说明                                                                                                                                                         |
| ---------------- | ------ | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type             | string | 是    | 插件类型，指定为`aggregator_context`。                                                                                                                              |
| MaxLogGroupCount | int    | 否    | 在执行Flush之前，每一个日志来源所允许存在的最大LogGroup数量。如果未添加该参数，则默认每一个日志来源最多允许存在2个LogGroup。                                                                                  |
| MaxLogCount      | int    | 否    | 每个LogGroup最多可包含的日志条数。如果未添加该参数，则默认每个LogGroup最多可包含1024条日志。                                                                                                   |
| PackFlag         | bool   | 否    | 是否需要在LogGroup的LogTag中添加\_\_pack\_id\_\_字段。如果未添加改参数，则默认在LogGroup的LogTag中添加\_\_pack\_id\_\_字段。                                                               |
| Topic            | string | 否    | <p>额外设置的LogGroup的Topic名。如果未添加该参数，则每个LogGroup的Topic名默认值如下：</p><ul><li>空，如果input插件不提供设置Topic的能力；</li><li>input插件中设置的topic名称，如果input插件提供设置Topic的能力。</li></ul> |

## 样例

采集`/home/test-log/`路径下的所有文件名匹配`*.log`规则的文件，使用上下文聚合功能，将来源于同一文件的日志聚合在一起，并将采集结果发送到SLS。

```yaml
enable: true
inputs:
  - Type: input_file
    FilePaths: 
      - /home/test-log/*.log
aggregators:
  - Type: aggregator_context
flushers:
  - Type: flusher_stdout
    OnlyStdout: true
```