跳转至

实时取景

实时视图是Logfire的主视图，您可以在其中实时查看跟踪。

实时视图(顾名思义)对于实时观察应用程序中发生的情况非常有用，但它也可用于浏览历史数据。

详细信息面板已关闭

Logfire OpenAI Image Generation

这是当您来到包含一些数据的项目的实时视图时所看到的。

  1. 组织和项目标签：在此示例中，组织是 samuelcolvin，项目是 logfire-demo-spider。您可以点击组织名称，进入组织概览页面;项目名称是指向此页面的链接。

  2. 项目页面：这些是指向各种项目特定页面的链接，包括“实时”、“仪表板”、“警报”、“浏览”和“设置”页面。

  3. “反馈”和“测试版”按钮：单击“反馈”按钮以向我们提供反馈。beta 按钮包含有关 Logfire beta 状态的更多信息。

  4. 浅色/深色模式切换：在光明、黑暗和系统之间循环——因为每个人似乎对此都有自己的看法：smile：

  5. 链接到当前视图：单击此按钮会复制一个链接到您所在的页面，其中包含相同的查询等。

  6. 组织遴选小组：打开一个抽屉，其中包含指向您所属的不同组织的链接，以及指向“条款和条件”、“支持”、“文档”和“注销”按钮的链接。

  7. 查询文本输入：在此处输入 SQL 查询以查找与查询匹配的跨度。查询应在记录表上采用与 Postgres 兼容的 WHERE 子句的形式(例如，要查找警告，请输入级别 >= level_num('error'))。有关架构的更多详细信息，请参阅此处的浏览文档。

  8. 搜索按钮：输入查询后，您可以单击此处运行查询，或者直接按 cmd+enter(在 Windows/Linux 上为 ctrl+enter)。

  9. 额外查询菜单：在这里，您可以找到用于在查询的各种字段上添加过滤器的快速选择。此外，还有一个指向自然语言查询入口选项的链接，该选项使用 an LLM 根据您正在查找的内容的自然语言描述生成查询。

  10. 切换时间线位置按钮：单击此处在垂直和水平方向之间切换时间线(有关详细信息，请参阅下一项)。

  11. 时间线：这显示了一段时间内与查询匹配的跨度计数的直方图。蓝色突出显示的部分对应于下面可滚动的跟踪列表中当前可见的时间范围。您可以单击此行上的点以从该时间点开始查看日志。

  12. 跟踪滚动设置：此菜单包含一些与跟踪滚动视图中显示的内容相关的设置。

  13. 状态标签：如果您的查询成功并且您正在接收实时数据，则这应显示“已连接”。如果查询中有语法错误或遇到其他问题，则应在此处查看有关问题的详细信息。

  14. 服务、范围和标记可见性筛选器：在这里，您可以控制是否根据其服务、范围或标记显示某些跨度。

  15. 级别可见性过滤器：在这里，您可以控制显示哪些日志级别。默认情况下，“debug”和“trace”级别跨度在视图中是隐藏的，但您可以在此处更改值以显示它们，或者您也可以切换其他级别的跨度的可见性。

  16. 时间窗口选择：在这里，您可以在“实时尾部”(显示收到的实时日志)和不同大小的历史时间范围之间切换。选择特定时间范围时，第 11 项的时间线将与该范围匹配。

在第 16 项下方，我们有“跟踪滚动视图”，它显示与当前查询和可见性过滤器匹配的跟踪。

  1. 开始时间戳标签：此时间戳是跨度的start_timestamp。将鼠标悬停在此位置上，以人类可读的格式查看其年龄。

  2. 服务标签：这种药丸含有跨度的service_name。这是生成跨度的服务的名称。您可以将鼠标悬停在上方以查看版本信息。

  3. 消息：在这里，您可以看到此跨度的消息(实际上是其跟踪的根跨度)。您也可以点击此处查看更多详情。请注意，较小的菱形表示此跨度没有子项

  4. 折叠的跟踪：跨度消息左侧的较大菱形(其中带有 +)表示此跨度具有子跨度，可以通过单击 + 菱形来展开以查看它们。

  5. 范围标签：这种药丸含有跨度的otel_scope_name。这是生成跨度的 OpenTelemetry 范围的名称。通常，OpenTelemetry 范围对应于检测，因此这通常可以让您了解哪个库的检测产生了跨度。使用 logfire API 生成跨度时，这将是 logfire，但如果跨度是由另一个检测生成的，则这将是 OpenTelemetry 检测包的名称。您可以将鼠标悬停在上方以查看版本信息。

  6. 跟踪持续时间行：当迹线的根跨度折叠时，右侧的线将更粗且更圆，并从最左侧开始。在这种情况下，行的长度表示跟踪的对数刻度持续时间。对比见第 25 项。

  7. 跟踪持续时间标签：显示跟踪的持续时间。

  8. 扩展的跟踪：在这里，我们可以看到如果将跟踪向下扩展几个级别，它会是什么样子。您可以单击跟踪中的任何行以查看有关跨度的更多详细信息。

  9. 跨度持续时间线：当跟踪展开时，线条的形状会发生变化，表示向线性刻度的过渡，您可以在其中看到整个跟踪中每个跨度的开始和结束时间戳。

“详细信息”面板打开

Logfire OpenAI Image Generation

当您在 Traces Scroll 中单击一个跨度时，它将打开详细信息面板，您可以在此处看到该面板。

  1. 时间线工具提示：在这里，您可以看到将鼠标悬停在时间线上时显示的工具提示。它显示悬停的直方图条中的记录计数、条的持续时间、条形图所代表的时间范围以及您悬停的确切时间戳(以及当您单击时间线时将检索记录的时间戳)

  2. 级别图标：此图标表示此跨度的最高级别及其任何后代。

  3. 跨度消息：在这里，您可以查看项目是 Span 还是 Log，以及它的消息。

  4. 详细信息面板方向切换和其他按钮：第二个按钮复制一个链接以查看此特定范围。X 将关闭此范围的详细信息面板。

  5. 异常警告：之所以存在此异常指示器，是因为在此跨度中出现了异常。您可以在“异常回溯详细信息”选项卡中查看更多详细信息。

  6. 固定跨度属性：本部分包含有关跨度的一些详细信息。可以单击“Trace ID”和“Span ID”药丸上的链接图标，分别带您进入跟踪或跨度的视图。

  7. 详细信息选项卡：这些选项卡包含有关跨度的更多详细信息。某些选项卡(例如“异常详细信息”选项卡)仅对包含与该选项卡相关的数据的跨度显示。

  8. “参数”面板：如果 span 是使用 logfire span/logging API 之一创建的，并且存在一些参数，则这些参数将在此处显示，并显示为 Python 字典。

  9. “代码详细信息”面板：当跨度上存在有关源行的属性时，将出现此面板，并在此处显示该信息。

  10. 全跨度属性面板：当存在任何属性时，此面板将显示跨度上 OpenTelemetry 属性的完整列表。默认情况下，此面板处于折叠状态，但您可以单击其名称以显示它。

实时取景变体

Logfire OpenAI Image Generation

  1. 这是时间线在垂直方向上的样子。您可以随时切换此方向。
  2. 这是详细信息面板在水平方向上的外观。只要详细信息面板打开，您就可以切换此方向。
本文总阅读量次