📙
iLogtail用户手册
2.0.4
2.0.4
  • 关于
    • 什么是iLogtail
    • 发展历史
    • 产品优势
    • 开源协议
    • 社区版和企业版的对比说明
  • 社区活动 >
    • 开源之夏 2024
      • iLogtail 社区项目介绍
        • iLogtail 数据吞吐性能优化
        • ConfigServer 能力升级 + 体验优化(全栈)
  • 安装
    • 快速开始
    • Docker使用
    • Kubernetes使用
    • 守护进程
    • 发布记录
    • 发布记录(1.x版本)
    • 支持的操作系统
    • 源代码
      • 下载
      • 编译
      • Docker镜像
      • 编译依赖
    • 镜像站
  • 概念
    • 关键概念
  • 配置
    • 采集配置
    • 系统参数
    • 日志
  • 插件
    • 概览
    • 版本管理
    • 输入
      • 文本日志
      • 脚本执行数据
      • 容器标准输出
      • 文本日志(debug)
      • MetricInput示例插件
      • 主机Meta数据
      • Mock数据-Metric
      • eBPF网络调用数据
      • 主机监控数据
      • MySQL Binlog
      • GO Profile
      • GPU数据
      • HTTP数据
      • ServiceInput示例插件
      • Journal数据
      • Kafka
      • Mock数据-Service
      • SqlServer 查询数据
      • OTLP数据
      • PostgreSQL 查询数据
      • Syslog数据
    • 处理
      • 原生插件
        • 正则解析
        • 分隔符解析
        • Json解析
        • 时间解析
        • 过滤
        • 脱敏
      • 扩展插件
        • 添加字段
        • 添加云资产信息
        • 原始数据
        • 数据脱敏
        • 丢弃字段
        • 字段加密
        • 条件字段处理
        • 日志过滤
        • Go时间格式解析
        • Grok
        • Json
        • 日志转SLS Metric
        • 正则
        • 重命名字段
        • 分隔符
        • 键值对
        • 多行切分
        • 字符串替换
    • 聚合
      • 基础
      • 上下文
      • 按Key分组
      • 按GroupMetadata分组
    • 输出
      • Kafka(Deprecated)
      • kafkaV2
      • ClickHouse
      • ElasticSearch
      • SLS
      • 标准输出/文件
      • OTLP日志
      • Pulsar
      • HTTP
      • Loki
  • 工作原理
    • 文件发现
    • 插件系统
  • 可观测性
    • 日志
  • 开发者指南
    • 开发环境
    • 日志协议
      • 协议转换
      • 增加新的日志协议
      • 协议
        • sls协议
        • 单条协议
    • 代码风格
    • 数据模型
    • 插件开发
      • 开源插件开发引导
      • Checkpoint接口
      • Logger接口
      • 如何开发Input插件
      • 如何开发Processor插件
      • 如何开发Aggregator插件
      • 如何开发Flusher插件
      • 如何生成插件文档
      • 插件文档规范
      • 纯插件模式启动
    • 测试
      • 单元测试
      • E2E测试
    • 代码检查
      • 检查代码规范
      • 检查文件许可证
      • 检查依赖包许可证
  • 贡献指南
    • 贡献指南
    • 开发者
    • 成就
  • 性能测试
    • 容器场景iLogtail与Filebeat性能对比测试
  • 管控工具
    • 使用介绍
    • 通信协议
    • 开发指南
  • Awesome iLogtail
    • 走近iLogtail社区版
    • iLogtail社区版使用入门
    • iLogtail社区版开发者指南
    • iLogtail社区版使用案例
Powered by GitBook
On this page
  • 简介
  • 版本
  • 配置参数
  • 样例
  1. 插件
  2. 聚合

按GroupMetadata分组

Previous按Key分组Next输出

Last updated 1 year ago

简介

aggregator_metadata_group aggregator插件可以实现对PipelineGroupEvents按照指定的 Metadata Key 进行重新聚合。仅支持v2版本。

版本

配置参数

参数
类型
是否必选
说明

Type

String

是

插件类型,指定为aggregator_metadata_group。

GroupMetadataKeys

[]String

否

指定需要按照其值分组的Key列表, 为空是表示丢弃Metadata, 只进行打包聚合。

GroupMaxEventLength

int

否

聚合时,单个PipelineGroupEvents中的最大Events数量,默认1024

GroupMaxByteLength

int

否

聚合时,单个PipelineGroupEvents中Events总的字节长度,仅支持ByteArray类型,默认3MiB

DropOversizeEvent

int

否

遇到单个PipelineGroupEvent字节长度超过上限是否丢弃,默认为true

样例

采集service_http_server输入插件获取的字节流,使用GroupMetadataKeys 指定Metadata中用于聚合的字段,聚合后将采集结果通过http请求发送到指定目的。本样例中需要使用v2版本插件。

在样例中,首先通过input插件的配置QueryParams定义Metadata的数据来源,然后才能在aggregator插件中使用Metadata Key进行聚合,相同db的Events会被放在同一个PipelineGroupEvents向后传递。在flusher_http中,每个PipelineGroupEvents中的所有Events会在一次请求中输出。

  • 输入

curl --request POST 'http://127.0.0.1:12345?db=mydb' --data 'test,host=server01,region=cn value=0.1'
  • 采集配置

enable: true
version: "v2"
inputs:
  - Type: service_http_server
    Format: raw
    Address: "http://127.0.0.1:12345"
    QueryParams:
      - db
aggregators:
  - Type: aggregator_metadata_group
    GroupMetadataKeys:
      - db
flushers:
  - Type: flusher_http
    RemoteURL: "http://127.0.0.1:8086/write"
    Query:
      db: "%{metadata.db}"
    Convert:
      Protocol: raw
      Encoding: custom
Alpha