5.2. トレースとメトリクスを OpenTelemetry Collector に送信する

手順

1. OpenTelemetry Collector インスタンスのプロジェクトを作成します。

   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: observability

   Copy to Clipboard

2. サービスアカウントを作成します。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector-sidecar
     namespace: observability

   Copy to Clipboard

3. k8sattributes および resourcedetection プロセッサーの権限をサービスアカウントに付与します。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: otel-collector
   rules:
   - apiGroups: ["", "config.openshift.io"]
     resources: ["pods", "namespaces", "infrastructures", "infrastructures/status"]
     verbs: ["get", "watch", "list"]
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: otel-collector
   subjects:
   - kind: ServiceAccount
     name: otel-collector-sidecar
     namespace: observability
   roleRef:
     kind: ClusterRole
     name: otel-collector
     apiGroup: rbac.authorization.k8s.io

   Copy to Clipboard

4. OpenTelemetry Collector をサイドカーとしてデプロイします。

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: otel
     namespace: observability
   spec:
     serviceAccount: otel-collector-sidecar
     mode: sidecar
     config: |
       serviceAccount: otel-collector-sidecar
       receivers:
         otlp:
           protocols:
             grpc:
             http:
       processors:
         batch:
         memory_limiter:
           check_interval: 1s
           limit_percentage: 50
           spike_limit_percentage: 30
         resourcedetection:
           detectors: [openshift]
           timeout: 2s
       exporters:
         otlp:
           endpoint: "tempo-<example>-gateway:8090" 

   1

   
           tls:
             insecure: true
       service:
         pipelines:
           traces:
             receivers: [jaeger]
             processors: [memory_limiter, resourcedetection, batch]
             exporters: [otlp]

   Copy to Clipboard

   1

   これは、<example> Tempo Operator を使用してデプロイされた TempoStack インスタンスのゲートウェイを指します。

5. otel-collector-sidecar サービスアカウントを使用してデプロイメントを作成します。
6. sidecar.opentelemetry.io/inject: "true" アノテーションを Deployment オブジェクトに追加します。これにより、ワークロードから OpenTelemetry Collector インスタンスにデータを送信するために必要なすべての環境変数が注入されます。

手順

1. OpenTelemetry Collector インスタンスのプロジェクトを作成します。

   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: observability

   Copy to Clipboard

2. サービスアカウントを作成します。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: otel-collector-deployment
     namespace: observability

   Copy to Clipboard

3. k8sattributes および resourcedetection プロセッサーの権限をサービスアカウントに付与します。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: otel-collector
   rules:
   - apiGroups: ["", "config.openshift.io"]
     resources: ["pods", "namespaces", "infrastructures", "infrastructures/status"]
     verbs: ["get", "watch", "list"]
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: otel-collector
   subjects:
   - kind: ServiceAccount
     name: otel-collector
     namespace: observability
   roleRef:
     kind: ClusterRole
     name: otel-collector
     apiGroup: rbac.authorization.k8s.io

   Copy to Clipboard

4. OpenTelemetryCollector カスタムリソースを使用して OpenTelemetry Collector インスタンスをデプロイします。

   apiVersion: opentelemetry.io/v1alpha1
   kind: OpenTelemetryCollector
   metadata:
     name: otel
     namespace: observability
   spec:
     mode: deployment
     serviceAccount: otel-collector-deployment
     config: |
       receivers:
         jaeger:
           protocols:
             grpc:
             thrift_binary:
             thrift_compact:
             thrift_http:
         opencensus:
         otlp:
           protocols:
             grpc:
             http:
         zipkin:
       processors:
         batch:
         k8sattributes:
         memory_limiter:
           check_interval: 1s
           limit_percentage: 50
           spike_limit_percentage: 30
         resourcedetection:
           detectors: [openshift]
       exporters:
         otlp:
           endpoint: "tempo-<example>-distributor:4317" 

   1

   
           tls:
             insecure: true
       service:
         pipelines:
           traces:
             receivers: [jaeger, opencensus, otlp, zipkin]
             processors: [memory_limiter, k8sattributes, resourcedetection, batch]
             exporters: [otlp]

   Copy to Clipboard

   1

   これは、<example> Tempo Operator を使用してデプロイされた TempoStack インスタンスのゲートウェイを指します。

5. インストルメント化されたアプリケーションを使用してコンテナーに環境変数を設定します。

   名前	説明	デフォルト値
   OTEL_SERVICE_NAME Copy to Clipboard	service.name リソース属性の値を設定します。	""
   OTEL_EXPORTER_OTLP_ENDPOINT Copy to Clipboard	オプションで指定したポート番号を持つシグナル型のベースエンドポイント URL。	https://localhost:4317
   OTEL_EXPORTER_OTLP_CERTIFICATE Copy to Clipboard	gRPC クライアントの TLS 認証情報の証明書ファイルへのパス。	https://localhost:4317
   OTEL_TRACES_SAMPLER Copy to Clipboard	トレースに使用されるサンプラー。	parentbased_always_on
   OTEL_EXPORTER_OTLP_PROTOCOL Copy to Clipboard	OTLP エクスポーターのトランスポートプロトコル。	grpc
   OTEL_EXPORTER_OTLP_TIMEOUT Copy to Clipboard	OTLP エクスポーターが各バッチエクスポートを待機する最大時間間隔。	10s
   OTEL_EXPORTER_OTLP_INSECURE Copy to Clipboard	gRPC リクエストのクライアントトランスポートセキュリティーを無効にします。HTTPS スキーマはこれをオーバーライドします。	False