コレクターのインストール

OpenTelemetryコレクターはさまざまなオペレーティングシステムやアーキテクチャにデプロイできます。以下の手順は、コレクターの最新の安定版をダウンロードしてインストールする方法を示しています。

OpenTelemetryコレクターに適用可能なデプロイメントモデル、コンポーネント、リポジトリについてよく知らない場合は、まずデータ収集とデプロイ方法のページを確認してください。

Docker

以下のコマンドはDockerイメージをプルし、コレクターをコンテナ内で実行します。 0.104.0 を実行したいコレクターのバージョンに置き換えてください。

docker pull otel/opentelemetry-collector-contrib:0.104.0
docker run otel/opentelemetry-collector-contrib:0.104.0

docker pull ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector-contrib:0.104.0
docker run ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector-contrib:0.104.0

作業ディレクトリからカスタム設定ファイルを読み込むには、そのファイルをボリュームとしてマウントします。

docker run -v $(pwd)/config.yaml:/etc/otelcol-contrib/config.yaml otel/opentelemetry-collector-contrib:0.104.0

docker run -v $(pwd)/config.yaml:/etc/otelcol-contrib/config.yaml ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector-contrib:0.104.0

Docker Compose

以下の例のように、既存の docker-compose.yaml ファイルにOpenTelemetryコレクターを追加できます。

otel-collector:
  image: otel/opentelemetry-collector-contrib
  volumes:
    - ./otel-collector-config.yaml:/etc/otelcol-contrib/config.yaml
  ports:
    - 1888:1888 # pprof extension
    - 8888:8888 # Prometheus metrics exposed by the Collector
    - 8889:8889 # Prometheus exporter metrics
    - 13133:13133 # health_check extension
    - 4317:4317 # OTLP gRPC receiver
    - 4318:4318 # OTLP http receiver
    - 55679:55679 # zpages extension

Kubernetes

次のコマンドは、エージェントをデーモンセットと単一のゲートウェイインスタンスとしてデプロイします。

kubectl apply -f https://raw.githubusercontent.com/open-telemetry/opentelemetry-collector/v0.104.0/examples/k8s/otel-config.yaml

先ほどの例は、本番環境で使う前に拡張したりカスタマイズしたりするための、出発点としてのものです。本番環境でのカスタマイズとインストールについては、OpenTelemetry Helm Charts を参照してください。

また、OpenTelemetry Operator を使って、OpenTelemetryコレクターインスタンスのプロビジョニングとメンテナンスを行えます。この機能には、自動アップグレード処理、OpenTelemetry コンフィギュレーションに基づいた Service コンフィギュレーション、デプロイメントへの自動サイドカーインジェクションなどがあります。

Kubernetesでコレクターを使用する方法については、Kubernetesで始めるを参照してください。

Nomad

HashiCorp NomadでOpenTelemetryを始めるに、エージェント、ゲートウェイとして、あるいは完全なデモの形でコレクターをデプロイするための参照ジョブファイルがあります。

Linux

すべてのコレクターのリリースには、Linux amd64/arm64/i386システム用のAPK、DEB、RPMパッケージが含まれています。インストール後のデフォルト設定は /etc/otelcol/config.yaml にあります。

Note: サービスの自動設定には systemd が必要です。

APKのインストール

Alpine系のシステムを使い始めるには、以下のコマンドを実行します。

apk update
apk add wget shadow
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_amd64.apk
apk add --allow-untrusted otelcol_0.104.0_linux_amd64.apk

apk update
apk add wget shadow
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_arm64.apk
apk add --allow-untrusted otelcol_0.104.0_linux_arm64.apk

apk update
apk add wget shadow
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_386.apk
apk add --allow-untrusted otelcol_0.104.0_linux_386.apk

DEBのインストール

Debian系のシステムで使い始めるには、以下のコマンドを実行します。

sudo apt-get update
sudo apt-get -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_amd64.deb
sudo dpkg -i otelcol_0.104.0_linux_amd64.deb

sudo apt-get update
sudo apt-get -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_arm64.deb
sudo dpkg -i otelcol_0.104.0_linux_arm64.deb

sudo apt-get update
sudo apt-get -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_386.deb
sudo dpkg -i otelcol_0.104.0_linux_386.deb

RPMのインストール

Red Hat系のシステムで使い始めるには、以下のコマンドを実行します。

sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_amd64.rpm
sudo rpm -ivh otelcol_0.104.0_linux_amd64.rpm

sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_arm64.rpm
sudo rpm -ivh otelcol_0.104.0_linux_arm64.rpm

sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_386.rpm
sudo rpm -ivh otelcol_0.104.0_linux_386.rpm

手動でのLinuxへのインストール

Linux向けのリリースは、さまざまなアーキテクチャに対応しています。バイナリを含むファイルをダウンロードし、あなたのマシンに手動でインストールしてください。

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_amd64.tar.gz
tar -xvf otelcol_0.104.0_linux_amd64.tar.gz

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_arm64.tar.gz
tar -xvf otelcol_0.104.0_linux_arm64.tar.gz

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_386.tar.gz
tar -xvf otelcol_0.104.0_linux_386.tar.gz

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_linux_ppc64le.tar.gz
tar -xvf otelcol_0.104.0_linux_ppc64le.tar.gz

自動サービスコンフィギュレーション

デフォルトでは、otelcol systemd サービスはインストール後に --config=/etc/otelcol/config.yaml オプションをつけて起動します。

別の設定を使うには、/etc/otelcol/otelcol.conf systemd 環境ファイルにある OTELCOL_OPTIONS 変数を適切なコマンドラインオプションに設定します。 /usr/bin/otelcol --help を実行すると、利用可能なすべてのオプションを確認できます。このファイルに追加の環境変数を追加して otelcol サービスに渡せます。

コレクターの設定ファイルまたは /etc/otelcol/otelcol.conf を変更した場合は、otelcol サービスを再起動して変更を適用します。

sudo systemctl restart otelcol

otelcol サービスからの出力をチェックするには、以下を実行します。

sudo journalctl -u otelcol

macOS

macOS向けのリリースは Intel および ARM システムで利用可能です。リリースはgzip圧縮されたtarball (.tar.gz) としてパッケージ化されています。解凍するには、以下のコマンドを実行してください。

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_darwin_amd64.tar.gz
tar -xvf otelcol_0.104.0_darwin_amd64.tar.gz

curl --proto '=https' --tlsv1.2 -fOL https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.104.0/otelcol_0.104.0_darwin_arm64.tar.gz
tar -xvf otelcol_0.104.0_darwin_arm64.tar.gz

すべてのコレクターのリリースには、解凍後に実行できる otelcol 実行ファイルが含まれています。

Windows

Windows向けのリリースは gzip された tarball (.tar.gz) としてパッケージ化されています。すべてのコレクターのリリースには、解凍後に実行できる otelcol.exe 実行ファイルが含まれています。

ソースからビルドする

以下のコマンドを使用して、ローカルのオペレーティングシステムに基づいてコレクターの最新バージョンをビルドできます。

git clone https://github.com/open-telemetry/opentelemetry-collector.git
cd opentelemetry-collector
make install-tools
make otelcorecol

フィードバック

このページは役に立ちましたか?

Thank you. Your feedback is appreciated!

Please let us know how we can improve this page. Your feedback is appreciated!

最終更新 January 7, 2025: [ja] add Japanese translation of "install the Collector" (#5864) (66dd3424)