3.2. 使用 CLI 安装红帽构建的 OpenTelemetry

流程

1. 安装红帽构建的 OpenTelemetry Operator：

   1. 运行以下命令，为红帽构建的 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

   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

   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

   4. 运行以下命令检查 Operator 状态：

      $ oc get csv -n openshift-opentelemetry-operator

2. 为要在后续步骤中创建的 OpenTelemetry Collector 实例创建您选择的允许项目：

   • 要创建没有元数据的项目，请运行以下命令：

     $ oc new-project <permitted_project_of_opentelemetry_collector_instance> 

     1

     1

     不允许以 openshift- 前缀开头的项目名称。

   • 要创建带有元数据的项目，请运行以下命令：

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

     1

     
     EOF

     1

     不允许以 openshift- 前缀开头的项目名称。

3. 在为您创建的项目中创建一个 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]

      1

      为 OpenTelemetryCollector 部署选择的项目。不允许以 openshift- 前缀开头的项目名称。

      2

      带有以下支持值的部署模式：默认部署、daemonset、Statefulset 或 sidecar。详情请参阅部署模式 。

      3

      详情请查看 Receivers。

      4

      详情请查看 Processors。

      5

      详情请查看 Exporters。

   2. 运行以下命令来应用自定义 CR：

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

验证

1. 运行以下命令，验证 OpenTelemetry Collector pod 的 status.phase 是否为 Running，条件为 type: Ready ：

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

2. 运行以下命令来获取 OpenTelemetry Collector 服务：

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