FluidFramework 中的类型化遥测系统详解-优快云博客

FluidFramework 中的类型化遥测系统详解

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

什么是 FluidFramework 类型化遥测

FluidFramework 提供了一套完整的类型化遥测系统，用于生成和消费稳定的类型化遥测数据。这套系统为 Fluid 应用程序提供了强大的监控能力，是构建云服务（如仪表板和告警系统）的基础设施。

类型化遥测的主要特点包括：

强类型定义：所有遥测数据都有明确的类型定义
版本控制：通过语义化版本控制避免意外变更
当前主要关注容器级别的遥测数据

快速入门指南

场景一：将容器遥测记录到 Azure Application Insights

准备工作

在 Azure 门户中创建 Application Insights 实例
获取实例的连接字符串（InstrumentationKey）

实现步骤

安装必要的 npm 包：

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

初始化 Application Insights 客户端：

const appInsightsClient = new ApplicationInsights({
    config: {
        connectionString: "你的连接字符串"
    }
});
appInsightsClient.loadAppInsights();

配置并启动遥测收集：

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

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

基本步骤

安装 Fluid 遥测包：

npm install @fluidframework/fluid-telemetry

实现 ITelemetryConsumer 接口：

class MySimpleTelemetryConsumer implements ITelemetryConsumer {
    consume(event: IFluidTelemetry) {
        console.log(event);
    }
}

在容器初始化时启动遥测：

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

遥测数据分析与可视化

理解协作会话概念

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

Application Insights 查询示例

1. 会话基本信息查询

let sessionGap = 5m;
customEvents
| extend containerId = tostring(customDimensions.containerId)
| where name startswith "fluidframework.container"
| summarize StartTime=min(timestamp), EndTime=max(timestamp) by containerId
| extend Duration = datetime_diff("minute", EndTime, StartTime)

2. 时间段内会话总数

let interval = 10m;
customEvents
| where name startswith "fluidframework.container"
| summarize SessionCount=dcount(containerId) by bin(timestamp, interval)
| render timechart

3. 会话平均时长

customEvents
| extend containerId = tostring(customDimensions.containerId)
| summarize Duration=datetime_diff("minute", max(timestamp), min(timestamp)) by containerId
| summarize AvgDuration=avg(Duration)