opentelemetry-instrumentation-extension

Extend OpenTelemetry instrumentation when new functionality is added to the MCP Gateway. Use when (1) new operations/functions are added, (2) reviewing code for missing instrumentation, (3) user requests otel/telemetry additions, or (4) working with state-changing operations. Analyzes git diff, suggests instrumentation points following project standards in docs/telemetry/README.md, implements with approval, writes tests, updates documentation, and verifies with debug logging and docker logs.

1. Zainstaluj skill w swoim środowisku Claude/Codex, wskazując repozytorium docker/mcp-gateway. Skill będzie automatycznie aktywowany gdy wykryje nowe operacje zmieniające stan lub gdy użytkownik wspomni słowa kluczowe takie jak "otel", "telemetry", "instrumentation", "metrics" lub "tracing".

2. Gdy dodajesz nową funkcję lub operację (Create, Update, Delete, Push, Pull, Add, Remove), skill przeanalizuje plik docs/telemetry/README.md oraz pkg/telemetry/telemetry.go aby zrozumieć istniejące wzorce i metryki w projekcie.

3. Skill przeskanuje zmiany w kodzie (git diff) w katalogach pkg/ i cmd/docker-mcp/, zidentyfikuje nowe funkcje wykonujące operacje zmieniające stan i zaproponuje punkty instrumentacji. Dla każdej funkcji otrzymasz referencję pliku:linia oraz typ operacji.

4. Przejrzyj sugestie instrumentacji i zatwierdź je. Skill implementuje metryki i tracing zgodnie ze standardami projektu, dodaje testy dla nowych punktów instrumentacji oraz aktualizuje dokumentację telemetrii.

5. Zweryfikuj implementację używając debug logging i docker logs aby upewnić się, że instrumentacja działa poprawnie i zbiera dane telemetryczne z nowych funkcji.

6. Jeśli pracujesz z istniejącymi domenami (np. pkg/foo/), skill wykorzysta już zdefiniowane metryki. Dla nowych domen skill zaproponuje nowe metryki zgodnie z wytycznymi w docs/telemetry/README.md.