SuperAPI AI 工具集

logfire

编程与开发

查看项目

更新于 10-15 23:32

技能介绍

用途:为 Python 应用提供结构化可观测性,基于 Pydantic Logfire,兼容 OpenTelemetry。适用于为 Python API 添加追踪与日志、对 FastAPI、HTTPX 等框架进行埋点,以及 LLM 交互观测。

主要能力:支持服务配置(service_name、service_version、environment、console、send_to_logfire);多级别结构化日志(trace 到 fatal),Python 3.11+ 支持 f-string 自动提取变量;手动 span 与动态属性;自定义指标(counter、gauge、histogram);LLM 观测(如 instrument_pydantic_ai);抑制噪声埋点(suppress_scopes、suppress_instrumentation);敏感数据脱敏(ScrubbingOptions,含 extra_patterns 与 callback);采样(SamplingOptions head)与关闭指标;测试支持(CaptureLogfire)。

使用方式:安装命令为 uv pip install logfire。先 logfire.configure(...) 配置,再调用对应 instrument_* 方法埋点,最后创建应用或客户端。集成覆盖 Web(FastAPI、Starlette、Django、Flask、AIOHTTP、ASGI、WSGI)、HTTP(HTTPX、Requests、AIOHTTP Client)、数据库(SQLAlchemy、Asyncpg、Psycopg、Redis、PyMongo)、LLM(Pydantic AI、OpenAI、Anthropic、MCP)、任务(Celery、AWS Lambda)、日志(标准 logging、Structlog、Loguru、Print)及其他(Pydantic、系统指标)。

限制与注意:需在创建客户端前完成配置与埋点,否则可能无 span;应设置 service_name;避免高基数属性;生产环境建议 console=False;具体收费、价格与平台细节暂未提供。