Pydantic/Logfire实时监控视图使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00194/article/details/148602253

Pydantic/Logfire实时监控视图使用指南

logfire Uncomplicated Observability for Python and beyond! 🪵🔥 项目地址: https://gitcode.com/gh_mirrors/lo/logfire

实时监控视图概述

Logfire的实时监控视图(Live View)是该工具的核心功能模块，它允许开发人员实时观察应用程序的运行状态和日志数据流。这个功能对于调试和监控生产环境中的应用程序特别有价值，能够帮助开发者快速定位问题并理解系统行为。

主要功能区域解析

1. SQL搜索面板

搜索面板是实时视图中最强大的工具之一，它提供了多种查询方式：

原生SQL查询

支持标准SQL语法查询，自动补全和语法提示功能降低了编写查询的难度
查询实际上是在WHERE子句中执行，基础查询结构为：SELECT * FROM RECORDS WHERE [your conditions]
支持快捷键操作：Mac使用cmd+enter，Windows/Linux使用ctrl+enter执行查询

自然语言转SQL

内置AI辅助功能，可将自然语言描述转换为有效的SQL查询
提供两种模式："获取新SQL"完全重新生成查询，"修改现有SQL"在已有查询基础上调整
该功能基于PydanticAI实现，理解开发者意图并生成准确查询

参考查询模板

预置了大量常用查询模板，点击即可应用
多条件查询会自动用AND连接，开发者可手动修改为OR等逻辑运算符
是学习查询语法和快速构建复杂查询的理想起点

2. 数据表结构

Logfire的数据存储采用以下表结构，了解这些字段有助于构建精准查询：

CREATE TABLE records AS (
    start_timestamp timestamp with time zone,  -- 开始时间
    created_at timestamp with time zone,      -- 创建时间
    trace_id text,                            -- 追踪ID
    span_id text,                             -- 跨度ID
    parent_span_id text,                      -- 父跨度ID
    kind span_kind,                           -- 跨度类型
    end_timestamp timestamp with time zone,   -- 结束时间
    level smallint,                           -- 日志级别
    span_name text,                           -- 跨度名称
    message text,                             -- 消息内容
    attributes_json_schema text,              -- 属性JSON模式
    attributes jsonb,                         -- 属性数据
    tags text[],                              -- 标签数组
    otel_links jsonb,                         -- OpenTelemetry链接
    otel_events jsonb,                        -- OpenTelemetry事件
    is_exception boolean,                     -- 是否异常
    otel_status_code status_code,             -- 状态码
    otel_status_message text,                 -- 状态消息
    otel_scope_name text,                     -- 作用域名称
    otel_scope_version text,                  -- 作用域版本
    otel_scope_attributes jsonb,              -- 作用域属性
    service_namespace text,                   -- 服务命名空间
    service_name text,                        -- 服务名称
    service_version text,                     -- 服务版本
    service_instance_id text,                 -- 服务实例ID
    process_pid integer                       -- 进程ID
)