К основному содержанию
скилл CX Codex

opentelemetry · julianobarbosa — скилл для Claude Code: что делает и как установить

Скилл по OpenTelemetry: помогает агенту настроить коллектор, развернуть его в Kubernetes и связать приёмники, процессоры и экспортёры в рабочие пайплайны.

MIT 135 установок ★ 17 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add julianobarbosa/claude-code-skills --skill opentelemetry -a claude-code
Открыть на GitHub

Что делает opentelemetry

Скилл ведёт агента по внедрению OpenTelemetry в Kubernetes: развернуть коллектор через Helm, описать приёмники, процессоры и экспортёры, собрать из них пайплайны для трейсов, метрик и логов. Внутри — рабочий YAML с otlp на портах 4317 и 4318, memory_limiter, batch, выгрузкой в Prometheus и Loki, плюс пример обогащения телеметрии атрибутами подов через k8sattributes.

Отдельный раздел разбирает три режима развёртывания — DaemonSet, Deployment и sidecar — и что выбирать под сбор на уровне ноды или централизованный шлюз. Для проверки есть команды kubectl и otelcol validate --config=config.yaml.

Среди подводных камней главный — порядок процессоров: memory_limiter должен идти до batch, иначе при нехватке памяти батчи пропадают без обратного давления. Ещё скилл предупреждает про двойной учёт трейсов, когда авто- и ручная инструментация работают вместе, и про то, что заголовки B3 сами не превращаются в W3C traceparent.

Какие задачи решает

  • собрать пайплайн трейсов, метрик и логов в одном конфиге коллектора
  • развернуть OTEL Collector в Kubernetes через Helm
  • обогатить телеметрию именами подов и неймспейсов
  • выбрать между DaemonSet, Deployment и sidecar
  • проверить конфиг коллектора до выкатки

Примеры запросов агенту

  • Разверни OTEL Collector в неймспейсе monitoring в режиме daemonset и включи сбор логов и метрик хоста.
  • Собери конфиг коллектора: otlp на 4317 и 4318, memory_limiter перед batch, метрики в Prometheus.
  • Почему рвутся трейсы между сервисами, если часть из них шлёт B3, а часть W3C traceparent?

Как установить opentelemetry

1Через Skills CLI (Vercel)

npx skills add julianobarbosa/claude-code-skills --skill opentelemetry -a claude-code

2Вручную: положить файлы

~/.claude/skills/opentelemetry/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/opentelemetry/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об opentelemetry

Как установить opentelemetry в Claude Code?

Выполните npx skills add julianobarbosa/claude-code-skills --skill opentelemetry -a claude-code. Файл скилла появится по пути ~/.claude/skills/opentelemetry/SKILL.md.

Что делает скилл opentelemetry?

Помогает агенту писать конфигурацию коллектора и разворачивать его в кластере: приёмники, процессоры, экспортёры, режимы DaemonSet, Deployment и sidecar, а также команды проверки.

Почему важен порядок memory_limiter и batch?

Если batch стоит раньше memory_limiter, при нехватке памяти батчи отбрасываются без обратного давления. Скилл требует ставить лимитер впереди.

Исходный текст

SKILL.md · MIT
---
name: opentelemetry
description: Implement OpenTelemetry (OTEL) observability - Collector configuration, Kubernetes deployment, traces/metrics/logs pipelines, instrumentation, and troubleshooting. Use when working with OTEL Collector, telemetry pipelines, observability infrastructure, or Kubernetes monitoring.
---

# OpenTelemetry Implementation Guide

## Overview

OpenTelemetry (OTel) is a vendor-neutral observability framework for instrumenting, generating, collecting, and exporting telemetry data (traces, metrics, logs). This skill provides guidance for implementing OTEL in Kubernetes environments.

## Quick Start

### Deploy OTEL Collector on Kubernetes

```bash
# Add Helm repo
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
helm repo update

# Install with basic config
helm install otel-collector open-telemetry/opentelemetry-collector \
  --namespace monitoring --create-namespace \
  --set mode=daemonset
```

### Send Test Data via OTLP

```bash
# gRPC endpoint: 4317, HTTP endpoint: 4318
curl -X POST http://otel-collector:4318/v1/traces \
  -H "Content-Type: application/json" \
  -d '{"resourceSpans":[]}'
```

## Core Concepts

**Signals**: Three types of telemetry data:

- **Traces**: Distributed request flows across services
- **Metrics**: Numerical measurements (counters, gauges, histograms)
- **Logs**: Event records with structured/unstructured data

**Collector Components**:

- **Receivers**: Accept data (OTLP, Prometheus, Jaeger, Zipkin)
- **Processors**: Transform data (batch, memory_limiter, k8sattributes)
- **Exporters**: Send data (prometheusremotewrite, loki, otlp)
- **Extensions**: Add capabilities (health_check, pprof, zpages)

## Collector Configuration

### Basic Pipeline Structure

```yaml
config:
  receivers:
    otlp:
      protocols:
        grpc:
          endpoint: ${env:MY_POD_IP}:4317
        http:
          endpoint: ${env:MY_POD_IP}:4318

  processors:
    batch:
      timeout: 10s
      send_batch_size: 1024
    memory_limiter:
      check_interval: 5s
      limit_percentage: 80
      spike_limit_percentage: 25

  exporters:
    prometheusremotewrite:
      endpoint: "http://prometheus:9090/api/v1/write"
    loki:
      endpoint: "http://loki:3100/loki/api/v1/push"

  service:
    pipelines:
      metrics:
        receivers: [otlp]
        processors: [memory_limiter, batch]
        exporters: [prometheusremotewrite]
      logs:
        receivers: [otlp]
        processors: [memory_limiter, batch]
        exporters: [loki]
      traces:
        receivers: [otlp]
        processors: [memory_limiter, batch]
        exporters: [otlp/tempo]
```

### Kubernetes Attributes Enrichment

```yaml
processors:
  k8sattributes:
    auth_type: "serviceAccount"
    passthrough: false
    filter:
      node_from_env_var: ${env:K8S_NODE_NAME}
    extract:
      metadata:
        - k8s.pod.name
        - k8s.namespace.name
        - k8s.deployment.name
        - k8s.node.name
```

## Deployment Modes

| Mode | Use Case | Pros | Cons |
|------|----------|------|------|
| DaemonSet | Node-level collection | Full coverage, host metrics | Higher resource usage |
| Deployment | Centralized gateway | Scalable, easier management | Single point of failure |
| Sidecar | Per-pod collection | Isolated, fine-grained | Resource overhead per pod |

## Common Patterns

### Development Environment

- Enable debug exporter for visibility
- Lower resource limits (250m CPU, 512Mi memory)
- Include spot instance tolerations for cost savings

### Production Environment

- Implement sampling (10-50% for traces)
- Higher batch sizes (2048-4096)
- Enable autoscaling and PodDisruptionBudget
- Use TLS for all endpoints

## Detailed References

For in-depth guidance, see:

- **Collector Configuration**: [COLLECTOR.md](references/COLLECTOR.md)
- **Kubernetes Deployment**: [KUBERNETES.md](references/KUBERNETES.md)
- **Troubleshooting**: [TROUBLESHOOTING.md](references/TROUBLESHOOTING.md)
- **Instrumentation**: [INSTRUMENTATION.md](references/INSTRUMENTATION.md)

## Validation Commands

```bash
# Check collector pods
kubectl get pods -n monitoring -l app.kubernetes.io/name=otel-collector

# View collector logs
kubectl logs -n monitoring -l app.kubernetes.io/name=otel-collector --tail=100

# Test OTLP endpoint
kubectl run test-otlp --image=curlimages/curl:latest --rm -it -- \
  curl -v http://otel-collector.monitoring:4318/v1/traces

# Validate config syntax
otelcol validate --config=config.yaml
```

## Key Helm Chart Values

```yaml
mode: "daemonset"  # or "deployment"
presets:
  logsCollection:
    enabled: true
  hostMetrics:
    enabled: true
  kubernetesAttributes:
    enabled: true
  kubeletMetrics:
    enabled: true
useGOMEMLIMIT: true
resources:
  limits:
    cpu: 500m
    memory: 1Gi
  requests:
    cpu: 100m
    memory: 256Mi
```

---

## Gotchas

- **Collector tail_sampling at end of pipeline doesn't release inflight buffer** — drop decisions made late still hold memory; OOM under load.
- **Auto-instrumentation + manual instrumentation can double-count traces** — pick one strategy per service or de-dupe explicitly via sampler.
- **Context propagation**: HTTP B3 vs W3C `traceparent` headers don't auto-convert; mixed environments silently break trace continuity.
- **OTel SDK vs Collector protocol versions**: minor version mismatches can drop attributes silently (especially semantic-convention attributes).
- **Resource detection** adds platform attributes (`cloud.account.id`, `host.id`) that bloat traces — disable when not used for routing.
- **Batch processor + memory limiter ordering**: limiter must precede batch in the pipeline or memory pressure causes batch drops without backpressure.

© julianobarbosa · MIT · julianobarbosa/claude-code-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — opentelemetry от других авторов.

opentelemetry codewithmukesh Скилл настраивает трассировку, метрики и логи OpenTelemetry в .NET 10 через единый вызов с OTLP-экспортом. CX Codex +1 4 000установок opentelemetry grafana Скилл opentelemetry для Claude Code настраивает сбор метрик, логов и трейсов в Grafana Cloud или локальные Mimir, Loki и Tempo. Подключается при настройке OTLP-экспорта и отладке пропадающих спанов. CX Codex +1 6 900установок opentelemetry devops-skills Скилл opentelemetry для Claude Code инструментирует приложения и инфраструктуру единой моделью наблюдаемости. Помогает отлаживать задержки между микросервисами и стандартизировать телеметрию. CX Codex +1 379установок opentelemetry Claude MPM Team Скилл opentelemetry для Claude Code описывает настройку трассировок, метрик и логов через OpenTelemetry. Он охватывает экспорт OTLP и работу с Collector. CX Codex +1 655установок opentelemetry-net-instrumentation Aaronontheweb Скилл opentelemetry-net-instrumentation для Claude Code расставляет трассировку, метрики и логи в .NET-коде по спецификации OpenTelemetry. Покрывает телеметрией библиотеку или приложение. CX Codex +1 442установок golang-observability-opentelemetry Claude MPM Team Скилл golang-observability-opentelemetry для Claude Code, Codex, Cursor и других платформ, который обучает агента инструментировать Go-сервисы через OpenTelemetry, Prometheus и slog. CX Codex +1 430установок 183-java-observability-tracing-opentelemetry Juan Antonio Breña Moral Скилл 183-java-observability-tracing-opentelemetry настраивает распределённую трассировку OpenTelemetry в Java-приложениях, контекст вызовов и экспорт через OTLP. CX Codex +1 253установок opentelemetry-expert 0xfurai Субагент opentelemetry-expert настраивает сбор трейсов, метрик и логов через OpenTelemetry, прокидывает контекст между сервисами и подбирает стратегии сэмплинга. CX Codex ★ 1 029звёзд репо groundcover-cli paymog Скилл groundcover-cli учит агента дёргать Go-утилиту groundcover: смотреть логи, трейсы, метрики и события k8s, а ещё управлять мониторами и silences. CX Codex +1 10 400установок observability-k8s-investigation elastic Скилл observability-k8s-investigation для Claude Code разбирает сбои Kubernetes по телеметрии OTel через EDOT. Включается при проблемах с подами, узлами и control plane. CX Codex +1 3 500установок

Из того же набора37

Весь набор →
1password Учит агента работать с 1Password: доставать секреты через op, подставлять их в окружение и отдавать в Kubernetes. CX Codex +1 172установок mkdocs Помогает создать и настроить сайт документации на MkDocs из Markdown-файлов. Помогает собрать, локально просматривать и публиковать сайт. CX Codex +1 157установок loki Скилл помогает настраивать Grafana Loki: выбирать режим развёртывания и хранилище, задавать параметры и писать запросы LogQL. Пригодится при внедрении Loki и разборе проблем. CX Codex +1 148установок consulting-design Скилл consulting-design подключает Gemini к обсуждению архитектуры, поиску компромиссов и генерации проектных альтернатив через MCP-инструменты. CX Codex +1 140установок writing-python Скилл writing-python держит агента в правилах Python 3.14+: сначала стандартная библиотека, аннотации типов у всех функций, uv и ruff вместо pip и black. CX Codex +1 134установок zabbix-api Скилл zabbix-api учит агента управлять Zabbix через API и библиотеку zabbix_utils: хосты, шаблоны, триггеры, история и отправка данных. CX Codex +1 132установок shellcheck Скилл shellcheck находит синтаксические ошибки, проблемы с кавычками и несовместимости с POSIX в bash- и sh-скриптах, а также генерирует готовые diff-исправления. CX Codex +1 129установок shell-prompt Скилл shell-prompt для Claude Code собирает конфиги zsh-промпта Powerlevel10k и vi-режима с формой курсора и индикаторами NORMAL/INSERT. CX Codex +1 125установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой