Configuración de la telemetría del operador de Kubernetes

Descubra qué rastrea el operador de Kubernetes

El seguimiento de telemetría del operador de Kubernetes incluye, entre otros, la siguiente información:

Descubra lo que el operador de Kubernetes no rastrea

La telemetría del operador de Kubernetes no rastrea:

RBAC requerido para MongoDB

MongoDB requiere permisos específicos de control de acceso basado en roles (RBAC) para recopilar telemetría. No desactive estos permisos. Estos permisos permiten a MongoDB:

• Recupere el UID del clúster de Kubernetes.

• Acceda a la información de un solo nodo para determinar el proveedor de la nube, como EKS, GKE o AKS.

• Consulta el punto final /version para detectar la versión del servidor Kubernetes y garantizar la compatibilidad.

Deshabilitar estos roles RBAC podría provocar una funcionalidad reducida, problemas de compatibilidad y una menor eficacia del soporte. Para mantener la funcionalidad completa y obtener la mejor experiencia de soporte, estos permisos deben permanecer habilitados.

Ver su telemetría

Para revisar la telemetría recopilada por su operador de Kubernetes antes de que envíe sus datos a MongoDB para su análisis, siga estos pasos:

 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

Deshabilitar la telemetría para el operador de Kubernetes

El operador de Kubernetes habilita la telemetría de forma predeterminada. Puede deshabilitarla de las siguientes maneras:

• Agregue la variable de entorno MDB_OPERATOR_TELEMETRY_ENABLED a su configuración de implementación de Kubernetes Operator y configúrela false en.

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

• Como alternativa, si se utiliza Helm, se debe establecer operador.telemetry.enabled en false.

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

Habilitar telemetría para el operador de Kubernetes

El operador de Kubernetes habilita la telemetría de forma predeterminada. Si la telemetría está deshabilitada, puede habilitarla estableciendo las siguientes variables de entorno en true o eliminando los valores por completo, lo que resta a true.

• Establezca las variables de entorno MDB_OPERATOR_TELEMETRY_ENABLED y MDB_OPERATOR_TELEMETRY_SEND_ENABLED en la configuración de implementación de Kubernetes Operator en true o elimine los valores por completo, lo que establecerá la configuración predeterminada true en. Para obtener más información, consulte MDB_OPERATOR_TELEMETRY_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"

• Como alternativa, si usa Helm, configure los siguientes true valores en o elimínelos por completo; esto implica que los valores predeterminados true serán. Para obtener más información, consulte operator.telemetry.

  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