المهارات otel-expert
📦

otel-expert

آمن

取得 OpenTelemetry 實作指引

在 OpenTelemetry 語義慣例、收集器配置或檢測模式方面遇到困難?此技能從內建的 OTel 文件中提供即時解答,協助您實作適當的追蹤、跨度、指標和日誌,無需搜尋多份文件。

يدعم: Claude Codex Code(CC)
📊 70 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "otel-expert". What attributes should I use for HTTP server spans?

النتيجة المتوقعة:

For HTTP server spans, use these semantic convention attributes:

| Attribute | Type | Description |
|-----------|------|-------------|
| http.request.method | string | HTTP request method (GET, POST, etc) |
| url.path | string | URL path portion |
| http.response.status_code | int | HTTP status code |
| server.address | string | Server host name |
| server.port | int | Server port number |

Source: docs/semantic-conventions/http.md

استخدام "otel-expert". How do I create custom spans in .NET?

النتيجة المتوقعة:

Create an ActivitySource and use it to create spans:

var activitySource = new ActivitySource("MyApp.Service");

using var activity = activitySource.StartActivity("ProcessOrder");
activity?.SetTag("order.id", orderId);
activity?.SetTag("customer.id", customerId);

Source: docs/instrumentation/dotnet.md

التدقيق الأمني

آمن
v6 • 1/21/2026

This skill is a documentation helper that provides OpenTelemetry guidance from bundled docs. Static analysis flagged 17 patterns but all are false positives: hash fields in metadata, empty JSON arrays, and documentation examples with template variables. No actual security risks detected.

2
الملفات التي تم فحصها
307
الأسطر التي تم تحليلها
0
النتائج
6
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
30
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

後端開發人員新增分散式追蹤

一位 .NET 開發人員需要使用適當的跨度屬性和活動來源,按照 OpenTelemetry 語義慣例來檢測其微服務。

平台工程師配置 OTel 收集器

一位 DevOps 工程師需要在 OpenTelemetry 收集器中配置處理器和匯出器,以將遙測數據路由到其可觀測性平台。

SRE 實作可觀測性標準

一個 SRE 團隊正在為其組織建立遙測標準,需要快速參考指標、日誌和追蹤屬性慣例。

جرّب هذه الموجهات

尋找語義慣例屬性 
What semantic convention attributes should I use for HTTP server spans?
配置收集器元件 
How do I configure a batch processor in the OpenTelemetry collector?
產生 .NET 檢測程式碼 
Show me how to create custom spans with ActivitySource in .NET 10
了解 OTLP 協定細節 
What are the OTLP exporter configuration options and how do I set compression?

أفضل الممارسات

  • 始終先檢查 INDEX.md 以找到與您問題相關的文件檔案
  • 在引用文件之前,先查看 SYNC-REPORT.md 中有關內建文件的任何驗證警告
  • 使用最新穩定版本的語義慣例屬性,以避免已棄用的模式

تجنب

  • 不要假設供應商特定的匯出器配置適用於標準 OTLP
  • 不要在未檢查當前規範的情況下使用已棄用的語義慣例屬性
  • 在從可能過時的文件提供解答時,不要跳過檢查 SYNC-REPORT.md 警告

الأسئلة المتكررة

此技能內建了哪些文件?
此技能包含儲存在 docs 目錄中的 OpenTelemetry 語義慣例、收集器配置參考、.NET 檢測指南和 OTLP 協定規範。
這是否適用於 .NET 以外的程式語言?
雖然程式碼範例專注於 .NET 10 模式,但語義慣例和收集器配置適用於所有語言。您可以請求與語言無關的屬性和配置資訊。
內建文件的時效性如何?
文件僅包含最新穩定版語義慣例。請檢查 SYNC-REPORT.md 以了解有關內建文件的任何驗證警告。
此技能能否協助我配置供應商特定的匯出器?
此技能專注於標準 OTLP 匯出配置。對於供應商特定的匯出器(如 Jaeger 或 Prometheus),請查閱供應商文件。
此技能使用哪些工具?
此技能使用 Read、Grep 和 Glob 工具從內建的 OpenTelemetry 文件檔案中搜尋和擷取資訊。不會執行任何網路或外部命令。
如何找到特定的語義慣例屬性?
首先檢查 INDEX.md 以進行主題對應,然後使用 Grep 在 docs/semantic-conventions 目錄中搜尋特定屬性名稱。此技能將提供包含名稱、類型和描述的屬性表格。

تفاصيل المطور

المؤلف

ANcpLua

الترخيص

MIT

المستودع

https://github.com/ANcpLua/ancplua-claude-plugins/tree/main/plugins/otelwiki/skills/otel-expert

مرجع

main

بنية الملفات

📄 SKILL.md