Vue.js 应用实现监控可观测性最佳实践

news2025/1/6 20:15:51

前言

Vue 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建，并提供了一套声明式的、组件化的编程模型，帮助你高效地开发用户界面。无论是简单还是复杂的界面，Vue 都可以胜任。

TinyPro 是一套使用 Vue 编写的中后台管理后台框架，官网地址：https://www.opentiny.design/vue-pro/docs/start ，下面以 TinyPro 为例来接入如何实现 Vue 应用的可观测性。

环境信息

Node 版本 > 10

接入方案

准备工作

注册观测云账号（ Guance ）
安装了 vue（快速上手 | Vue.js ）、TinyCli（ https://www.opentiny.design/tiny-cli/docs/start ）

第一步：在观测云创建应用

这里面的就是配置代码，后面会用到。

第二步：下载 tinyPro 管理后台

tiny init

控制台提示如下：

成功安装大概样式：

项目结构如下：

接入观测云 SDK

接入观测云 SDK 有两种方式：npm 或者 cdn，选择其中一种即可。

npm 方式接入

在项目根目录执行以下脚本安装 sdk 。

npm install @cloudcare/browser-rum

安装脚本后，找到入口文件，并粘贴如下代码，注意修改。

//引入观测云rum的sdk
import { datafluxRum } from '@cloudcare/browser-rum'

cdn 方式接入

在当前目录下找到 index.hml 并把观测云接入代码拷贝到 head 标签内，如下图所示。

配置启动参数

通过配置的参数能设置应用名称、版本、环境、采样率等。

cdn 方式接入

cdn 方式接入有同步或异步，如果选择同步方式，可以按照如下接入。

npm 方式接入

//初始化sdk
datafluxRum.init({
  applicationId: 'guance',//应用id
  site: 'https://rum-openway.guance.com',
  clientToken:"***" // 请在3.1的第一步中创建的内容查看clientToken
  env: 'production',
  version: '1.0.0',
  sessionSampleRate: 100,
  sessionReplaySampleRate: 70,
  trackInteractions: true,
  traceType: 'ddtrace', // 非必填，默认为ddtrace，目前支持 ddtrace、zipkin、skywalking_v3、jaeger、zipkin_single_header、w3c_traceparent 6种类型
  allowedTracingOrigins: ['https://api.example.com', /https:\/\/.*\.my-api-domain\.com/],  // 非必填，允许注入trace采集器所需header头部的所有请求列表。可以是请求的origin，也可以是正则
})