View a markdown version of this page

为 Amazon Chime SDK 会议设置日志记录和监控 - Amazon Chime SDK
用于对指标进行故障排除的选项推荐的指标启用客户端日志记录启用服务器端日志记录

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

为 Amazon Chime SDK 会议设置日志记录和监控

日志记录可帮助您收集诸如服务器端会议事件和客户端浏览器控制台日志等信息。

Amazon Chime SDK 提供服务器端会议活动，您可以将其发送到亚马逊和 EventBridge 亚马逊 CloudWatch 活动日志。您可以创建 CloudWatch 指标和见解，并在控制面板中使用它们进行监控。Amazon Chime SDK 事件的Server-side 记录和监控博客文章介绍了如何启用 CloudWatch 指标、见解和控制面板。

Amazon Chime SDK 提供客户端事件，用于监控音频和视频质量、网络带宽和连接问题。使用 Amazon Chime SDK 会议事件进行监控和故障排除博客文章介绍了如何针对加入失败、音频质量问题以及麦克风和摄像头设置失败启用 CloudWatch 指标、见解和控制面板。有关会议活动的更多信息，请参阅 Github 上的会议事件。

用于对指标进行故障排除的选项

您可以使用以下选项来收集故障排除事件。

  • 在每次活动时发送指标

  • 每 N 秒批处理一次事件

  • 在会议结束时发送指标

  • 浏览器控制台日志的日志记录级别

推荐的指标

您至少应收集和记录以下指标。

  • SDK 平台和版本

  • 浏览器和版本

  • 操作系统

  • 逻辑函数

  • 会议开始

  • 会议结束

  • 已加入与会者

  • 已离开与会者

  • 已掉线与会者

此外，根据您遇到的问题，以下指标可以提供有关连接、带宽和质量问题的信息。您可以将这些指标每一次出现的情况记录下来，也可以只计算数量。计数可以提供对潜在问题的总结视图：

  • 连接 DidSuggestStopVideo

  • 连接 DidBecomeGood

  • 连接 DidBecomePoor

  • Attendee join time > t seconds

  • MeetingStartFailed

  • MeetingFailed

启用客户端日志记录

您可以通过将 LogLevel.INFO 传递给 ConsoleLogger 对象来启用 INFO 级别的浏览器日志。

const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController);

您还可以使用 Amazon Chime 软件开发工具包中的POSTLogger组件 JavaScript 来捕获后端的浏览器日志，例如亚马逊 CloudWatch 日志。 POSTLoggerHTTP POST请求将浏览器日志上传到 P ostLogger 构造函数中的给定网址。例如，上的 Amazon Chime SDK 无服务器演示 GitHub使用将浏览器日志发送POSTLogger到 Amazon Logs 以 CloudWatch 供将来调查。

启用服务器端日志记录

适用的 Amazon Chime SDK JavaScript 还会使用关键会议事件（例如MeetingStartFailed和）调用eventDidReceive旁听者方法。MeetingFailed会议活动通常包括故障的具体原因。例如，假设一大群客户遇到故障。您的 Web 应用程序可收集这些会议事件，然后与我们共享以排查根本原因。有关会议活动的更多信息，请参阅上的 GitHub会议活动指南以及使用 Amazon Chime SDK 会议事件进行监控和故障排除博客文章。