Splunk Python 2.0インストルメンテーションへの移行

Splunk OpenTelemetry Python 1.XインストルメンテーションからPython 2.0インストルメンテーションへの移行方法について学習します。

OpenTelemetry Python instrumentation 2.0は、OpenTelemetryのセマンティック規約の更新によって導入された一連の変更を含んでいます。

この移行ガイドでは、1.x バージョンの Splunk Distribution of OpenTelemetry Python を使用していることを前提としています。

前提条件

Splunk Distribution of OpenTelemetry Pythonバージョン 2.0に移行するには、以下が必要です：

  • Splunk Distribution of OpenTelemetry Collectorバージョン0.98以上がデプロイされています。

  • Splunk Observability Cloudの管理者権限。

  • pipバージョン3.0以上。

Splunk OTel Python 2.0への移行

Splunk OTel Python 2.0にアップグレードするには、Splunk Distribution of OpenTelemetry Collectorをアップグレードする必要があります。

Splunk OTel Python 2.0にアップグレードするには、以下の手順に従ってください：

  1. ターミナルを開きます。

  2. 以下のコマンドを入力します：

    pip install --upgrade splunk-opentelemetry

  3. 計測する予定の実行中のPythonアプリケーションをすべて再起動します。

Python 2.0用インストルメンテーションパラメータ

Splunk OpenTelemetry Pythonバージョン2.0では、ゼロコードインストルメンテーションのパラメータが変更されました。

変更点の一覧は以下の表を参照してください：

バージョン1.xの名前

バージョン2.0の名前

説明

splunk-py-trace、 splk-py-trace

opentelemetry-instrument

Splunk OpenTelemetry Pythonエージェントを起動し、トレースとメトリクスをSplunk Observability Cloudに送信します。

splunk-py-trace-bootstrap、 splk-py-trace-bootstrap

opentelemetry-bootstrap

Splunk OpenTelemetry Python 用のインストルメンテーションライブラリと依存関係を一覧表示します。ライブラリと依存関係をインストールするには、 opentelemetry-bootstrap -a install を使用します。

Python 2.0の関数名

関数は、Pythonアプリケーションコード内で特定のテレメトリデータ設定を設定します。

Python 2.0の新しい関数名については以下の表を参照してください：

バージョン1.xの名前

バージョン2.0の名前

説明

start_tracing()、 start_metrics()

init_splunk_otel()

Splunk OpenTelemetry Pythonのトレース、メトリクス、ログを設定します。

トラブルシューティング

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloud内のデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudのお客様がご利用いただけるサービスです。

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得ます。

  • Splunk の #observability ユーザーグループの Slack チャンネルに参加して世界中のお客様、パートナー、Splunk 社員とコミュニケーションを取ります。参加方法については、「Get Started with Splunk Community」マニュアルの「Chat groups Splunk」を参照してください。