Fluid Framework 类型化遥测技术详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00413/article/details/148508844

Fluid Framework 类型化遥测技术详解

FluidFramework Library for building distributed, real-time collaborative web applications 项目地址: https://gitcode.com/gh_mirrors/fl/FluidFramework

什么是 Fluid Framework 遥测系统

Fluid Framework 提供了一套完整的类型化遥测解决方案，用于收集和分析 Fluid 应用程序的运行数据。这套系统采用强类型设计，并内置版本控制机制，确保遥测数据的稳定性和一致性，避免意外变更导致的数据中断问题。

目前该系统主要支持容器级别的遥测收集，未来会根据需求扩展更多功能领域。

核心应用场景

场景一：将容器遥测数据发送到 Azure App Insights

准备工作

在 Azure 门户创建 App Insights 实例
获取该实例的连接字符串

实现步骤

安装必要依赖包：

npm install @fluidframework/fluid-telemetry @microsoft/applicationinsights-web

初始化遥测收集系统：

// 初始化 App Insights 客户端
const appInsightsClient = new ApplicationInsights({
    config: {
        connectionString: "你的连接字符串"
    }
});
appInsightsClient.loadAppInsights();

// 配置遥测参数
const telemetryConfig: TelemetryConfig = {
    container: myAppContainer,
    containerId: myAppContainerId,
    consumers: [new AppInsightsTelemetryConsumer(appInsightsClient)]
};

// 启动遥测收集
startTelemetry(telemetryConfig);

场景二：自定义遥测消费者

如需集成到其他云服务或自定义仪表板，可以实现自定义消费者：

创建实现 ITelemetryConsumer 接口的类：

class MyCustomConsumer implements ITelemetryConsumer {
    consume(event: IFluidTelemetry) {
        // 自定义处理逻辑
        console.log("收到遥测事件:", event);
    }
}

在配置中使用自定义消费者：

const telemetryConfig: TelemetryConfig = {
    container: myAppContainer,
    containerId: myAppContainerId,
    consumers: [new MyCustomConsumer()]
};

遥测数据分析指南

核心概念：协作会话

在 Fluid 遥测系统中，"会话"或"协作会话"是指具有相同容器ID的连续遥测数据流。如果数据流中断超过指定时间（默认为5分钟），则认为会话结束。

实用查询示例

1. 会话基本信息查询

// 查询会话ID、容器ID、协作者数量和持续时间
customEvents
| extend containerId = tostring(customDimensions.containerId)
| where name startswith "fluidframework.container"
// 详细查询逻辑...
| summarize NumCollaborators = dcount(containerInstanceId), 
           StartTime = min(timestamp), 
           EndTime = max(timestamp) 
           by SessionId, containerId

2. 时间段内会话总数

// 查询每10分钟间隔内的会话总数
let summedDataPointInterval = 10m;
customEvents
// 详细查询逻辑...
| make-series sumSessions = dcount(SessionId) on timestamp 
| render timechart

3. 会话平均时长分布

// 查询会话时长分布（2.5分钟为间隔）
let sessionLengthMinuteBins = 2.5;
customEvents
// 详细查询逻辑...
| summarize SessionCount = count() by bin(PeriodDurationInMinutes, sessionLengthMinuteBins)
| sort by PeriodDurationInMinutes asc