测试和调试

在这一页上


你在早期会问的最重要的问题之一是“我如何知道分部是否正常工作?”

有几种方法可以检查数据是否流动。一个是每个源代码中的调试器选项卡在网段的应用程序,你可以看到数据从一个来源进入网段。另一个是事件交付的工具显示哪些数据到达了特定的目的地。

出于监视目的,您还将在工作区卫生工具,如果您的源或目的地产生重复的错误。

源调试器

源调试器是一个实时工具,可帮助您确认从您的网站,移动应用程序或服务器进行的API调用到达段源,因此您可以对段设置更快地进行故障排除。使用调试器,您可以检查您以预期格式发送呼叫,而无需等待任何数据处理。

调试器与工作区的数据管道是分开的,并且不是发送到段工作区的所有事件的完整视图。调试器只显示源实时接收到的事件示例,最多为500个事件。调试器是测试实现的特定部分以验证事件是否被成功触发并到达源代码的好方法。

要查看您所有事件的更完整视图,我们建议您设置a仓库或者一个S3目的地

调试器显示到达源的实时采样事件流,但您也可以通过将“Live”切换为“暂停”来暂停流显示新事件。当您暂停流时,事件将继续到达您的来源。

您可以在调试器中搜索使用事件原始有效负载中可用的任何信息来查找特定有效负载。您还可以使用高级搜索选项将结果限制为特定事件。

当查看有效载荷时,有两个视图可用:

  • 漂亮的观点是对发送到Segment的API调用的重新创建。
  • 原始视图是从您发送的调用接收到的完整JSON对象段。这些调用包括正在跟踪的内容的所有细节:时间戳、属性、特征、id和上下文信息分段自动收集数据发送的那一刻。

事件交付

事件交付工具可以帮助您查看部门是否遇到了将数据从数据源交付到其连接的目的地的问题。

Segment每周向目的地发送数十亿的活动。如果我们的系统在提交您的数据时遇到错误,我们会在事件提交工具中报告它们。

下面是事件交付工具的一个示例:

事件交付在以下情况下最有用:

  • 当您的目的地似乎缺少数据时。例如,你将谷歌Analytics设置为目标,而你最近的数据看起来并不完整
  • 在第一次设定目的地时。例如,您正在将谷歌分析连接到您的节点源。一旦您输入了您的凭证并打开了目的地,您就可以使用这个特性来查看事件是否成功地以接近实时的方式进入GA。

您可以从目的地访问事件交付工具设置选项卡。

事件交付仅适用于云模式目的地,这些目的地通过段服务器接收数据。设备模式目的地通过段服务器之外的API端点接收数据,我们无法对其进行监视或报告。事件交付不能用于仓库或Amazon S3目的地

使用活动交付

UI显示了三个部分来报告Segment交付源数据的能力:关键指标、错误细节和交付趋势。

在您开始之前,从右边的下拉菜单中选择时间段。事件交付显示更新,以只显示有关所选时间段的信息。

关键指标

该面板显示目的地数据流的数量信息:

  • 交付:在选择的时间段内成功发送到目的地的消息段数。

  • 没有交付:无法传递的消息段数量。如果这个数字大于零,这些失败的原因将出现在下面的错误表中。

  • P95延迟:分段交付最慢5%的数据所花费的时间(称为P95延迟)。报告的延迟是端到端:从通过段API接收的事件到交付给合作伙伴API的事件。这有助于告诉您数据管道中是否存在延迟,以及延迟的严重程度。

错误的细节

错误详细信息表显示了给定时间段内错误的摘要,以及关于这些错误的最重要信息。您可以单击表中的任何一行展开它以显示更多信息。

Error Details视图为您提供尽可能多的信息,以帮助您解决问题。下面的示例显示了一个示例错误详细信息面板。

这一观点包括:

  • 描述事件交付UI根据我们从合作伙伴收到的有效负载提供对人类友好的错误摘要
  • 行动根据我们对这个问题的了解,我们认为你们可以采取这些行动来解决这个问题。
  • 更多信息链接到任何我们认为对你有帮助的文件
  • 样本的有效载荷为了帮助您调试,我们提供了数据在分段过程中每一步的有效载荷样本
    • 你送-你发送到Segment的API的数据

    • 要求的目的地-我们向合作伙伴API发出的请求。这个有效负载可能与您发送的不同,因为Segment将您的事件映射到合作伙伴的规范,以确保消息成功传递。

    • 响应目的地-我们从合作伙伴API收到的响应。这将产生raw partner错误。如果你需要与合作伙伴的成功团队一起解决问题,这通常是他们想看到的。

在调试时,查看问题何时开始、何时停止以及它们随时间的变化趋势会很有帮助。

事件传递视图显示具有以下信息的图形:

  • 交付:在您选择的时间段内成功交付的事件数量。

  • 没有交付:所选时间段内未成功下发的事件数。

“时延”视图显示您选择的时间段内的端到端P95时延。

最后更改:08 Dec 2020



从分段开始

细分是将网站和移动应用数据整合到300多个分析和增长工具的最简单方法。
创建免费帐户