rudderstack/rudder-transformer

镜像概述

本镜像提供一个事件转换服务，旨在RudderStack数据处理流程中，将统一格式的RudderStack事件转换为特定目标端（如分析平台、营销工具、数据库等）所需的单个事件格式，确保事件能被目标系统正确解析和处理。

核心功能和特性

核心功能

• 事件格式转换：将RudderStack标准事件结构转换为目标端特定的事件格式，包括字段映射、数据类型调整及结构重组
• 目标端适配：内置对主流目标端系统的格式支持，确保输出事件符合目标系统接口规范
• 轻量级处理：采用高效事件处理机制，低资源占用，支持高吞吐量事件流转换

主要特性

• 无缝集成：与RudderStack数据管道生态深度兼容，可直接接入现有RudderStack架构
• 可扩展适配：支持通过配置文件扩展对新目标端的格式支持
• 实时转换：低延迟处理，满足实时数据传输场景需求

使用场景和适用范围

典型使用场景

• RudderStack数据管道构建：在数据从源头流向目标端的中间环节，作为事件格式转换层
• 多目标端数据分发：需将同一RudderStack事件同步至多个不同格式要求的目标系统时
• 目标端接口适配：目标系统接口变更或存在特殊格式要求时，通过本服务快速适配

适用范围

• RudderStack用户需对事件进行目标端特定处理的场景
• 需将标准化事件转换为第三方系统（如Google Analytics、Salesforce、HubSpot等）专有格式的场景
• 数据集成流程中需进行事件结构调整和字段映射的场景

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name rudderstack-event-transformer \
  -e TARGET_DESTINATION=<目标端类型> \
  -e RUDDERSTACK_EVENT_SOURCE=<事件源地址> \
  -p 8080:8080 \
  rudderstack/event-transformer:latest

环境变量配置

高级配置（自定义转换规则）

如需自定义事件转换规则，可通过挂载配置文件实现：

1. 创建转换规则文件（如transform-rules.json），定义字段映射关系：

   json
   {
     "fieldMappings": {
       "rudderEventField": "destinationField",
       "context.timestamp": "eventTime"
     },
     "typeConversions": {
       "properties.revenue": "number"
     }
   }
   

2. 挂载配置文件启动容器：

   bash
   docker run -d \
     --name rudderstack-event-transformer \
     -e TARGET_DESTINATION=custom \
     -e RUDDERSTACK_EVENT_SOURCE=http://rudderstack-source:8080 \
     -v $(pwd)/transform-rules.json:/etc/transformer/rules.json \
     -p 8080:8080 \
     rudderstack/event-transformer:latest
   

服务验证

服务启动后，可通过访问 http://<容器IP>:8080/health 验证服务状态，返回 200 OK 表示服务正常运行。