# Kubernetes用のOpenTelemetryオペレーター

> OpenTelemetryの計装ライブラリを使用して、コレクターとワークロードの自動計装を管理するKubernetesオペレーターの実装。

---

LLMS index: [llms.txt](/llms.txt)

---

## はじめに {#introduction}

[OpenTelemetryオペレーター](https://github.com/open-telemetry/opentelemetry-operator)は、[Kubernetesオペレーター](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/)の実装のひとつです。

Operatorは以下を管理します。

- [OpenTelemetryコレクター](https://github.com/open-telemetry/opentelemetry-collector)
- [OpenTelemetryの計装ライブラリを使用したワークロードの自動計装](https://github.com/open-telemetry/opentelemetry-operator#opentelemetry-auto-instrumentation-injection)

## Getting started {#getting-started}

既存のクラスターにオペレーターをインストールするには、まず [`cert-manager`](https://cert-manager.io/docs/installation/) がインストールされていることを確認し、以下のコマンドを実行します。

```bash
kubectl apply -f https://github.com/open-telemetry/opentelemetry-operator/releases/latest/download/opentelemetry-operator.yaml
```

`opentelemetry-operator` のDeploymentが準備できたら、OpenTelemetryコレクター (otelcol) インスタンスを以下のように作成します。

```console
$ kubectl apply -f - <<EOF
apiVersion: opentelemetry.io/v1beta1
kind: OpenTelemetryCollector
metadata:
  name: simplest
spec:
  config:
    receivers:
      otlp:
        protocols:
          grpc:
            endpoint: 0.0.0.0:4317
          http:
            endpoint: 0.0.0.0:4318
    processors:
      memory_limiter:
        check_interval: 1s
        limit_percentage: 75
        spike_limit_percentage: 15
      batch:
        send_batch_size: 10000
        timeout: 10s

    exporters:
      # NOTE: v0.86.0より前では `debug` の代わりに `logging` を使用します。
      debug: {}

    service:
      pipelines:
        traces:
          receivers: [otlp]
          processors: [memory_limiter, batch]
          exporters: [debug]
EOF
```

<div class="alert alert-primary" role="alert"><div class="h4 alert-heading" role="heading">Note</div>



デフォルトでは、`opentelemetry-operator` は [`opentelemetry-collector` イメージ](https://github.com/open-telemetry/opentelemetry-collector-releases/pkgs/container/opentelemetry-collector-releases%2Fopentelemetry-collector)を使用します。
[Helmチャート](/docs/platforms/kubernetes/helm/)を使用してオペレーターをインストールした場合は、[`opentelemetry-collector-k8s` イメージ](https://github.com/open-telemetry/opentelemetry-collector-releases/pkgs/container/opentelemetry-collector-releases%2Fopentelemetry-collector-k8s)が使用されます。
これらのリリースにないコンポーネントが必要な場合は、[独自のコレクター](/docs/collector/extend/ocb/)を構築する必要があるかもしれません。

</div>


より詳細な設定オプションや、OpenTelemetryの計装ライブラリを使用したワークロードの自動計装を挿入する設定については、[Kubernetes用のOpenTelemetryオペレーター](https://github.com/open-telemetry/opentelemetry-operator/blob/main/README.md)を参照してください。

---

Section pages:

- [自動計装の注入](/ja/docs/platforms/kubernetes/operator/automatic/): OpenTelemetryオペレーターを使用した自動計装の実装。
- [ターゲットアロケーター](/ja/docs/platforms/kubernetes/operator/target-allocator/): デプロイされたすべてのコレクターインスタンスでPrometheusレシーバーのターゲットを分散するツール
- [Kubernetes用のOpenTelemetryオペレーターのトラブルシューティング](/ja/docs/platforms/kubernetes/operator/troubleshooting/): OpenTelemetry Kubernetesオペレーターのさまざまな側面に関するトラブルシューティングのヒント集が含まれています。 たとえば、ターゲットアロケーターがスクレイプ対象の検出に失敗している場合にどうするべきか、などです。
- [水平Pod自動スケーリング](/ja/docs/platforms/kubernetes/operator/horizontal-pod-autoscaling/): OpenTelemetryコレクターの水平Pod自動スケーリングを設定する