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

Aprende lo que rastrea el operador de Kubernetes

El seguimiento de la telemetría del operador de Kubernetes incluye, pero no se limita a, la siguiente información:

Aprende qué no rastrea Kubernetes operador

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:

• Recupera el UID del clúster de Kubernetes.

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

• Query el endpoint /version para detectar la versión del servidor de Kubernetes y garantizar la compatibilidad.

Desactivar estos roles de RBAC puede provocar un deterioro de la funcionalidad, problemas de compatibilidad y una reducción en la eficacia del soporte. Para mantener la funcionalidad completa y recibir la mejor experiencia de soporte, estos permisos deben permanecer habilitados.

Ver su telemetría

Para revisar la telemetría recolectada por tu Operador de Kubernetes antes de enviar tus datos a MongoDB para el análisis, sigue 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

Desactivar la telemetría para el Kubernetes Operator

El Operador de Kubernetes habilita la telemetría por defecto. Puedes deshabilitar la telemetría de Kubernetes operador de las siguientes maneras:

• Agregue la variable de entorno MDB_OPERATOR_TELEMETRY_ENABLED a la configuración de implementación de Kubernetes operador y establézcala en false.

  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 por defecto. Si la telemetría está actualmente desactivada, puedes activarla estableciendo las siguientes variables de entorno en true, o eliminando completamente los valores, lo que entonces dejará la configuración por defecto en true.

• Establece las variables de entorno MDB_OPERATOR_TELEMETRY_ENABLED y MDB_OPERATOR_TELEMETRY_SEND_ENABLED en la configuración de la implementación del Operador de Kubernetes en true o remueve completamente los valores, lo que luego asignará la configuración por defecto a true. Para obtener más información, consulta 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"

• Alternativamente, si utilizas Helm, configura los siguientes ajustes en true o remueve completamente los valores, lo que luego restablece los ajustes a true por defecto. Para obtener más información, consulta operador.telemetría..

  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