Split Synchronizer

![Build Status]([***]

概述

默认情况下，Split的SDK会在用户在不同系统、处理方式和条件间导航时保持分段和拆分数据的同步。然而，某些语言不具备维护此数据的共享本地缓存以正确提供处理的原生能力。针对这些情况，我们开发了Split Synchronizer。

![*** Follow]([***]

兼容性

Split Synchronizer支持Go 1.13或更高版本。

运行容器

1. 拉取Docker镜像并在容器环境中运行。

shell
docker pull splitsoftware/split-synchronizer:latest

2. 运行镜像：

shell
docker run --rm --name split-synchronizer \
 -p 3010:3010 \
 -e SPLIT_SYNC_APIKEY="your-sdk-api-key" \
 -e SPLIT_SYNC_REDIS_HOST=<your-redis-host> \
 -e SPLIT_SYNC_REDIS_PORT=<your_redis_port> \
 splitsoftware/split-synchronizer

有关Split Synchronizer提供的所有功能以及可用于根据当前应用设置进行定制的配置选项，请参阅***文档。

环境变量

- SPLIT_SYNC_APIKEY: Split Server-side SDK api-key
- SPLIT_SYNC_LOG_LEVEL: 日志级别（error;warning;info;debug;verbose）
- SPLIT_SYNC_LOG_OUTPUT: 日志输出位置（默认stdout）
- SPLIT_SYNC_LOG_ROTATION_MAX_FILES: 日志轮转时保留的最大文件数
- SPLIT_SYNC_ADMIN_HOST: 管理服务器监听的主机
- SPLIT_SYNC_ADMIN_PORT: 接受传入连接的管理端口
- SPLIT_SYNC_ADMIN_USERNAME: 管理端点的HTTP基本认证用户名
- SPLIT_SYNC_ADMIN_PASSWORD: 管理端点的HTTP基本认证密码
- SPLIT_SYNC_ADMIN_SECURE_HC: 是否同时保护健康检查端点
- SPLIT_SYNC_IMPRESSION_LISTENER_ENDPOINT: 用于转发印象的HTTP端点
- SPLIT_SYNC_IMPRESSION_LISTENER_QUEUE_SIZE: 要排队的印象批量的最大数量
- SPLIT_SYNC_SLACK_WEBHOOK: 用于发布日志消息的Slack Webhook
- SPLIT_SYNC_SLACK_CHANNEL: 用于发布日志消息的Slack频道
- SPLIT_SYNC_IP_ADDRESS_ENABLED: 向Split发送数据时是否包含主机IP地址
- SPLIT_SYNC_TIMEOUT_MS: 同步器准备就绪前的等待时间（毫秒）
- SPLIT_SYNC_SNAPSHOT: 用作起点的快照文件
- SPLIT_SYNC_FORCE_FRESH_STARTUP: 启动同步器前是否清除存储
- SPLIT_SYNC_STORAGE_TYPE: 用于缓存拆分/分段和用户生成数据的存储驱动
- SPLIT_SYNC_SPLIT_REFRESH_RATE_MS: 拆分数据的刷新频率（毫秒）
- SPLIT_SYNC_SEGMENT_REFRESH_RATE_MS: 分段数据的刷新频率（毫秒）
- SPLIT_SYNC_IMPRESSIONS_MODE: 是否发送所有印象用于调试
- SPLIT_SYNC_STREAMING_ENABLED: 是否启用流功能
- SPLIT_SYNC_HTTP_TIMEOUT_MS: HTTP请求总超时时间（毫秒）
- SPLIT_SYNC_INTERNAL_METRICS_RATE_MS: 内部指标发送频率（毫秒）
- SPLIT_SYNC_TELEMETRY_PUSH_RATE_MS: SDK遥测数据刷新频率（毫秒）
- SPLIT_SYNC_IMPRESSIONS_FETCH_SIZE: 印象获取批量大小
- SPLIT_SYNC_IMPRESSIONS_PROCESS_CONCURRENCY: 处理印象的线程数
- SPLIT_SYNC_IMPRESSIONS_PROCESS_BATCH_SIZE: 印象处理批量大小
- SPLIT_SYNC_IMPRESSIONS_POST_CONCURRENCY: 并发印象发布线程数
- SPLIT_SYNC_IMPRESSIONS_POST_SIZE: 每次POST发送的最大印象数
- SPLIT_SYNC_IMPRESSIONS_ACCUM_WAIT_MS: 关闭印象批量的最大等待时间（毫秒）
- SPLIT_SYNC_EVENTS_FETCH_SIZE: 一次从存储中弹出的事件数量
- SPLIT_SYNC_EVENTS_PROCESS_CONCURRENCY: 处理事件的线程数
- SPLIT_SYNC_EVENTS_PROCESS_BATCH_SIZE: 事件处理批量大小
- SPLIT_SYNC_EVENTS_POST_CONCURRENCY: 并发事件发布线程数
- SPLIT_SYNC_EVENTS_POST_SIZE: 每次POST发送的最大事件数
- SPLIT_SYNC_EVENTS_ACCUM_WAIT_MS: 关闭事件批量的最大等待时间（毫秒）
- SPLIT_SYNC_REDIS_HOST: Redis服务器主机名
- SPLIT_SYNC_REDIS_PORT: Redis服务器端口
- SPLIT_SYNC_REDIS_DB: Redis数据库
- SPLIT_SYNC_REDIS_PASS: Redis密码
- SPLIT_SYNC_REDIS_PREFIX: Redis键前缀
- SPLIT_SYNC_REDIS_NETWORK: Redis网络协议
- SPLIT_SYNC_REDIS_MAX_RETRIES: Redis连接最大重试次数
- SPLIT_SYNC_REDIS_DIAL_TIMEOUT: Redis连接拨号超时时间
- SPLIT_SYNC_REDIS_READ_TIMEOUT: Redis连接读取超时时间
- SPLIT_SYNC_REDIS_WRITE_TIMEOUT: Redis连接写入超时时间
- SPLIT_SYNC_REDIS_POOL: Redis连接池大小
- SPLIT_SYNC_REDIS_SENTINEL_REPLICATION: 是否启用Redis哨兵复制
- SPLIT_SYNC_REDIS_SENTINEL_ADDRESSES: Redis哨兵地址列表
- SPLIT_SYNC_REDIS_SENTINEL_MASTER: 主节点名称
- SPLIT_SYNC_REDIS_CLUSTER_MODE: 是否启用Redis集群模式
- SPLIT_SYNC_REDIS_CLUSTER_NODES: Redis集群节点列表
- SPLIT_SYNC_REDIS_CLUSTER_KEY_HASHTAG: Redis集群的键哈希标签
- SPLIT_SYNC_REDIS_TLS: 是否使用SSL/TLS连接Redis
- SPLIT_SYNC_REDIS_TLS_SERVER_NAME: 验证服务器公钥时使用的服务器名称
- SPLIT_SYNC_REDIS_TLS_CA_CERTS: 通过SSL/TLS连接Redis服务器的根CA证书
- SPLIT_SYNC_REDIS_TLS_SKIP_NAME_VALIDATION: 是否盲目接受服务器公钥
- SPLIT_SYNC_REDIS_TLS_CLIENT_CERTIFICATE: 由已知CA签名的客户端证书
- SPLIT_SYNC_REDIS_TLS_CLIENT_KEY: 与证书匹配的客户端私钥
- SPLIT_SYNC_STORAGE_CHECK_RATE_MS: 存储健康检查频率（毫秒）

提交问题

Split团队会监控提交到issue跟踪器的所有问题。我们鼓励您使用此issue跟踪器提交错误报告、反馈和功能增强建议。我们将尽力及时响应。

贡献

请参阅贡献者指南了解提交Pull Request (PR)所需的全部信息。

许可证

根据Apache License 2.0许可。详见：Apache许可证。

关于Split

Split是领先的功能交付平台，面向希望尽快部署功能的工程团队。Split的细粒度管理、实时监控和数据驱动实验确保新功能能够改善客户体验，而不会影响性能。Twilio、Salesforce、GoDaddy和WePay等公司信任Split来支持其功能交付。

要了解更多关于Split的信息，请联系***，或在[***]

Split已构建并维护以下SDK：

• Java Github 文档
• Javascript Github 文档
• Node Github 文档
• .NET Github 文档
• Ruby Github 文档
• PHP Github 文档
• Python Github 文档
• GO Github 文档
• Android Github 文档
• IOS Github 文档

有关开源项目的完整列表，请访问我们的Github页面。

了解更多关于Split：

访问split.io/product获取Split概述，或访问我们的文档docs.split.io获取更详细的信息。