常见问题 (FAQ)

本文整理了使用 Softprobe 过程中最常见的问题与答案，帮助你快速定位与解决问题。

安装与配置

如何选择部署环境？

建议按阶段部署：开发 → 预发 → 生产，并分别配置公钥，逐步扩大采样范围以降低风险。

需要修改应用代码吗？

不需要。SP-Istio Agent 运行在服务网格层，SESSIFY 可按需集成前端，无需改动后端代码。

支持哪些 Kubernetes 环境？

支持主流的 Kubernetes 环境，包括自建集群与云厂商托管方案。Istio 版本需与 SP-Istio Agent 兼容。

性能与稳定性

会影响服务性能吗？

影响极小。Agent 与 SDK 均为轻量实现，支持采样、批量传输与本地优化。可根据业务负载调整参数。

如何处理高并发场景？

通过批量传输、队列缓冲与采样策略保持稳定。建议在生产环境按需调优采样率与队列大小。

数据安全

是否存储敏感数据？

不持久化敏感数据，传输全程 TLS 加密，并采用公钥认证签名。

如何进行密钥轮换？

公钥可热更新，无需停机。对不同环境使用不同公钥以降低风险。

运维与排错

构建或预览出现告警/断链怎么办？

先查看日志，定位断链来源；若为跨语言链接，使用相对中文路径或回退到英文页面以确保无断链。

如何确认数据采集正常？

查看仪表盘中的服务依赖图与追踪样例，确认前后端数据均有接入。必要时检查 Sidecar 注入与 SDK 初始化。

重要功能点速览

• 仪表盘：现代化自适应 UI、实时可视化、热力图与会话回放；技术栈为 React + Vite + TailwindCSS。
• OTEL 后端：接收 Trace/Log/Metric；使用 BigQuery 存储，并以 request_body_hash 建立索引实现快速关联与查找。
• 认证服务：多租户认证与授权；Public Key 全生命周期；JWT 工具；基于角色的权限（OWNER/ADMIN/MEMBER）。

为什么重要？

上述组件协同提供端到端可观测性与会话关联能力，确保数据高效查询并满足多租户的安全与隔离要求。

注意事项与最佳实践

• 环境隔离：生产与非生产分别使用不同租户/公钥；先小范围采样，逐步放大以降低风险。
• Public Key 管理：完整密钥仅在创建时展示；妥善保存并定期轮换；切勿将密钥提交到版本库。
• 速率限制：每个 Public Key 有每小时请求上限；客户端需实现重试/退避，并关注使用计数。
• 数据敏感性：避免在属性中发送敏感个人信息；依赖签名校验与 TLS；用哈希的请求体进行关联而非明文。
• 性能建议：BigQuery 索引随数据增长；结合时间窗口与 request_body_hash 过滤；必要时启用分区或缓存。
• 发布流程：使用 CI/CD（如 ArgoCD）配合镜像 Tag；仪表盘版本与后端 schema 变更需同步。

最佳实践

为不同项目/环境分别创建租户与公钥，提升审计与访问控制的清晰度。

注意

请勿在工单或聊天工具中粘贴完整 Public Key。UI 中仅展示掩码版本，若疑似泄露请立即轮换。

套餐与配额

• 存储配额（按租户）：可配置（例如租户设置中的 storageQuotaGb）；建议设置用量告警与容量规划。
• API 速率限制：按密钥的每小时请求上限（rateLimitPerHour）；需依据预估写入/查询负载进行容量规划。
• 多租户边界：资源（数据集/存储桶等）按租户与环境隔离，确保安全与成本控制。
• 企业版：支持更高配额、SLO 与自定义保留周期等高级能力，详情请联系 support@softprobe.ai。

---

如遇本文未覆盖的问题，请在社区或支持页面提交反馈。