这些页面显示的是Cloud的URL。在Dedicated上登录后,即显示您服务器的URL。

Observatory

Observatory是您应用的链路、日志、指标和会话汇聚的地方。从顶部的搜索开始:输入任何内容,无论它在哪里都能找到。

每个Observatory界面顶部的搜索框都能搜索全部内容。开始输入;从两个字符起,搜索框下方的面板就会列出匹配项,按类型分组。每一行都是一个链接。

输入得到的结果
链路ID“Open trace”:链路本身。可粘贴日志行、告警或支持工单中的ID。
任意词语包含它的“Logs”,以及Span名称或属性中包含它的“Traces”,各自附带时间范围内的数量。
指标名称的一部分名称中包含它的指标,来自语义约定以及您的应用发送的数据。
用户ID该用户的“Sessions”。会话ID会打开该会话的回放。
主题匹配的帮助页面和Control Room设置。
问题“Ask Dartastic AI”,始终位于最后一行:打开“Ask”,并已填入您的问题。
  • 键盘:在任意位置按/跳转到搜索框,按↑和↓在结果中移动,按Enter打开,按Esc关闭。
  • 计数基于当前时间范围(见下文)。
  • 如果某类结果无法读取,该行会说明,其他结果仍会显示。
顶栏搜索已打开,已输入一个词,结果按类型分组(Logs、Traces、Metrics、Sessions、Help、Ask)

所有界面共用一个时间范围

搜索框旁的时间选择器为所有界面设置同一个范围:“Logs”、“Traces”、“Metrics”和单个指标、“Sessions”、仪表板、“Crashes”和“Issues”。选择“Last 24 hours”,每个界面都会显示最近24小时。选择器显示您当前所在界面的范围(包括仪表板、“Crashes”、“Issues”和单个指标),在这里选择会改变该界面。每个界面自己的选择器设置的也是同一个范围,因此两者始终一致。

  • 界面会保留状态。从“Metrics”切换到“Logs”再切回来:您的筛选条件和选择仍然保留。
  • 自定义:每个时间选择器(包括顶栏的)最后一项都是Custom。按Observatory的时区将From和To设为时钟时间,然后选择Apply或按Enter;Cancel或Esc会保持原有范围。自定义范围与“Last 24 hours”一样适用于所有界面,直到您选择其他范围。它最长可达31天,在“Crashes”和“Issues”上为14天。
  • 链接中指定的范围优先。打开告警或Ask回答中的链接,您看到的是该链接的范围。任何界面链接中的“Last 7 days”这类范围(包括仪表板、“Crashes”、“Issues”和单个指标的链接)都会成为所有界面共用的范围。固定的From和To(例如链路的日志或缩放)只作用于其所在界面,您在该界面时顶栏会显示它。
  • 界面不提供的范围会显示为该界面所提供的、能覆盖您所选范围的最短选项,若没有则显示其最长选项,顶栏显示界面实际显示的范围。“Sessions”从最近24小时起,因此在“Last hour”下显示最近24小时。仪表板、“Crashes”和“Issues”从最近1小时起,因此在“Last 15 minutes”下显示最近1小时。在“Last 30 days”下,除“Sessions”外的所有界面都显示最近14天。链接中的范围也按同样方式处理:最近30天的仪表板链接会以最近14天打开,地址栏也会如此显示。自定义范围完全按您的设置显示,在“Crashes”和“Issues”上最多显示其最后14天。
  • 图表覆盖整个范围。在仪表板上,每个图表的时间轴都覆盖所选范围,而不只是有数据的那一段:没有记录任何数据的步长显示为空缺,绝不显示为零。
  • 范围按浏览器标签页保存。
[TODO:搜索框旁的顶栏时间选择器已打开的屏幕截图]

Traces:搜索链路

“Traces”打开时显示时间范围内最新的链路,最新的在前。

  • 筛选标签:“Service”、“Span name”、“Duration”(起始值、结束值或两者)、“Status”,以及通过+ Attribute以key = value形式添加的任意属性。每个筛选标签的菜单都会列出时间范围内的取值,以及每个取值对应的链路数量。
  • 时长随时间变化:每条链路一个点,错误以红色显示在其他点之上。在图表上上下拖动可设置时长范围;点击一个点可打开该链路。图表显示所有状态和时长,因此错误和慢链路一目了然。链路非常多时,图表会说明显示的是抽样。
  • 匹配的链路:开始时间、链路ID(附“Copy”)、根Span、服务、版本、Span数、时长和状态。所有筛选标签都会生效。Columns用于选择显示哪些列。点击列标题可按该列对所有匹配链路排序,从高到低;再次点击则从低到高。点击一行即可打开该链路。
  • 部分链路:当链路的根Span不在时间范围内时,该行由范围内最早的Span构建,并标记为partial。
  • Load 50 more分页加载列表,最多10,050条链路;超过后会显示“Narrow the filters to see the rest.”
  • Text:从顶栏搜索会添加一个“Text”筛选标签:Span名称或任何属性值中包含这些词语的链路。
链路搜索:已设置筛选标签、带有错误点的时长图表,以及含一行部分链路的表格

链路详情

链路以瀑布图显示其Span,每个条形按时间排布,错误以红色显示。点击一个Span,即可在瀑布图及其事件下方查看其详情。

  • 时钟校准:当链路中的服务使用不同的时钟时,服务器Span可能看起来在其响应的调用结束之后才开始。“Trace”界面会将这样的Span连同其服务下的Span一起移到所属调用之内。显示链路开始时间、时长和Span数的那一行会说明移动了多少个,例如2 spans moved to their callers' clocks,显示的时长也是校准后的时长。被移动的Span的详情会在其时长和开始时间下方说明移动了多少:Moved 622 ms earlier to sit inside the call it answered: checkout-api's clock and its caller's disagree.
  • 属性:先是Span自身的属性,然后是发送它的服务的属性。
  • 错误:记录了错误的Span会在此标签页打开:类型、消息和调用栈。已符号化到源代码的调用栈排在最前,下方是应用发送的Original stack,各自带有“Copy”。调用栈无法符号化时,消息下方的一行会说明原因,例如该构建的符号尚未发布。
  • 事件:瀑布图下方按时间顺序列出链路中各Span记录的每个事件,附带其所属Span和距链路开始的时间。点击一个事件可在Span详情中查看其属性。地址栏中的链接会在该事件处打开链路。
  • Logs in trace #…:链路(或所选Span)写入的日志记录,最早的在前,每条附带其所属Span。点击行的任意位置即可在“Logs”中打开该记录。

Logs:在任何记录中查找任何词语

“Logs”上的搜索框(Search messages and attributes)可查找在任何位置包含您所输词语的记录:消息、事件名称,或任何属性值(记录自身的或其应用的)。它不区分大小写,最多可输入500个字符。

  • 筛选条件:“Service”、“Severity”、“Screen”、“Build”,用+ Attribute精确匹配key = value,或用Has this field, any value查找带有该键的所有记录。为“Screen”、“Build”或某个属性添加第二个值后,筛选会匹配其中任意一个(Build one of 1.2.0+14, 1.2.1+15)。Reset filters to All会清除它们。
  • 来自Ask回答:回答所引用的日志行会以该回答使用的完全相同的筛选条件打开“Logs”,因此您看到的正是它读取的那些记录。
  • 按严重级别的日志量:在图表上拖动以选择一段时间并查看其计数,然后点击Zoom to selection。
  • 五种严重级别:Error、Warn、Info、Debug,以及用于无严重级别记录的Unspecified,例如SDK的事件(点击、屏幕浏览、生命周期变化、会话开始)。每个级别在日志量图表中有各自的颜色,在图例中有其计数,在“Severity”筛选中有其位置,记录的标签会注明其类别,例如UNSPECIFIED。
  • 记录:最新的在前;打开一条可查看其完整消息,然后是其全部属性。长消息超过十行后可滚动。没有消息的事件会在消息位置以等宽字体显示其事件名称,与链路的日志和回放的日志行中一样;打开后,会在severity_text之后列出event_name。没有任何匹配时,界面会说明是哪个筛选条件排除了所有记录。
按页面和构建筛选的“Logs”,日志量图表中选中了一段,以及记录列表

Metrics:您的应用发送的每个指标

“Metrics”按名称列出时间范围内出现的每个指标:类型(计数器、增减计数器、仪表、直方图、摘要)、单位、描述、发送它的服务,以及它有多少个序列。可按Service、Kind或Name筛选。点击一行会以相同范围打开该指标。

  • Metric界面以各自的方式绘制每种类型:计数器的增长(折线或柱状,前6个序列加“Other”,可与上一个构建对比)、增减计数器的水平值、仪表的典型设备和负载最重的设备,以及以热力图显示并带有p95线的直方图。
  • Filters和Split by:按该指标记录的属性缩小范围,并按其中一个属性拆分图表。
  • 处处显示单位:每个坐标轴和悬停卡片都显示指标的单位(250–500 ms、taps / 10 minutes),时间轴会注明您的时区,范围跨越午夜时还会显示日期。
“Metrics”列表:名称、类型、单位、描述、服务、序列
以热力图显示并带有p95线的直方图指标,两个坐标轴都显示单位

自动补全认识您的名称

在任何输入名称或值的地方(“+ Attribute”、筛选标签的值、指标名称、告警规则的条件),建议都来自两个来源:OpenTelemetry和Dartastic的语义约定(各附类型和简短描述),以及您的应用实际发送的名称,标记为seen in data或last seen并附时间。建议会适配当前界面:“Traces”上是Span和资源名称,“Logs”上是日志、事件和资源名称,“Metrics”上是指标名称,然后是该指标自身的属性。

仪表板

“Dashboards”按文件夹列出内置仪表板和团队保存的仪表板,并支持搜索;New dashboard和Import可添加您自己的仪表板。Lists下是Crashes和Issues。每个面板都会打开其背后的界面。

每个内置仪表板都有自己的页面,逐个面板说明:

以及两个列表:“Crashes”列表和“Issues”列表。

最近24小时的“Screen time”仪表板

阅读仪表板

  • 工具栏:仪表板的筛选条件(在您选择值之前均为All)及其范围:Last hour、Last 6 hours、Last 12 hours、Last 24 hours(默认)、Last 7 days、Last 14 days或Custom。地址栏中的链接保存了仪表板、其范围和筛选条件。
  • 每个面板都读取所选范围。统计值、仪表、排名列表、条形仪表、饼图或表格显示整个范围的单一数值;图表显示范围内的每个步长,没有记录数据之处为空缺,统计值的迷你走势图也覆盖整个范围。
  • 表格按第一个数值列对行排序,该列以其计数对象命名,例如App starts或Calls;其后的每一列都针对同一行读取。面板下方的说明会用简明的语言说明它读取的内容。
  • 时长以合适的单位显示:一分钟以内用毫秒或秒,一分钟及以上用分钟、小时或天,例如20.96 h。图表坐标轴的所有刻度使用同一单位,即其最大值所用的单位。超过一分钟时,刻度按整数步长显示,例如10, 20, 30 min。
  • 统计值显示其数值,下方是该范围的迷你走势图。带对比的统计值会显示相对于前一个等长范围的变化,例如▼ 35% vs prior 14 days:朝好的方向变化时为绿色,朝另一方向变化时为红色。
  • 颜色:数值超过警告阈值时变为琥珀色,超过严重阈值时变为红色。图表以标注为warn和crit的虚线绘制这些阈值。每个仪表板的页面都列出了每个面板的阈值。
  • 应保持高位的比例图表(例如无崩溃会话)的坐标轴从略低于其最低值或目标值处开始,而不是从0%开始,因此请对照坐标轴解读下降幅度。
  • 每个构建或服务有多个数值:像Cold start p50 and p95 by build这样的面板为每个构建或服务分配一种颜色,除最后一个数值外,其他数值都以细虚线绘制。
  • 按平台划分的面板为每个os.type绘制一条线。Web不发送该值,因此其线条显示为web。
  • 靠前的序列:除非面板另有说明,图表保留前六个序列,列表保留前十项;数量更多时,面板会显示Showing 6 of 14 series。
  • 不编造零值:范围内没有数据的面板会显示Nothing recorded in this range.读取会话结束方式的面板,在没有会话结束时会说明其数值无法计算,绝不显示100%。
  • 无法读取的面板会在其自身位置说明原因,仪表板的其余部分照常绘制:通常是The telemetry store did not answer for this panel. Reload to try again.如果您已退出登录,或完全没有响应,整个仪表板会显示We couldn't load this dashboard。
  • 仅限Web:只读取首字节时间的面板在设置了Platform时会隐藏,因为Web报告不携带平台信息。
  • 点击面板标题即可打开解释该面板的界面,并沿用仪表板的范围和筛选条件。
  • 内置仪表板为只读(System, read-only):Save a copy会创建一个您可以编辑的副本,Export会将其定义下载为JSON。已保存的仪表板还会增加Edit JSON、Versions和Delete。
  • Ask:顶栏的Ask Dartastic AI会在提问时带上当前仪表板、其范围和筛选条件。

Sessions和Replay

“Sessions”列出时间范围内用户的访问,最新的在前。每行是一个会话:开始时间、持续时长、浏览了多少个页面、其错误和受挫点击、用户、设备、应用构建(最新的标记为latest)、可复制的会话ID,以及Replay(未录制回放的会话则为Timeline)。点击一行即可打开。

查找会话

  • 按用户:在User id中输入用户ID,然后选择Find sessions。匹配是精确的,而且只有用户登录期间产生的记录才带有用户ID。在任意一行中,点击用户可只列出该用户的会话,也可复制用户ID。用户ID属于个人信息:只在您搜索它的地方显示。
  • 从顶栏:搜索用户ID可列出该用户的会话;搜索会话ID可打开其回放。
  • 时间范围:“Last 24 hours”、“Last 7 days”、“Last 14 days”、“Last 30 days”或Custom。
  • Errors和Frustration:勾选Errors可只列出至少有一个错误的会话,勾选Frustration可列出有愤怒点击、无效点击或错误点击的会话。两者都勾选则列出两者兼有的会话。
  • Screen和Build:列表上方的菜单可将范围缩小到访问过某个页面(选择页面或输入其名称)或运行过某个构建的会话。
  • 先询问:在只列出筛选后会话的部署中,“Sessions”会显示“Which sessions?”,直到您选择页面或构建,或搜索用户ID。

按任意属性筛选

可对应用记录的任何内容进行筛选:使用+ Attribute,或输入一行筛选条件后选择Filter(或按Enter):

filter
user.email = 'rum2@example.com'
app.screen.name = '/checkout' AND exception.type exists
resource.service.version contains '1.2' AND user.id != 'test-user'
  • + Attribute列出您的应用在时间范围内发送的属性;选择一个属性,然后选择一个值。
  • 子句由字段、运算符和值组成:=、!=或contains。也可以是字段加exists或missing。用AND连接多个子句;会话必须全部匹配。
  • 值是放在单引号或双引号中的文本(文本内的引号要写两次:'O''Brien'),或一个数字。
  • 字段是属性名称,例如user.email或app.screen.name。不带前缀时为日志属性;以span.、resource.、event.或point.开头则表示相应类型的属性,例如resource.service.version。
  • 每个子句都会变成一个筛选标签,显示在筛选行下方;点击其×即可将其移除。
  • 无法解析的筛选行不会执行:界面会高亮出错的部分,并说明应该怎么写。
  • 被筛选的字段会变成列,显示在列表左侧,列出每个会话在该字段上的值(最多五个)。

排序

点击列标题即可按该列排序:“Started”、“Duration”、“Screens”、“Errors”、“Frustration”、“User”、“Device”或“App build”。第一次点击按从高到低排序(最新、最长、最多);再次点击则从低到高。排序涵盖所有匹配的会话,而不只是屏幕上显示的会话。未排序时,“Sessions”按最新在前显示。

更多结果、分享和无结果

  • 显示更多:列表底部会说明显示了多少个匹配项;Show 200 more会加载下一批。
  • 分享您看到的内容:用户、范围、菜单、筛选行和排序都保存在页面链接中。复制链接,团队成员即可打开同一个列表。
  • No sessions found会说明原因,并允许您通过ID打开会话。

Replay回放一个会话:每一刻的屏幕、点击(愤怒点击以红色显示),旁边是按时间排列的会话页面、点击、错误、Span和日志。会话录制所用的保真度按录制顺序显示在顶部会话ID之后,例如Shadow, Pixel。未录制回放的会话拥有相同的时间线和事件,手机画面上会显示Waiting for recording。

在Shadow或Pixel级别下,手机画面会先显示每帧的线框图,直到其图像加载完成,期间手机下方显示Image loading,然后显示图像。“Replay”打开时会从播放头开始预加载图像,因此拖动进度会改变接下来加载的内容。“Whole session”条内的一条细黄条显示加载进度,加载完成后消失,因此您可以直接播放线框图,也可以等待图像加载。未通过校验或下载失败的图像会显示This image couldn't be shown.在会话的第一帧之前,手机画面已经显示该帧。

“Replay”无法读取的记录会被跳过,其余部分照常播放。播放器会说明跳过了多少条,并给出第一条的问题,供您发送给支持团队。没有任何可读记录的会话也会说明这一点,并附上可发送的问题。

Whole session条覆盖会话从开始到结束的全过程。其标题统计页面、点击、错误和受挫信号;会话未正常结束时,会说明结束方式:ended with errors、crashed或ended abnormally。将鼠标悬停在这些词上可查看其含义。当应用在前台时停止运行且没有记录任何原因(强制退出、被操作系统终止或调用退出)时,会话即为异常结束;这会在应用下次启动时被发现。正常结束或仍在进行的会话不显示任何内容。

这里的点击计数方式与“Sessions”列表相同,包括没有点中任何widget的点击及其中的愤怒点击。点击会注明其widget名称;widget没有名称时则注明其key。没有点中任何widget的点击显示为Tap the screen。

“Replay”不会让您干等。应用在后台的时间会从时间线中移除,标记为//并注明持续时长,播放时绝不会播放这段。屏幕上没有任何变化且持续5秒或以上的片段也会同样标记,并在播放时跳过;点击标记可跳过该段,或关闭Skip unchanged来观看这些片段。时钟下方的一行会说明跳过了什么,例如“Session 1 min 24 s; skipping 1 min 20 s with no change”。

错误以红色显示:异常、错误Span,或长到操作系统可能提示关闭应用的卡死(“App not responding for 10 s on /settings”)。较短的卡死不会标记为错误。当播放头经过错误或Span时,其链路和日志行会显示在下方,并附有Open trace,一键即可打开。点击红色错误(在播放头下或事件中)可在异常处打开其链路;在任何链路之外记录的错误会注明这一点。

Space播放和暂停;←和→前后移动五秒;[和]打开上一个和下一个会话。

[TODO:Replay:一个正在播放回放的会话、带有“//”中断标记的“Whole session”条、一个红色的“App not responding”事件、条形标题中的“ended abnormally”,以及时钟下方的跳过说明行的屏幕截图]

App Installs

“App Installs”列出您应用的安装实例:每个app.installation.id一行,最近出现的排在最前。每行显示安装ID、用户、设备及其操作系统、应用版本和构建号,以及最后出现的时间。安装实例在发送第一条链路后即被列出,并在其最后一条链路之后保留六个月。

  • 搜索:输入安装ID、用户ID或邮箱地址的开头部分,然后选择Search。ID按输入内容精确匹配,区分大小写;邮箱地址不区分大小写。
  • 用户:当您的应用在其链路上记录用户ID和邮箱时(user.id、user.email),会显示这些信息。
  • Previous和Next按每页50个浏览安装实例;计数会显示您所在的位置(“1–50 of 10,000”)。
  • 按制造商和应用版本:列表下方的饼图按设备制造商显示您的安装实例,内环显示每个制造商对应的应用版本。
  • 点击一个安装实例即可在其正下方打开其卡片,再次点击可关闭卡片。卡片显示用户ID和邮箱、首次和最后出现的时间,以及它最后发送的每个资源属性。Sessions列出其会话。

当操作系统清除应用缓存时,或将备份恢复到新手机上时(Android自动备份、iCloud),安装实例会保留其ID,因此新手机会延续为同一个安装实例。在开启自动备份的情况下重新安装Android应用,ID也会保留。清除应用数据,或在没有备份的情况下重新安装,则会产生新的安装实例。

如果两部手机从同一个备份恢复,或旧手机仍在使用,它们会共享该ID并计为一个安装实例。恢复后的手机首次启动时可能会报告备份中的最后一个会话,因此每次恢复都可能导致一个会话被计算两次。

[TODO:App Installs:已输入搜索内容的列表、制造商饼图,以及一个已打开卡片的安装实例的屏幕截图]

录制此设备

当用户报告问题时,可按您选择的回放保真度录制其设备,需征得用户同意,且无需发布新构建。打开其安装实例并选择Start RUM:

  • Fidelity:Events、Outline、Wireframe、Shadow或Pixel,从低到高。设备按您选择的级别录制,无论高于还是低于应用自身的级别,即使在其他情况下回放处于关闭状态也是如此。它绝不会以高于应用构建时设定的最高级别(DARTASTIC_RUM_FIDELITY_MAX)录制;最高级别较低的构建会按该最高级别录制。
  • Expires in:5分钟、15分钟、30分钟、1小时、2小时、4小时或8小时,初始为15分钟。在到期之前,设备会录制其启动的每个会话。即使设备再也不发送遥测数据,录制也会在到期时结束。

对话框会复述将要发生的事情,例如“The next time this device sends telemetry it will record at Pixel fidelity for up to 15 minutes.”,然后选择Record。

[TODO:Start RUM:已选择保真度并显示复述语句的对话框的屏幕截图]

录制指令经过签名,只发送给那一个安装实例,随其下一次遥测数据的响应下发。其他安装实例都不会收到。从同一个备份恢复的手机共享一个安装实例,因此两部手机都会收到。开始录制之前,设备会检查签名、录制指令是否指向此安装实例,以及到期时间。

随后应用会作出回应,在此之前其他遥测数据照常发出。带有自己界面的应用会询问用户,说明保真度和录制结束的时间。只有用户同意后才会开始录制,并且用户可以随时停止。如果用户拒绝,则不会录制任何内容,支持团队会收到通知。在同意已包含在工作职责中的场景下,应用无需显示界面即可允许请求。不回应的应用不会录制,支持团队同样会收到通知。

它录制的会话是“Sessions”和“Replay”中的普通会话,其回放记录带有dartastic.rum.elevation.provenance:support:以及发起者的ID。要列出这些会话,请在“Sessions”中按dartastic.rum.elevation.provenance contains 'support:'筛选。

您的应用通过DOTel.rumSupportRequests作出回应,支持iOS、Android、macOS、Windows和Linux,以及Dart服务器或命令行工具。请在DOTel.initialize之前开始监听。每个请求都注明其fidelity、请求者(provenance)和结束时间(expiresAt)。使用DOTel.allowRumSupportRequest或DOTel.declineRumSupportRequest作答。

dart
// An internal app, where consent comes with the job.
DOTel.rumSupportRequests.listen((request) {
  if (request != null) DOTel.allowRumSupportRequest(request);
});

当用户撤回同意时,DOTel.withdrawRumReplay()会清除遗留的内容。它会结束任何正在进行的录制和任何等待中的请求,并丢弃为出错时捕获而保留的回放,以及先前捕获但仍在队列中的回放。会话和所有其他遥测数据仍会发出。这是一次性操作,而不是开关。

当Web应用的端点向浏览器暴露Dartastic-Elevation响应头时,Web应用会跟随录制,Dartastic Cloud的端点就是如此。

设备录制期间

  • Recording会在列表中和其卡片上标记该安装实例。
  • Support recording列出您组织中所有已启用录制的安装实例,最早到期的排在最前,并显示其保真度和到期时间。点击一个安装实例可在列表上方打开其卡片。
  • Reported是“Support recording”中的一列,显示设备最近一次报告的录制情况。所有能查看Observatory的人都能看到它。None表示设备尚未报告任何内容。否则显示为:
    • Stopped by the user,以及时间。
    • Declined,以及时间。它并不表示有人拒绝:应用可以按其自身策略回应请求。
    • Already recording,自何时起、以何种保真度,原因是应用自身的设置或另一个支持录制。
    • Waiting for the app's answer,自何时起。无需界面即可回应的应用可能会直接进入“Recording”。
    • Recording,自何时起,以及实际录制所用的保真度。
    • Ignored by the device,以及原因(见下文)。
  • 状态标签显示在已启用录制的安装实例上(安装实例列表中、其卡片上以及“Start RUM”对话框中),内容为Recording、Stopped、Declined、Ignored或Waiting。当设备报告它已在录制时,状态标签仍显示“Recording”。
  • Start RUM在状态标签显示“Recording”时不可用,因为第二个录制会替换正在进行的录制。将鼠标悬停其上可查看该录制的到期时间。要开始另一个录制,请先在“Support recording”下对其执行“Disarm”。状态标签为其他任何值时,“Start RUM”均可用,再次录制会替换已启用的录制。
  • Disarm(在“Support recording”中或对话框中)会结束录制。设备在下一次发送遥测数据时停止。录制也会在到期时结束,或在用户于其设备上停止时结束。
[TODO:Support recording:列表中一个已启用录制的安装实例,以及安装实例列表中它的“Recording”状态标签的屏幕截图]

在以下情况下,设备会忽略录制指令,不启动任何录制:

  • 应用的构建不知道是谁对其签名
  • 其格式比应用的SDK更新
  • 其签名未通过验证
  • 应用的构建不是为此组织生成的
  • 应用的SDK不认识其保真度
  • 按设备时钟,它不在其时间窗口内
  • 其时间窗口超过设备可接受的长度
  • 它是为另一个安装实例签名的
  • 此应用不回应支持请求
  • 此构建的RUM限额不允许录制

在该报告到达之前,安装实例仍显示“Recording”。停止发送数据的设备在这里不会显示任何内容:没有报告,该安装实例的“Last seen”也不再更新。报告会在设备最后一次报告的2分钟后清除,重新启用或解除该安装实例的录制也会清除报告。由支持团队决定下一步,任何录制都不会自动解除。

谁可以录制,以及保留哪些内容

  • 谁:开始和解除录制需要Start support recordings权限。所有者、管理员、“Support”和RUM Initiator角色拥有此权限;管理员在Members中分配角色。所有能查看Observatory的人都能看到安装实例和“Support recording”,没有该权限的人会被告知需要什么权限。
  • 用户自己的开关:您的应用可以让用户录制自己的会话,例如提供一个“录制我的会话以供支持”开关(DOTel.startRumRecording)。当用户的设置开启时,它优先于支持录制:由设备决定。
  • 审计日志:每次“Record”和“Disarm”(包括尝试及其结果)都会连同操作者和时间记入您组织的审计日志。如果审计日志无法记录,则不会进行任何更改,对话框会说明这一点。
  • 拒绝:当“Record”或“Disarm”被拒绝时,对话框会说明原因,并附上可提供给支持团队的错误ID。

告警

“Alerts”首先显示正在触发的告警,然后是待定、正常和已静音的规则,以及最近24小时的变化。规则监视匹配的链路或日志,或某个指标的水平,并通过电子邮件、Slack、Webhook或PagerDuty发出通知。编写规则时,编辑器会用一句话复述规则,并显示它在过去12小时内会产生的结果。每条通知都会打开告警页面:确认告警、暂时静音、查看匹配内容,或询问Dartastic AI它为何触发。

告警邮件只会发送给可以查看Observatory的成员:所有者、管理员、Observatory Viewer和Observatory Editor。没有这些角色的成员不会收到告警邮件。角色在Control Room中设置。

Crashes和Issues

“Crashes”将应用未捕获的错误归组为问题,发生次数最多的在前;“Issues”包含所有异常。每个问题显示其类型和顶部帧(构建的符号已上传时会被符号化)、消息、发生次数、受影响的用户和会话、出现该问题的构建,以及其趋势,并附有用于打开最新一次发生的Open trace。从Dashboards下的Lists打开它们。每个列表都有自己的页面:Crashes列表和Issues列表。

从Observatory获取帮助

  • Contact support会在界面无法加载时出现。它会打开一个新的支持请求,并已填好失败的内容、其参考编号、页面、时间和您的组织。阅读后可随意修改,然后点击发送:在您点击之前不会发送任何内容。
  • 账号菜单是右上角您的姓名首字母:其中有您的姓名和邮箱、您正在查看的组织、指向Control Room的链接,以及Sign out。
“Contact support”的新工单,已填好,可直接发送
已打开的账号菜单:姓名、邮箱、组织、Control Room、Sign out