製品ドキュメント

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

最終更新日: 28 年 2022 月 XNUMX 日

推奨事項： アプリケーションをインストルメント化する前に、OpenTelemetryCollectorをインストールしてください。 アプリケーションをインストルメント化するには、OpenTelemetryCollectorのエンドポイントが必要です。

LogicMonitorは、計測されたアプリケーションからLogicMonitorプラットフォームにトレースを転送するように事前構成されたOpenTelemetryのラップバージョンを提供します。 Linux、Docker、またはKubernetesにOpenTelemetryCollectorをインストールできます。

LogicMonitorのOpenTelemetryCollectorインストールウィザードを使用して、OpenTelemetryCollectorをインストールできます。 このウィザードは、インストールするプラットフォームの選択をガイドし、構成ファイルをカスタマイズできるようにします（たとえば、コレクターが要求を受信できるドメインを指定することで、クロスオリジンリソースシェアリング（CORS）ポリシーを構成できます）。コレクターをインストールするためのコマンドを提供します。 コンテナーにコレクターをインストールする場合は、このコマンドを編集して、コレクターのインストールをさらにカスタマイズできるオプションのパラメーターを含めることができます。

CORSの詳細については、Mozillaのを参照してください。 クロスオリジンリソース共有（CORS） のドキュメントで詳しく説明されています）。

注意： ご使用の環境では、OpenTelemetryCollectorを使用せずにトレースディレクトリをLogicMonitorに転送するシナリオがあります。 詳細については、を参照してください。 OpenTelemetryコレクターを使用しないトレースデータ転送.

\

OpenTelemetryコレクターをインストールするための一般的な要件と考慮事項

OpenTelemetry Collectorをインストールするには、次の管理権限を持つLogicMonitorでロールを作成する必要があります。

  • 設定：
    • データの取り込み>トレース
    • OpenTelemetryコレクター
      データソースは、OpenTelemetryCollectorによってPushMetricsAPIを使用して作成されます。
    • ロジックモジュール
  • リソース：リストされているすべてのリソース
    インストルメントされたアプリケーションを実行しているホストがまだ監視に存在しない場合、リソースが作成されます。

この役割は、OpenTelemetryCollectorをインストールするユーザーに関連付けられている必要があります。

推奨事項： OpenTelemetryCollectorをインストールするためのAPIのみのユーザーを作成します。

詳細については、を参照してください。 ユーザーと役割.

プラットフォームに関する考慮事項

LogicMonitorは現在、OpenTelemetryCollectorのインストールで次のプラットフォームをサポートしています。

  • Linux/AMD64アーキテクチャ
  • 次の検証済みコンテナプラットフォームでのAmazonElasticContainer Service（ECS）：
    • アマゾンファーゲート
    • Amazon Elastic Compute Cloud（EC2）
  • アマゾンウェブサービス（AWS）のElastic Kubernetes Service（EKS）
  • MicrosoftAzureのAzureKubernetesService（AKS）
  • GoogleCloudのGoogleKubernetesEngine（GKE）

注意： 現時点では、OpenTelemetry Collector を Windows にインストールすることはできません。

LinuxへのOpenTelemetryコレクターのインストール

LinuxにOpenTelemetryCollectorをrootまたは非rootユーザーとしてインストールできます。 ルートユーザーの場合、 lmotel サービスとして実行されます。 ルート以外のユーザーの場合、 lmotel プロセスとして実行されます。 

  1. 案内する 応募者と > OpenTelemetryコレクター、クリック 追加.
    または、に移動することもできます 形跡 > ご意見をお寄せください、および選択 OpenTelemetryCollectorをインストールします.
  2. コレクターの名前を入力し、 リナックス プラットフォーム用。
  3. インストールするコレクターのバージョンを選択します。
  4. で 構成の確認 ウィザードの手順で、必要に応じて構成ファイルを変更し、OpenTelemetryCollector設定でプロセッサーをカスタマイズします。 実行できる変更の詳細については、を参照してください。 OpenTelemetryコレクタープロセッサの構成.
    リクエストを許可するオリジンを指定することで、CORSを設定できます。 詳細については、を参照してください。 CORS（クロスオリジンリソースシェアリング） OpenTelemetryから。
  5. に コマンド ウィザードの手順に従って、必要に応じてcURLコマンドを変更し、コマンドをコピーします。

注意： コレクターバイナリをダウンロードするためのcURLコマンドは、使用可能になってからXNUMX時間のみ有効です。

インストーラーをダウンロードしたら、実行可能にする必要があります（chmod +x installer_file）次に実行可能ファイルを実行します（./installer_file).

さらに、root以外のユーザーのインストールパスは次のとおりです。

# installation_path=/home# status check:

$ ps -ef | grep lmotel

DockerへのOpenTelemetryコレクターのインストール

ウィザードは、LogicMonitorのOpenTelemetryCollectorDockerイメージを使用してコンテナーを実行するための事前構成されたDocker実行コマンドを提供します。

  1. 案内する 応募者と > OpenTelemetryコレクター、クリック 追加.
    または、に移動することもできます 形跡 > ご意見をお寄せください、および選択 OpenTelemetryCollectorをインストールします.
  2. OpenTelemetry Collectorの名前を入力し、[ デッカー プラットフォーム用。
  3. インストールするコレクターのバージョンを選択します。
  4. で 構成の確認 ウィザードの手順で、必要に応じて構成ファイルを変更し、OpenTelemetryCollector設定でプロセッサーをカスタマイズします。 実行できる変更の詳細については、を参照してください。 OpenTelemetryコレクタープロセッサの構成.
    リクエストを許可するオリジンを指定することで、CORSを設定できます。 詳細については、を参照してください。 CORS（クロスオリジンリソースシェアリング） OpenTelemetryから。
  5. に コマンド ウィザードの手順で、次の手順を実行します。
    1. 最小限の権限を持つユーザーのユーザー名を入力します。 これは、OpenTelemetryCollectorをインストールするために作成したAPIのみのユーザーです。
      このユーザーのアクセスIDとアクセスキーは自動的に作成されます。 これは、DockerコンテナにOpenTelemetryCollectorをインストールするときにDockerに対して認証するために必要です。
    2. コレクターのインストールに使用する実行コマンドをコピーします。
      コマンドにオプションのパラメータを入力することにより、必要に応じてこのコマンドを変更できます。 詳細については、を参照してください。 OpenTelemetryコレクターコンテナのインストールの構成.
  6. 【送信】ボタンをクリックします。販売者は原則としてXNUMX日以内に回答を返信します。XNUMX日を過ぎても回答がない場合は、Artisanaryまでお問い合わせください。 終了.

ウィザードのコマンドを使用して、DockerにOpenTelemetryCollectorをインストールします。

注意： Microsoft Azure App Serviceを使用している場合は、Dockerにインストールした後、OpenTelemetryCollectorをAzureコンテナーインスタンスにデプロイできます。 詳細については、を参照してください。 MicrosoftAzureコンテナーインスタンスでのOpenTelemetryCollectorデプロイメントの構成.

KubernetesへのOpenTelemetryコレクターのインストール

LogicMonitorは、KubernetesクラスターにOpenTelemetryCollectorをインストールするためのヘルムチャートを提供します。 これらのヘルムチャートは、OpenTelemetryコレクターをレプリカセットとして実行します。 ウィザードは、LogicMonitorチャートを追加し、OpenTelemetryCollectorをインストールするための事前構成されたHelmコマンドを提供します。

さらに、Ingressエンドポイントを指定することにより、OpenTelemetryCollectorで使用するIngressリソースを活用できます。 これにより、リソースまたはサービスの一部のみがKubernetesでホストされている場合、OpenTelemetry Collectorがハイブリッド環境で通信できるようになり、Kubernetesでホストされていないリソースと通信するにはこれらのリソースが必要になります。

  1. 案内する 応募者と > OpenTelemetryコレクター、クリック 追加.
    または、に移動することもできます 形跡 > ご意見をお寄せください、および選択 OpenTelemetryCollectorをインストールします.
  2. OpenTelemetry Collectorの名前を入力し、[ Kubernetes プラットフォーム用。
  3. インストールするコレクターのバージョンを選択します。
  4. に 構成の確認 ウィザードの手順で、必要に応じて構成ファイルを変更し、OpenTelemetryCollector設定でプロセッサーをカスタマイズします。 実行できる変更の詳細については、を参照してください。 OpenTelemetryコレクタープロセッサの構成.
    リクエストを許可するオリジンを指定することで、CORSを設定できます。 詳細については、を参照してください。 CORS（クロスオリジンリソースシェアリング） OpenTelemetryから。
  5. に コマンド ウィザードの手順で、次の手順を実行します。
    1. 最小限の権限を持つユーザーのユーザー名を入力します。 これは、OpenTelemetryCollectorをインストールするために作成したAPIのみのユーザーです。
      このユーザーのアクセスIDとアクセスキーは自動的に作成されます。 これは、OpenTelemetryCollectorをKubernetesコンテナにインストールするときにKubernetesに対して認証するために必要です。
    2. Ingressリソースを活用する場合は、IngressControllerが着信スパンをリッスンするIngressエンドポイントを入力します。
    3. コレクターのインストールに使用するHelmChartコマンドをコピーします。
      次のように入力して、必要に応じてこのコマンドを変更できます。
  6. 【送信】ボタンをクリックします。販売者は原則としてXNUMX日以内に回答を返信します。XNUMX日を過ぎても回答がない場合は、Artisanaryまでお問い合わせください。 終了.
記事上で