Logfire MCP

🚀 Logfire MCP 服務器

Logfire MCP 服務器是一個模型上下文協議（MCP）服務器，它配備了實用工具，可讓您輕鬆訪問發送到 Logfire 的 OpenTelemetry 跟蹤和指標數據，為您的應用程序監控與分析提供有力支持。

🚀 快速開始

1. 獲取 Logfire 訪問令牌：
   • 訪問 Logfire 控制檯，創建並獲取訪問令牌。
2. 啟動 MCP 服務器：

   uvx logfire-mcp --read-token=YOUR_TOKEN
   

3. 配置客戶端：
   • 根據您使用的工具（如 Cursor、Claude Desktop 或 Cline），參考相應的配置示例進行設置。
4. 開始使用：
   • 使用 MCP 服務器提供的工具分析您的 OpenTelemetry 跟蹤和指標數據。

✨ 主要特性

• 分析跟蹤數據：幫助您識別和分類應用程序中的異常情況。
• 查詢指標：提供靈活的查詢功能，幫助您獲取所需的數據。
• 集成工具：支持與多種開發環境和框架集成。

📦 安裝指南

啟動 MCP 服務器的命令如下：

uvx logfire-mcp --read-token=YOUR_TOKEN

請將 YOUR_TOKEN 替換為您在 Logfire 控制檯獲取的訪問令牌。

💻 使用示例

基礎用法

以下是 MCP 服務器提供的主要工具及其使用說明：

find_exceptions

• 描述：查找指定時間段內的所有異常情況。
• 參數：
  • age (int): 時間範圍，單位為分鐘，默認值為 60。
• 返回結果：

[
  {
    "filepath": string,
    "count": int
  }
]

find_exceptions_in_file

• 描述：查找指定文件中的異常情況。
• 參數：
  • filepath (string): 文件路徑。
  • age (int): 時間範圍，單位為分鐘，默認值為 60。
• 返回結果：

[
  {
    "created_at": string,
    "message": string,
    "exception_type": string,
    "exception_message": string,
    "function_name": string,
    "line_number": string,
    "attributes": object,
    "trace_id": string
  }
]

arbitrary_query

• 描述：允許您自定義查詢。
• 參數：
  • query (string): SQL 查詢語句。
  • age (int): 時間範圍，單位為分鐘，默認值為 60。
• 返回結果：

[
  {
    "trace_id": string,
    "message": string,
    "created_at": string,
    "service_name": string
  }
]

示例問題

以下是一些使用 MCP 服務器工具可以解決的示例問題：

1. “過去一小時所有服務中發生了哪些異常？”
2. “請展示文件 'app/api.py' 中最近的錯誤及其上下文跟蹤信息。”
3. “昨天每分鐘發生了多少次錯誤？”
4. “按服務名稱分類，最常見的異常類型有哪些？”
5. “獲取 OpenTelemetry 跟蹤和指標的架構信息”
6. “查找昨天所有錯誤並展示其上下文跟蹤信息”

📚 詳細文檔

請參考 模型上下文協議服務器倉庫 獲取更多實現示例和開發模式。

📄 許可證

Logfire MCP 服務器採用 MIT 許可證。這意味著您可以在任何項目中自由使用、修改和分發該軟件，但需遵守 MIT 許可證的條款。

項目貢獻

我們歡迎社區貢獻，無論您是想添加新功能、修復問題還是改進文檔，我們都歡迎您參與。