Help Center
帮助中心
搜索问题,或浏览下方分类。没有找到答案?提交工单,工作日 2 小时内响应。
快速开始
安装 SDK、初始化客户端、上报第一个指标的完整指引。
账户与计费
版本能力对照、额度查询、发票开具与升降级规则。
API 与集成
REST API 参考、Webhook 配置、与现有工具链集成。
数据接入
Kafka、OTLP、Fluent Bit 等接入方式与管道配置。
故障排查
数据延迟、查询超时、告警未触发等问题的定位手册。
安全与合规
加密机制、访问控制、审计报告与合规认证说明。
环境要求
接入前请确认
以下是采集 Agent 的最低运行环境。不满足时可改用 OTLP HTTP,由应用直接上报。
| 项目 | 最低要求 | 说明 |
|---|---|---|
| 操作系统 | Linux(x86_64 / arm64)、Windows、macOS | 提供 deb / rpm 与一键安装脚本 |
| 内存占用 | 512 MB | 空闲环境下实际约 180 MB |
| 磁盘占用 | 200 MB | 含本地缓存,默认上限 1 GB |
| Kubernetes | 1.19 及以上 | 以 DaemonSet 部署,自动感知节点标签 |
| 出网方向 | ingest.guanlan-data.com:443 | 仅需出站,无需开放任何入站端口 |
| 最小采样间隔 | 10 秒 | 低于该间隔的采集请求会被拒绝 |
FAQ
常见问题
SDK 上报失败或数据延迟,如何排查?
依次检查:1) API Key 是否有效且有配额;2) 网络能否访问
api.guanlan-data.com;3) SDK 版本是否 ≥ 2.0;4) 在控制台「管道监控」查看采集延迟与丢弃率。仍无法解决请提交工单并附上 SDK 调试日志。API Key 泄露了怎么办?
立即在控制台「设置 - 密钥管理」中轮换该 Key。轮换后旧 Key 立即失效,建议同时开启双因素认证,并将 Key 纳入密钥管理系统,不要提交到代码仓库。
免费版可以升级到专业版吗?数据会保留吗?
可以,升级即时生效,按日折算差价。升级后数据保留期从 7 天延长至 90 天,升级前已过保留期的数据无法恢复,其余数据完整保留。
支持哪些告警通知渠道?
邮件、短信、电话、Webhook、企业微信、钉钉与飞书。专业版及以上可用全部渠道;免费版支持邮件与 Webhook。
如何导出我的数据?
控制台「设置 - 数据导出」支持按时间范围导出为 JSON/CSV;也可通过
/v2/logs/search 等 API 编程导出。企业版支持导出至你自己的对象存储。删除账户后数据会被彻底清除吗?
会。删除账户后进入 30 天冷静期,期间可撤销删除;冷静期后所有数据(含备份)彻底清除,法律要求留存的交易记录除外。
免费版具体有哪些限制?
每月 5 GB 摄入额度、7 天数据保留、1 个项目与 3 个仪表盘;告警仅支持邮件与 Webhook 两个渠道,API 为只读查询,不支持数据导出。额度用尽后按 ¥0.35/GB 继续计费,服务不会中断。
支持哪些语言?没有官方 SDK 怎么办?
官方 SDK 覆盖 Java、Go、Python、Node.js 与 Rust,均要求 2.0 及以上版本。其他语言或无法引入依赖的环境,可直接用 OTLP HTTP 推送指标、日志与链路,接入端点见文档的接入前准备。
从 Prometheus / Grafana 迁移要多久?会有停机窗口吗?
没有停机窗口。Prometheus 直接
remote_write 即可接入,Grafana 面板与告警规则支持批量导入,PromQL 兼容、表达式无需改写。建议并行双写 1 - 2 周比对结果后再下线旧系统,详见迁移指南。支持私有化部署吗?数据会出域吗?
企业版支持专有云与混合云部署,整套平台可运行在你自己的 VPC 或机房,数据完全不出域,同时保留云端版本的全套能力与升级通道。部署形态与交付周期详见产品页或联系商务。
我的数据会被用于模型训练或对外提供吗?
不会。客户数据仅用于向你提供服务:不出售、不用于模型训练、不向第三方提供。我们仅在运维必需范围内处理数据(如故障排查),处理记录可在审计日志中查看。详见隐私政策。
团队协作怎么管理权限?
专业版起支持多成员与项目级 RBAC,可按角色分配查看、编辑与配置告警的权限;企业版在此基础上提供 SSO 单点登录、SCIM 自动开通与离职回收,以及更细粒度的标签级权限。