المهارات structured-logging
📊
structured-logging
آمن ⚙️
الأوامر الخارجية🌐
الوصول إلى الشبكة
使用廣事件實現結構化日誌
متاح أيضًا من: Doyajin174
傳統分散的日誌語句使除錯變得困難且缺乏上下文。本指南教您為每個請求發出一個包含所有除錯上下文的綜合事件。
يدعم: Claude Codex Code(CC)
1
تنزيل ZIP المهارة
2
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
3
فعّل وابدأ الاستخدام
اختبرها
استخدام "structured-logging". 為失敗的支付嘗試建立結構化日誌
النتيجة المتوقعة:
- 廣事件包含請求 ID、使用者詳情(ID、訂閱層級、生命週期價值)、購物車資訊(項目、總計、貨幣)、支付詳情(提供者、方法、嘗試次數、延遲)和錯誤上下文(類型、代碼、訊息、可重試標記)
- 所有欄位巢狀於適當的物件中以便於查詢
- 包含除錯所需一切資訊的單一日誌條目
استخدام "structured-logging". 我應該如何記錄資料庫查詢效能
النتيجة المتوقعة:
- 使用 timing.db_query_ms 欄位追蹤資料庫查詢時間
- 使用 timing.db_queries_count 計算查詢次數以偵測 N+1 問題
- 包含查詢持續時間、行數和逾時資訊
- 巢狀於 timing 物件中以實現清晰的組織和查詢
استخدام "structured-logging". 哪些欄位有助於在日誌中識別特定使用者
النتيجة المتوقعة:
- user.id - 已驗證使用者的唯一識別碼
- user.subscription - 用於按客戶類型篩選的層級
- user.lifetime_value_cents - 用於優先處理企業問題
- user.org_id - 用於 B2B 多租戶應用程式
التدقيق الأمني
آمنv5 • 1/16/2026
This skill contains pure documentation about structured logging best practices. No executable code, network calls, or file system operations exist. All 148 static findings are false positives caused by the analyzer misinterpreting markdown documentation examples as executable code patterns. The skill teaches logging patterns through documentation only.
3
الملفات التي تم فحصها
696
الأسطر التي تم تحليلها
2
النتائج
5
إجمالي عمليات التدقيق
عوامل الخطر
⚙️ الأوامر الخارجية (110)
references/wide-event-fields.md:23 references/wide-event-fields.md:24 references/wide-event-fields.md:25 references/wide-event-fields.md:26 references/wide-event-fields.md:27 references/wide-event-fields.md:28 references/wide-event-fields.md:29 references/wide-event-fields.md:30 references/wide-event-fields.md:31 references/wide-event-fields.md:32 references/wide-event-fields.md:33 references/wide-event-fields.md:34 references/wide-event-fields.md:35 references/wide-event-fields.md:36 references/wide-event-fields.md:37 references/wide-event-fields.md:47 references/wide-event-fields.md:48 references/wide-event-fields.md:49 references/wide-event-fields.md:50 references/wide-event-fields.md:51 references/wide-event-fields.md:52 references/wide-event-fields.md:53 references/wide-event-fields.md:54 references/wide-event-fields.md:55 references/wide-event-fields.md:56 references/wide-event-fields.md:57 references/wide-event-fields.md:58 references/wide-event-fields.md:70 references/wide-event-fields.md:71 references/wide-event-fields.md:72 references/wide-event-fields.md:73 references/wide-event-fields.md:74 references/wide-event-fields.md:75 references/wide-event-fields.md:76 references/wide-event-fields.md:77 references/wide-event-fields.md:78 references/wide-event-fields.md:79 references/wide-event-fields.md:80 references/wide-event-fields.md:81 references/wide-event-fields.md:87 references/wide-event-fields.md:88 references/wide-event-fields.md:89 references/wide-event-fields.md:90 references/wide-event-fields.md:91 references/wide-event-fields.md:92 references/wide-event-fields.md:93 references/wide-event-fields.md:99 references/wide-event-fields.md:100 references/wide-event-fields.md:101 references/wide-event-fields.md:102 references/wide-event-fields.md:103 references/wide-event-fields.md:104 references/wide-event-fields.md:105 references/wide-event-fields.md:115 references/wide-event-fields.md:116 references/wide-event-fields.md:117 references/wide-event-fields.md:118 references/wide-event-fields.md:119 references/wide-event-fields.md:120 references/wide-event-fields.md:121 references/wide-event-fields.md:122 references/wide-event-fields.md:123 references/wide-event-fields.md:133 references/wide-event-fields.md:134 references/wide-event-fields.md:135 references/wide-event-fields.md:136 references/wide-event-fields.md:137 references/wide-event-fields.md:138 references/wide-event-fields.md:139 references/wide-event-fields.md:140 references/wide-event-fields.md:141 references/wide-event-fields.md:142 references/wide-event-fields.md:152 references/wide-event-fields.md:153 references/wide-event-fields.md:154 references/wide-event-fields.md:155 references/wide-event-fields.md:156 references/wide-event-fields.md:157 references/wide-event-fields.md:158 references/wide-event-fields.md:159 references/wide-event-fields.md:160 references/wide-event-fields.md:161 references/wide-event-fields.md:162 references/wide-event-fields.md:172 references/wide-event-fields.md:173 references/wide-event-fields.md:174 references/wide-event-fields.md:175 references/wide-event-fields.md:176 references/wide-event-fields.md:180-193 SKILL.md:22-40 SKILL.md:40-46 SKILL.md:46-106 SKILL.md:106-121 SKILL.md:121-122 SKILL.md:122-123 SKILL.md:123-124 SKILL.md:124-130 SKILL.md:130-139 SKILL.md:139-143 SKILL.md:143-163 SKILL.md:163-167 SKILL.md:167-169 SKILL.md:169-173 SKILL.md:173-193 SKILL.md:193-199 SKILL.md:199-238 SKILL.md:238-242 SKILL.md:242-273 SKILL.md:273-279 SKILL.md:279-303
🌐 الوصول إلى الشبكة (1)
تم تدقيقه بواسطة: claude عرض سجل التدقيق →
درجة الجودة
41
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
21
المجتمع
100
الأمان
91
الامتثال للمواصفات
ماذا يمكنك بناءه
改善生產環境除錯
將分散的日誌語句替換為包含單一可搜尋記錄中所有請求資訊的上下文廣事件。
增強可觀察性管道
實現結構化日誌,在 Elasticsearch 或 Splunk 等日誌管理平台中啟用強大的查詢和分析功能。
標準化日誌實踐
在團隊中建立一致的日誌模式,使用高基數欄位實現有效的除錯和監控。
جرّب هذه الموجهات
基本實現
協助我為 Express API 實現廣事件日誌。展示如何建立一個在整個請求過程中建立上下文並在結束時發出一個綜合日誌事件的中介軟體。
錯誤上下文
我需要記錄包含完整上下文的支付失敗。展示如何結構化一個包含使用者資訊、購物車詳情、支付嘗試和錯誤代碼的單一事件錯誤日誌。
效能追蹤
協助我將效能指標新增到廣事件中。我想追蹤資料庫查詢、外部 API 呼叫和快取命中,並提供適當的時間分解。
查詢最佳化
展示分析結構化日誌的 SQL 查詢。我想找出企業客戶的慢速請求、支付失敗模式和功能開關對效能的影響。
أفضل الممارسات
- 在請求生命週期中建立上下文,在 finally 區塊中發出一次
- 包含高基數欄位如 user_id 和 request_id 以便除錯
- 使用一致的 snake_case 命名和適當的資料類型
تجنب
- 字串串接日誌會失去結構和可查詢性
- 分散的日誌語句分散在一個請求的多行中
- 僅包含低基數的日誌無法識別特定使用者或請求
الأسئلة المتكررة
哪些日誌函式庫支援廣事件?
任何結構化日誌函式庫都可以:Node.js 的 Winston、Pino、Bunyan;Go 的 Logrus、Zap;Java 的 SLF4J 搭配 JSON 佈局。此模式與語言無關。
廣事件應該包含多少個欄位?
包含 50 個或更多欄位以實現高維度。儲存成本低廉,除錯時間昂貴。包含所有可能有助於疑難排解的上下文。
我是否也應該在開發環境中記錄廣事件?
是的,在任何地方都使用相同的模式。在開發環境中,將日誌層級設定為 debug 以查看更多事件。在生產環境中,對 debug 進行取樣,但始終記錄 info 和 error。
我應該如何處理日誌中的敏感資料?
排除密碼、權杖和完整的 PII。對於必要的資料如電子郵件,考慮使用雜湊。在包含使用者資料之前,務必檢視您正在記錄的內容。
trace_id 和 request_id 之間有什麼區別?
Request_id 識別一個服務中的一個請求。Trace_id 跨越分散式系統中的多個服務。兩者都使用以關聯微服務之間的請求。
我該如何有效查詢廣事件?
使用結構化日誌平台如 Elasticsearch 或 Splunk。依特定欄位值查詢、依維度彙總,並依時間範圍篩選以進行強大的分析。