Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第4章 OpenTelemetry インストルメンテーション注入の設定とデプロイ

重要

OpenTelemetry インストルメンテーション注入はテクノロジープレビューのみの機能です。テクノロジープレビュー機能は、Red Hat 製品サポートのサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではない場合があります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

Red Hat build of OpenTelemetry Operatorは、インストルメンテーションの設定を定義するカスタムリソース定義 (CRD) ファイルを使用します。

4.1. OpenTelemetry インストルメンテーション設定オプション
リンクのコピー

Red Hat build of OpenTelemetry では、OpenTelemetry 自動インストルメンテーションライブラリーをワークロードに注入して設定できます。現在、プロジェクトは、Go、Java、Node.js、Python、.NET、および Apache HTTP Server (httpd) からのインストルメンテーションライブラリーの注入をサポートしています。

OpenTelemetry の自動インストルメンテーションとは、コードを手動で変更することなく、フレームワークがアプリケーションを自動的にインストルメンテーションする機能を指します。これにより、開発者と管理者は、最小限の労力と既存のコードベースへの変更で、アプリケーションに可観測性を導入できるようになります。

重要

Red Hat build of OpenTelemetry Operatorは、インストルメンテーションライブラリーの注入メカニズムのみをサポートしますが、インストルメンテーションライブラリーやアップストリームイメージはサポートしません。お客様は独自のインストルメンテーションイメージをビルドすることも、コミュニティーイメージを使用することもできます。

4.1.1. インストルメンテーションオプション
リンクのコピー

インストルメンテーションオプションは、OpenTelemetryCollector カスタムリソースで指定されます。

OpenTelemetryCollector カスタムリソースファイルのサンプル

apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: java-instrumentation
spec:
  env:
    - name: OTEL_EXPORTER_OTLP_TIMEOUT
      value: "20"
  exporter:
    endpoint: http://production-collector.observability.svc.cluster.local:4317
  propagators:
    - w3c
  sampler:
    type: parentbased_traceidratio
    argument: "0.25"
  java:
    env:
    - name: OTEL_JAVAAGENT_DEBUG
      value: "true"
Copy to Clipboard Toggle word wrap

Expand
表4.1 Operator がインストルメンテーションを定義するために使用するパラメーター
パラメーター説明値
env
Copy to Clipboard Toggle word wrap

すべてのインストルメンテーションにわたって定義する共通の環境変数。

 
exporter
Copy to Clipboard Toggle word wrap

エクスポーターの設定。

 
propagators
Copy to Clipboard Toggle word wrap

プロパゲーターは、プロセス間のコンテキスト伝播設定を定義します。

tracecontext、baggage、b3、b3multi、jaeger、ottrace、none 

resource
Copy to Clipboard Toggle word wrap

リソース属性の設定。

 
sampler
Copy to Clipboard Toggle word wrap

サンプリング設定。

 
apacheHttpd
Copy to Clipboard Toggle word wrap

Apache HTTP Server インストルメンテーションの設定。

 
dotnet
Copy to Clipboard Toggle word wrap

.NET インストルメンテーションの設定。

 
go
Copy to Clipboard Toggle word wrap

Go インストルメンテーションの設定。

 
java
Copy to Clipboard Toggle word wrap

Java インストルメンテーションの設定。

 
nodejs
Copy to Clipboard Toggle word wrap

Node.js インストルメンテーションの設定。

 
python
Copy to Clipboard Toggle word wrap

Python インストルメンテーションの設定。

 

4.1.2. Service Mesh でのインストルメンテーション CR の使用
リンクのコピー

Red Hat OpenShift Service Mesh でインストルメンテーションカスタムリソース (CR) を使用する場合は、b3multi プロパゲーターを使用する必要があります。

4.1.2.1. Apache HTTP Server の自動インストルメンテーションの設定
リンクのコピー

Expand
表4.2 .spec.apacheHttpd フィールドのパラメーター
名前説明デフォルト
attrs
Copy to Clipboard Toggle word wrap

Apache HTTP Server に固有の属性。

 
configPath
Copy to Clipboard Toggle word wrap

Apache HTTP Server 設定の場所。

/usr/local/apache2/conf 

env
Copy to Clipboard Toggle word wrap

Apache HTTP Server に固有の環境変数。

 
image
Copy to Clipboard Toggle word wrap

Apache SDK と自動インストルメンテーションを備えたコンテナーイメージ。

 
resourceRequirements
Copy to Clipboard Toggle word wrap

コンピュートリソースの要件。

 
version
Copy to Clipboard Toggle word wrap

Apache HTTP Server のバージョン。

2.4

注入を有効化するための PodSpec アノテーション

instrumentation.opentelemetry.io/inject-apache-httpd: "true"
Copy to Clipboard Toggle word wrap

4.1.2.2. .NET 自動インストルメンテーションの設定
リンクのコピー

Expand
名前説明
env
Copy to Clipboard Toggle word wrap

.NET に固有の環境変数。 

image
Copy to Clipboard Toggle word wrap

.NET SDK と自動インストルメンテーションを備えたコンテナーイメージ。 

resourceRequirements
Copy to Clipboard Toggle word wrap

コンピュートリソースの要件。

.NET 自動インストルメンテーションの場合、エクスポータのエンドポイントが 4317 に設定されている場合は、必須の OTEL_EXPORTER_OTLP_ENDPOINT 環境変数を設定する必要があります。.NET 自動インストルメンテーションはデフォルトで http/proto を使用し、テレメトリーデータは 4318 ポートに設定する必要があります。

注入を有効化するための PodSpec アノテーション

instrumentation.opentelemetry.io/inject-dotnet: "true"
Copy to Clipboard Toggle word wrap

4.1.2.3. Go 自動インストルメンテーションの設定
リンクのコピー

Expand
名前説明
env
Copy to Clipboard Toggle word wrap

Go に固有の環境変数。 

image
Copy to Clipboard Toggle word wrap

Go SDK と自動インストルメンテーションを備えたコンテナーイメージ。 

resourceRequirements
Copy to Clipboard Toggle word wrap

コンピュートリソースの要件。

注入を有効化するための PodSpec アノテーション

instrumentation.opentelemetry.io/inject-go: "true"
Copy to Clipboard Toggle word wrap

OpenShift クラスターの Go 自動インストルメンテーションに必要な追加の権限

apiVersion: security.openshift.io/v1
kind: SecurityContextConstraints
metadata:
  name: otel-go-instrumentation-scc
allowHostDirVolumePlugin: true
allowPrivilegeEscalation: true
allowPrivilegedContainer: true
allowedCapabilities:
- "SYS_PTRACE"
fsGroup:
  type: RunAsAny
runAsUser:
  type: RunAsAny
seLinuxContext:
  type: RunAsAny
seccompProfiles:
- '*'
supplementalGroups:
  type: RunAsAny
Copy to Clipboard Toggle word wrap

ヒント

OpenShift クラスターで Go 自動インストルメンテーションの権限を適用するための CLI コマンドは次のとおりです。 

$ oc adm policy add-scc-to-user otel-go-instrumentation-scc -z <service_account>
Copy to Clipboard Toggle word wrap

4.1.2.4. Java 自動インストルメンテーションの設定
リンクのコピー

Expand
名前説明
env
Copy to Clipboard Toggle word wrap

Java に固有の環境変数。 

image
Copy to Clipboard Toggle word wrap

Java SDK と自動インストルメンテーションを備えたコンテナーイメージ。 

resourceRequirements
Copy to Clipboard Toggle word wrap

コンピュートリソースの要件。

注入を有効化するための PodSpec アノテーション

instrumentation.opentelemetry.io/inject-java: "true"
Copy to Clipboard Toggle word wrap

4.1.2.5. Node.js 自動インストルメンテーションの設定
リンクのコピー

Expand
名前説明
env
Copy to Clipboard Toggle word wrap

Node.js に固有の環境変数。 

image
Copy to Clipboard Toggle word wrap

Node.js SDK と自動インストルメンテーションを備えたコンテナーイメージ。 

resourceRequirements
Copy to Clipboard Toggle word wrap

コンピュートリソースの要件。

注入を有効化するための PodSpec アノテーション

instrumentation.opentelemetry.io/inject-nodejs: "true"
instrumentation.opentelemetry.io/otel-go-auto-target-exe: "/path/to/container/executable"
Copy to Clipboard Toggle word wrap

instrumentation.opentelemetry.io/otel-go-auto-target-exe アノテーションは、必要な OTEL_GO_AUTO_TARGET_EXE 環境変数の値を設定します。

4.1.2.6. Python 自動インストルメンテーションの設定
リンクのコピー

Expand
名前説明
env
Copy to Clipboard Toggle word wrap

Python に固有の環境変数。 

image
Copy to Clipboard Toggle word wrap

Python SDK と自動インストルメンテーションを備えたコンテナーイメージ。 

resourceRequirements
Copy to Clipboard Toggle word wrap

コンピュートリソースの要件。

Python 自動インストルメンテーションの場合、エクスポーターのエンドポイントが 4317 に設定されている場合は、OTEL_EXPORTER_OTLP_ENDPOINT 環境変数を設定する必要があります。Python 自動インストルメンテーションはデフォルトで http/proto を使用し、テレメトリーデータは 4318 ポートに設定する必要があります。

注入を有効化するための PodSpec アノテーション

instrumentation.opentelemetry.io/inject-python: "true"
Copy to Clipboard Toggle word wrap

4.1.2.7. OpenTelemetry SDK 変数の設定
リンクのコピー

Pod 内の OpenTelemetry SDK 変数は、次のアノテーションを使用して設定できます。 

instrumentation.opentelemetry.io/inject-sdk: "true"
Copy to Clipboard Toggle word wrap

すべてのアノテーションは、以下の値を受け入れることに注意してください。

true
namespace からインストル Instrumentation リソースを注入します。
false
インストルメンテーションはいっさい注入しません。
instrumentation-name
現在の namespace から注入するインストルメンテーションリソースの名前。
other-namespace/instrumentation-name
別の namespace から注入するインストルメンテーションリソースの名前。

4.1.2.8. マルチコンテナー Pod
リンクのコピー

インストルメンテーションは、Pod の仕様に従ってデフォルトで利用可能な最初のコンテナー上で実行されます。場合によっては、注入のターゲットコンテナーを指定することもできます。

Pod のアノテーション

instrumentation.opentelemetry.io/container-names: "<container_1>,<container_2>"
Copy to Clipboard Toggle word wrap

注記

Go 自動インストルメンテーションは、複数コンテナーの自動インストルメンテーション注入をサポートしていません。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat