Vector 移除 `http` source 与 `greptimedb` sink 废弃别名：升级迁移完整指南-北京尧图网络

Vector 移除httpsource 与greptimedbsink 废弃别名升级迁移完整指南【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vectorVector 在其 breaking change 变更记录 changelog.d/remove_deprecated_component_aliases.breaking.md 中宣布废弃的httpsource 别名与greptimedbsink 别名已正式移除。如果你在配置中仍使用这两个旧名称升级后将直接报错、无法启动。本指南将说明这次变更的来龙去脉、为何必须迁移、如何一键迁移到新组件名http_server与greptimedb_metrics并结合当前仓库源码给出新旧配置对比与验证方法帮助你在升级前后平滑过渡。变更摘要移除的两个组件别名本次 breaking change 的核心内容可以概括为一句话将 source 类型http改为http_server将 sink 类型greptimedb改为greptimedb_metrics。两个别名各自经历了完整的引入 → 废弃 → 移除生命周期时间线如下旧别名新名称废弃版本移除版本本次变更组件类型httphttp_serverVector 0.26.0当前版本sourcegreptimedbgreptimedb_metricsVector 0.41.0当前版本sink之所以称其为breaking change是因为旧名称不再被解析升级后任何仍然写着type http或type greptimedb的配置都会被配置校验阶段直接拒绝Vector 无法正常启动。这是 Vector 组件命名规范化的一部分——新名称更准确地表达了组件的实际职责http_server强调接收 HTTP 请求的服务端而非笼统的 HTTPgreptimedb_metrics明确该 sink 面向的是指标数据写入。为什么必须迁移从源码看组件注册名在 Vector 中组件名称由configurable_component宏在注册时决定。查看当前仓库源码可以确认旧别名在注册表中已完全不存在source 侧src/sources/http_server.rs 中组件注册名为http_server/// Configuration for the http_server source. #[configurable_component(source(http_server, Host an HTTP endpoint to receive logs.))]模块本身也以新名称挂载src/sources/mod.rs 中#[cfg(feature sources-http_server)] pub mod http_server;feature 开关同样跟随新名称。sink 侧src/sinks/greptimedb/metrics/config.rs 中指标 sink 的注册名为greptimedb_metrics/// Configuration items for GreptimeDB #[configurable_component(sink(greptimedb_metrics, Ingest metrics data into GreptimeDB.))]src/sinks/mod.rs 中挂载的 feature 也是sinks-greptimedb_metrics与sinks-greptimedb_logsgreptimedb模块作为一个目录承载多种能力metrics 与 logs而不是单一的组件名。从源码结构可以推断此次移除属于清理遗留别名Vector 组件体系早已按新名称组织废弃别名只是为兼容旧配置而保留的过渡层。从配置系统的角度看别名移除意味着配置解析时不再做旧名到新名的映射输入即校验、输入即生效。迁移实操一httpsource →http_server修改前旧配置已失效sources: my_http: type: http # ❌ 旧别名本次变更后无法解析 address: 0.0.0.0:8080 path: /logs method: post修改后新配置sources: my_http: type: http_server # ✅ 新名称 address: 0.0.0.0:8080 path: /logs method: posthttp_serversource 的关键配置项迁移只需改type字段其余参数保持不变。结合 src/sources/http_server.rs 的源码定义http_server的核心参数如下参数说明示例 / 默认值address监听 socket 地址必须包含端口0.0.0.0:80、localhost:80path接收日志 POST 请求的 URL 路径默认/示例/event/path、/logsstrict_path是否将path视为绝对路径true时仅接受完全匹配该路径的请求false时接受以该路径开头的请求配合path: 可接受任意路径默认truemethod接受的 HTTP 请求方法默认postheaders需要写入日志事件的 HTTP 头列表支持通配符*与 JSON payload 中同名字段冲突时以 payload 为准示例User-Agent、X-*、*query_parameters需要写入日志事件的 URL 查询参数列表同样支持*与 body 中同名字段冲突时以 query 参数为准示例application、source、param*authHTTP 认证配置建议仅在 HTTPS 下使用凭据通过 Header 明文传递custom策略下 VRL 程序可通过%field value为事件补充认证信息在 legacy 命名空间写入事件体在 Vector 命名空间写入http_server.field元数据可选host_key用于记录客户端远程 IP 的字段名默认hostpath_key用于记录请求 URL 路径的字段名默认vector_http_pathresponse_code成功处理请求后返回的 HTTP 状态码默认200示例202tlsTLS 启用配置用于以 HTTPS 提供服务可选framing/decoding请求体的帧格式与反序列化方式如bytes、json等默认按全局 codec 配置提示如果旧配置里依赖了http别名下的framing、decoding、acknowledgements等参数它们在新名称下依然受支持见SimpleHttpConfig后续字段定义与 src/config/source.rs 中的 acknowledgements 配置迁移时只需改type无需调整其他键。迁移实操二greptimedbsink →greptimedb_metrics修改前旧配置已失效sinks: my_greptimedb: type: greptimedb # ❌ 旧别名本次变更后无法解析 endpoint: https://localhost:4000 dbname: public inputs: - my_metric_source修改后新配置sinks: my_greptimedb: type: greptimedb_metrics # ✅ 新名称 endpoint: https://localhost:4000 dbname: public inputs: - my_metric_source迁移注意事项metrics 与 logs 是两个 sink特别提醒GreptimeDB 相关的 sink 在 Vector 中分为两个独立组件注册名分别是greptimedb_metrics指标与greptimedb_logs日志各自的配置结构定义在src/sinks/greptimedb/metrics/config.rsGreptimeDBMetricsConfig注册名为greptimedb_metricssrc/sinks/greptimedb/logs/config.rsGreptimeDBLogsConfig注册名为greptimedb_logs。从源码结构看原先的greptimedb别名只对应指标写入路径因此迁移目标是greptimedb_metrics若你的场景实际是写日志数据应改用greptimedb_logs其参数如endpoint、dbname结构类似但字段语义以日志为准。以greptimedb_metrics为例其核心参数包括参数说明endpointGreptimeDB gRPC 服务的地址sink 通过 gRPC 接口完成数据写入详见 src/sinks/greptimedb/metrics/config.rs 源码注释dbname目标数据库名默认publicGreptimeDB 默认库若使用 GreptimeCloud请填写实例连接信息中的dbnamecompressiongRPC 请求的压缩方式GrpcCompression可选none或gzip旧别名迁移到新名称后sink 的批量发送、重试逻辑GreptimeDBGrpcRetryLogic与健康检查healthcheck行为均保持一致唯一变化是组件标识符。如何批量迁移与验证批量替换对于存量配置最直接的方式是全局搜索替换这两个字符串# 将 source 的 type 从 http 改为 http_server sed -i s/type: http$/type: http_server/ vector.yaml # 将 sink 的 type 从 greptimedb 改为 greptimedb_metrics sed -i s/type: greptimedb$/type: greptimedb_metrics/ vector.yaml注意http是一个很常见的子串如https://、http_client务必匹配完整的type:字段行避免误伤。推荐在 YAML 结构化的配置管理工具或编辑器中针对type键做精确替换。使用vector validate校验Vector 提供了配置校验命令。迁移后建议在启动前先执行验证对应源码见 src/validate.rsvector validate --config-yaml vector.yaml该命令会走完整的配置解析与编译流程若配置中仍残留任何旧别名校验阶段就会明确报错从而在启动前暴露问题。仓库自带的参考配置 config/vector.yaml 及各组件文档website/cue/reference/components/sources/http_server.cue可作为新名称下参数书写的标准参照。检查点清单升级前请逐项确认所有 source 的type中不再出现http应为http_server所有指向 GreptimeDB 的 sinktype中不再出现greptimedb指标写greptimedb_metrics日志写greptimedb_logsvector validate校验通过无 unknown component type 类错误如同时使用了 Vector 配置文件热加载watch或 API确认重启后新配置已生效。总结本次变更详见 changelog.d/remove_deprecated_component_aliases.breaking.md是 Vector 清理历史包袱的常规动作httpsource 别名自 0.26.0 起废弃greptimedbsink 别名自 0.41.0 起废弃如今已彻底移除。迁移本身非常轻量——只需把type: http改为type: http_server、把type: greptimedb改为type: greptimedb_metrics其余参数、行为与源码实现路径均保持不变。唯一需要留意的是 GreptimeDB sink 已按数据形态拆分为 metrics/logs 两个组件迁移时按实际数据流向选择正确的新名称并用vector validate完成升级前的最后一道校验即可。【免费下载链接】vectorA high-performance observability data pipeline.项目地址: https://gitcode.com/GitHub_Trending/vect/vector创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Vector 移除 `http` source 与 `greptimedb` sink 废弃别名：升级迁移完整指南

相关推荐

别再抄减肥食谱了！用体脂率和基础代谢定制你的饮食方案

Automatisch 连接 Mailchimp：OAuth 应用注册与连接配置实战指南

lowcode-engine 文档模型 DocumentModel 完全指南：属性、方法、事件与源码级实现解析

更多资讯

AI时代开源项目信任管理：Vouch机制解析与实践

PHP中草药查询系统：单表设计+全文检索实战