跳到主要内容

安装与配置

基调听云探针与 SDK 是实现全栈可观测性的核心组件，为应用程序提供性能监控、错误追踪、调用链分析等能力。通过在应用中集成探针或 SDK，可以实时采集应用的运行数据，帮助您全面掌握系统的健康状态和性能表现。

概述​

本部署指南涵盖了基调听云可观测平台的所有探针和 SDK 的安装配置方法，包括：

  • 应用探针：用于后端服务监控，支持 Java、Python、Go、.NET、PHP、Node.js、C++ 等主流开发语言
  • 终端 SDK：用于前端和移动应用监控，支持 Web、Android、iOS、小程序、React Native、Flutter 等平台
  • 基础设施探针：用于 Kubernetes、eBPF 网络监控、通用进程监控等场景
  • 数据采集器：支持接入 Prometheus、OpenTelemetry、Zabbix 等第三方数据源

核心特性​

全语言支持​

为主流编程语言提供原生探针：

  • Java：字节码增强技术，零代码侵入，支持主流框架和中间件
  • Python：支持同步/异步框架，提供大模型专项监控能力
  • Go：编译时插桩和运行时监控，支持微服务架构
  • .NET/.NET Core：支持 Windows 和 Linux，完整的 CLR 性能分析
  • PHP：扩展方式部署，支持主流框架和数据库
  • Node.js：npm 插件方式，支持异步调用追踪
  • C++：支持原生应用和微服务框架

全平台覆盖​

为终端应用提供完整的 SDK 支持：

  • 移动端：Android、iOS、HarmonyOS NEXT
  • Web 端：浏览器应用、单页应用（SPA）
  • 小程序：微信、支付宝、钉钉、百度等主流平台
  • 跨平台：React Native、Flutter、Weex

智能化部署​

提供多种部署方式，满足不同场景需求：

  • 自动化部署：一键安装，自动发现应用
  • 容器化部署：支持 Docker、Kubernetes 环境
  • 无侵入集成：通过 Agent Attach、环境变量等方式注入
  • 插件化集成：通过 Gradle、CocoaPods、npm 等包管理工具集成

全面监控能力​

所有探针和 SDK 都提供以下核心能力：

  • 性能监控：响应时间、吞吐量、并发数等关键性能指标
  • 调用链追踪：分布式链路追踪，支持跨语言、跨服务调用分析
  • 错误监控：自动捕获异常、崩溃、错误日志
  • 资源分析：CPU、内存、网络、磁盘等资源消耗分析
  • 业务指标：自定义业务埋点和指标采集

快速开始​

后端应用监控​

如果您需要监控后端服务（如 Web 应用、微服务、API 服务等），请选择 应用探针部署：

语言/平台推荐场景部署方式
JavaSpring Boot、微服务架构Agent 启动参数 / 自动挂载
PythonDjango、Flask、FastAPIpip 安装 / 命令行启动
Go云原生微服务编译时插桩
.NET / .NET CoreWindows 服务 / 跨平台应用Profiler API
PHPWeb 应用扩展安装
Node.jsExpress、Koa 等框架npm 包引入
C++高性能服务动态库注入

终端应用监控​

如果您需要监控前端或移动应用，请选择 终端应用部署指南：

平台类型推荐场景集成方式
Android原生 Android 应用Gradle 插件自动集成
iOS原生 iOS 应用CocoaPods 集成
HarmonyOS NEXT鸿蒙应用ohpm 包管理器
Web浏览器 Web 应用JavaScript 代码嵌入
小程序微信/支付宝小程序SDK 引入
React Native混合开发应用npm 插件
Flutter跨平台应用Dart 插件

基础设施与数据采集​

如果您需要监控容器、网络或接入第三方数据：

部署建议​

  1. 评估需求：根据应用类型、技术栈选择合适的探针或 SDK
  2. 测试验证：在测试环境完成集成和功能验证
  3. 性能评估：确认探针对应用性能影响在可接受范围内
  4. 灰度发布：先在部分实例部署，观察数据采集情况
  5. 全量上线：确认无误后推广到生产环境

提示：探针和 SDK 都经过优化，对应用性能的影响通常小于 5%。建议优先在非生产环境验证，确保数据采集正常后再部署到生产环境。