C++ 用 Splunk インストルメンテーションから C++ 用 OpenTelemetry インストルメンテーションへの移行

非推奨の Splunk C++ エージェントからアップストリームの OpenTelemetry Collector へ移行する方法をご紹介します。

アップストリームの C++ 用 OpenTelemetry インストルメンテーションは、C++ 用 Splunk インストルメンテーションを置き換えるものです。C++ 用 Splunk インストルメンテーションは、2024 年 3 月 15 日の時点で廃止されており、2025 年 9 月 15 日にサポートが終了します。

以下の手順に従って、Splunk インストルメンテーションから OpenTelemetry インストルメンテーションに移行してください。

互換性と要件

OpenTelemetry C++ インストルメンテーションの要件を満たしていることを確認してください。「前提条件」を参照してください。

C++ 用 OpenTelemetry インストルメンテーションへの移行

C++ 用 Splunk インストルメンテーションから C++ 用 OpenTelemetry インストルメンテーションに移行するには、以下の手順に従ってください：

  1. C++ 用 Splunk インストルメンテーションを非アクティブにします。

  2. C++ 用 OpenTelemetry インストルメンテーションをインストールし、アクティベートします。「Splunk Observability Cloud に C++ アプリケーションをインストルメンテーションする」を参照してください。

  3. コンフィギュレーション設定を更新します。

  4. サーバーとアプリケーションを再起動します。

C++ 用 Splunk インストルメンテーションを非アクティブにする

C++ 用 Splunkインストルメンテーションは OpenTelemetry インストルメンテーションのラッパーであるため、アンインストールの公式なプロセスはありません。

代わりに、Splunk Distribution of OpenTelemetry C++ リポジトリとそのサブモジュールを削除します。OpenTelemetry C++ 用のアプリケーションをインストールして設定する際には、Splunk ディストリビューションを使用しているコードをすべて削除し、OpenTelemetry C++ インストルメンテーション用の新しいコードに置き換えてください。

コンフィギュレーション設定を変更する

splunk::OpenTelemetryOptions から渡されるオプションはサポートされなくなりました。

splunk::OpenTelemetryOptions を通してオプションを渡した場合は、これらのオプションを環境変数に変更します。

たとえば、C++ コードに次のオプションがあるとします。

splunk::OpenTelemetryOptions options = splunk::OpenTelemetryOptions().WithServiceName("my-service")

オプションを環境変数に変更するには、このコードを削除して、以下のコマンドを実行します。

export OTEL_SERVICE_NAME="my-service"