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

Descubra qué 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:

• Recupere 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.

• Consulta el punto final /version para detectar la versión del servidor 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

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 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.

• 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