3.2. CLI を使用した Red Hat build of OpenTelemetry のインストール

手順

1. Red Hat build of OpenTelemetry Operator をインストールします。

   1. 次のコマンドを実行して、Red Hat build of OpenTelemetry Operator のプロジェクトを作成します。

      $ oc apply -f - << EOF
      apiVersion: project.openshift.io/v1
      kind: Project
      metadata:
        labels:
          kubernetes.io/metadata.name: openshift-opentelemetry-operator
          openshift.io/cluster-monitoring: "true"
        name: openshift-opentelemetry-operator
      EOF

      Copy to Clipboard Toggle word wrap

   2. 以下のコマンドを実行して、Operator グループを作成します。

      $ oc apply -f - << EOF
      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-opentelemetry-operator
        namespace: openshift-opentelemetry-operator
      spec:
        upgradeStrategy: Default
      EOF

      Copy to Clipboard Toggle word wrap

   3. 以下のコマンドを実行して、サブスクリプションを作成します。

      $ oc apply -f - << EOF
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: opentelemetry-product
        namespace: openshift-opentelemetry-operator
      spec:
        channel: stable
        installPlanApproval: Automatic
        name: opentelemetry-product
        source: redhat-operators
        sourceNamespace: openshift-marketplace
      EOF

      Copy to Clipboard Toggle word wrap

   4. 次のコマンドを実行して、Operator のステータスを確認します。

      $ oc get csv -n openshift-opentelemetry-operator

      Copy to Clipboard Toggle word wrap

2. 後続のステップで作成する OpenTelemetry Collector インスタンス用に、許可される任意のプロジェクトを作成します。

   • 許可されるプロジェクトをメタデータなしで作成するには、次のコマンドを実行します。

     $ oc new-project <permitted_project_of_opentelemetry_collector_instance> 

     1

     Copy to Clipboard Toggle word wrap

     1

     openshift- 接頭辞で始まるプロジェクト名は許可されません。

   • 許可されるプロジェクトをメタデータ付きで作成するには、次のコマンドを実行します。

     $ oc apply -f - << EOF
     apiVersion: project.openshift.io/v1
     kind: Project
     metadata:
       name: <permitted_project_of_opentelemetry_collector_instance> 

     1

     
     EOF

     Copy to Clipboard Toggle word wrap

     1

     openshift- 接頭辞で始まるプロジェクト名は許可されません。

3. OpenTelemetry Collector 用に作成したプロジェクトに OpenTelemetry Collector インスタンスを作成します。

   注記

   同じクラスター上の別々のプロジェクトに複数の OpenTelemetry Collector インスタンスを作成できます。

   1. OpenTelemetryCollector カスタムリソース (CR) をカスタマイズします。

      OpenTelemetryCollector CR の例

      apiVersion: opentelemetry.io/v1beta1
      kind: OpenTelemetryCollector
      metadata:
        name: otel
        namespace: <permitted_project_of_opentelemetry_collector_instance> 

      1

      
      spec:
        mode: <deployment_mode> 

      2

      
        config:
          receivers: 

      3

      
            otlp:
              protocols:
                grpc:
                http:
            jaeger:
              protocols:
                grpc: {}
                thrift_binary: {}
                thrift_compact: {}
                thrift_http: {}
            zipkin: {}
          processors: 

      4

      
            batch: {}
            memory_limiter:
              check_interval: 1s
              limit_percentage: 50
              spike_limit_percentage: 30
          exporters: 

      5

      
            debug: {}
          service:
            pipelines:
              traces:
                receivers: [otlp,jaeger,zipkin]
                processors: [memory_limiter,batch]
                exporters: [debug]

      Copy to Clipboard Toggle word wrap

      1

      OpenTelemetryCollector デプロイメント用に選択したプロジェクト。openshift- 接頭辞で始まるプロジェクト名は許可されません。

      2

      サポートされている次の値を持つデプロイメントモード: デフォルトの deployment、daemonset、statefulset、または sidecar。詳細は、デプロイメントモード を参照してください。

      3

      詳細は、レシーバー を参照してください。

      4

      詳細は、プロセッサー を参照してください。

      5

      詳細は、エクスポーター を参照してください。

   2. 次のコマンドを実行して、カスタマイズされた CR を適用します。

      $ oc apply -f - << EOF
      <OpenTelemetryCollector_custom_resource>
      EOF

      Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを実行して、OpenTelemetry Collector Pod の status.phase が Running で、conditions が type: Ready であることを確認します。

   $ oc get pod -l app.kubernetes.io/managed-by=opentelemetry-operator,app.kubernetes.io/instance=<namespace>.<instance_name> -o yaml

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、OpenTelemetry Collector サービスを取得します。

   $ oc get service -l app.kubernetes.io/managed-by=opentelemetry-operator,app.kubernetes.io/instance=<namespace>.<instance_name>

   Copy to Clipboard Toggle word wrap