Kubernetes Operator テレメトリの構成

Kubernetes Operator が追跡する内容を学ぶ

Kubernetes Operator テレメトリは、次の情報を含むがこれらに限定されない非個人を特定できる情報（PII）を追跡します。

Kubernetes Operator が追跡しない対象の詳細

Kubernetes Operator テレメトリは次の追跡はありません。

MongoDBに必要な RBAC

MongoDB、テレメトリを収集するには特定の ロールベース アクセス制御 （RBAC） 権限が必要です。これらの権限 を無効にしないでください。これらの権限により、 MongoDB次のことが可能になります。

• Kubernetesクラスター UID を取得します。

• EKS、GKE、AKS などのクラウドプロバイダーを決定するための単一ノードの情報にアクセスします。

• /version エンドポイントをクエリして、 Kubernetesサーバーのバージョンを検出し、互換性を確認します。

これらの RBAC ロールを無効にすると、機能の低下、互換性の問題、サポート有効性の低下につながる恐れがあります。完全な機能を維持し、最高のサポートエクスペリエンスを得るには、これらの権限を有効のままにする必要があります。

テレメトリを表示する

分析のためにデータをMongoDBに送信する前に、 Kubernetes Operator によって収集されたテレメトリを確認するには、次の手順に従います。

 kubectl get configmap mongodb-kubernetes-operator-telemetry -n <namespace> -o yaml

- apiVersion: v1
  data:
   lastSendPayloadClusters: '[{"timestamp":"2025-02-14T15:45:34.27814598Z","source":"Clusters","properties":              {"kubernetesAPIVersion":"v1.30.4","kubernetesClusterID":"80b25668-6732-4463-93fb-61ae0487c3e8",              "kubernetesFlavour":"Unknown"}},{"timestamp":"2025-02-14T15:45:34.278149016Z","source":"Clusters","properties":              {"kubernetesAPIVersion":"v1.30.4","kubernetesClusterID":"80b25668-6732-4463-93fb-61ae0487c3e8",              "kubernetesFlavour":"Unknown"}}]'
     lastSendPayloadDeployments: '[{"timestamp":"2025-02-14T15:45:34.280318302Z","source":"Deployments","properties":              {"architecture":"non-static","deploymentUID":"ff43ecfb-d244-4639-bca9-9cbbb9fbaa56","isMultiCluster":false,              "operatorID":"4ae3880d-4bc5-495c-b5ea-ff9c9fc0bb34","type":"ReplicaSet"}}]'
     lastSendPayloadOperators: '[{"timestamp":"2025-02-14T15:45:34.270025096Z","source":"Operators","properties":              {"kubernetesClusterID":"80b25668-6732-4463-93fb-61ae0487c3e8","kubernetesClusterIDs":              ["80b25668-6732-4463-93fb-61ae0487c3e8"],"operatorID":"4ae3880d-4bc5-495c-b5ea-ff9c9fc0bb34","operatorType":"MEKO",              "operatorVersion":"67af61832ac9680007bb966b"}}]'
     lastSendTimestampClusters: Initial-Value
     lastSendTimestampDeployments: "1739377730"
     lastSendTimestampOperators: "1739377728"
     Operator-UUID: 9cc0fb41-5142-419d-b440-baae616f66d4
   kind: ConfigMap
   metadata:
     name: mongodb-kubernetes-operator-telemetry

Kubernetes演算子のテレメトリの無効化

Kubernetes Operator はデフォルトで テレメトリを有効にします。Kubernetes Operator テレメトリは、次の方法で無効にできます。

• 環境KubernetesMDB_OPERTOR_テレメfalse

  spec:
    template:
      spec:
        serviceAccountName: mongodb-kubernetes-operator
        containers:
        - name: mongodb-kubernetes-operator
          env:
          - name: MDB_OPERATOR_TELEMETRY_ENABLED
            value: "false"

• あるいは、Helm を使用する場合は、Operator.elemetry.enabled を false に設定します。

  helm template operator helm_chart --set operator.telemetry.enabled=false

Kubernetes演算子のテレメトリの有効化

Kubernetes Operator はデフォルトで テレメトリを有効にします。テレメトリが現在無効になっている場合は、次の環境変数を true に設定するか、値を完全に削除することでテレメトリを有効にできます。これにより、設定がデフォルトで true になります。

• Kubernetes Operator 配置構成で環境変数 MDB_OPERATOR_TELEMETRY_ENABLED と MDB_OPERATOR_TELEMETRY_SEND_ENABLED を true に設定するか、値を完全に削除すると、設定はデフォルトで true になります。詳細については、「 MDB_OPERTOR_SELECTRY_enabled 」を参照してください。

  spec:
    template:
      spec:
        serviceAccountName: mongodb-kubernetes-operator
        containers:
        - name: mongodb-kubernetes-operator
          env:
          - name: MDB_OPERATOR_TELEMETRY_ENABLED
            value: "true"
          - name: MDB_OPERATOR_TELEMETRY_SEND_ENABLED
            value: "true"

• あるいは、Helm を使用する場合は、次の設定を true に設定するか、値を完全に削除してください。これにより、設定はデフォルトで true になります。詳しくは、 Operator.elemetry を参照してください。

  operator:
    telemetry:
      # Enables telemetry. Setting this to "false" will stop all telemetry.
      enabled: true
      # Adds RBAC clusterRole for kube-system UID detection for the Kubernetes cluster UID.
      # Adds RBAC clusterRole for RBAC for nodes. We are listing exactly one node to detect the cluster provider (for example, eks).
      # Adds RBAC clusterRole for /version query for detecting Kubernetes server version.
      installClusterRole: true
      collection:
        # Controls how often the Kubernetes Operator collects and saves the data to the telemetry ConfigMap. It doesn't control whether this data is sent to MongoDB for analysis.
        # Valid time units for frequency are "m", or "h". Anything less than one minute defaults to 1h.
        frequency: 1h
        # Enables the Kubernetes Operator to collect and send cluster-level telemetry.
        # Note: the cluster UUID is unique but random and MongoDB has no way to map this to a customer.
        clusters:
          enabled: true
        # Enables the Kubernetes Operator to collect and send deployment-level telemetry.
        deployments:
          enabled: true
        # Enables the Kubernetes Operator to collect and send Kubernetes Operator-level telemetry.
        operators:
          enabled: true
      # Enables sending the collected telemetry to MongoDB.
      send:
        enabled: true
        # Controls how often the Kubernetes Operator sends the collected the data to MongoDB for analysis.
        # Valid time units are "h". Anything less than one hour defaults to 168h, which is one week.
        frequency: 168h