Docs » Splunk Observability Cloud でサポートされているインテグレーション » バックエンドアプリケーションをインストルメンテーションして、スパンを Splunk APM に送信する » Splunk Observability Cloud 用 Python アプリケーションのインストルメンテーション » Migrate to the Splunk Python 2.0 instrumentation

Migrate to the Splunk Python 2.0 instrumentation 🔗

OpenTelemetry Python instrumentation 2.0 contains a set of breaking changes introduced with the OpenTelemetry semantic conventions updates.

This migration guide assumes that you’re using a 1.x version of the Splunk Distribution of OpenTelemetry Python.

前提条件 🔗

To migrate to the Splunk Distribution of OpenTelemetry Python version 2.0, you need the following:

  • Splunk Distribution of OpenTelemetry Collector version 0.98 or higher deployed.

  • Administrator permissions for Splunk Observability Cloud.

  • pip version 3.0 or higher.

Migrate to Splunk OTel Python 2.0 🔗

Upgrading to Splunk OTel Python 2.0 requires upgrading the Splunk Distribution of OpenTelemetry Collector.

To upgrade to Splunk OTel Python 2.0, follow these steps:

  1. Open a terminal.

  2. Enter the following command:

    pip install --upgrade splunk-opentelemetry

  3. Restart any running Python applications that you plan to instrument.

Instrumentation parameters for Python 2.0 🔗

Splunk OpenTelemetry Python version 2.0 changes the parameters for zero-code instrumentation.

See the following table for a list of changes:

Version 1.x name

Version 2.0 name

説明

splunk-py-trace, splk-py-trace

opentelemetry-instrument

Activates the Splunk OpenTelemetry Python agent and sends traces and metrics to Splunk Observability Cloud.

splunk-py-trace-bootstrap, splk-py-trace-bootstrap

opentelemetry-bootstrap

Lists instrumentation libraries and dependencies for Splunk OpenTelemetry Python. To install the libraries and dependencies, use opentelemetry-bootstrap -a install.

Function names for Python 2.0 🔗

Functions configure certain telemetry data settings in your Python application code.

See the following table for new function names in Python 2.0:

Version 1.x name

Version 2.0 name

説明

start_tracing(), start_metrics()

init_splunk_otel()

Configures tracing, metrics, and logs for Splunk OpenTelemetry Python.

トラブルシューティング 🔗

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

Splunk Observability Cloudをご利用のお客様

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

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

  • Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月27日 に最終更新されました。