Configurar a telemetria do operador Kubernetes

Saiba o que o operador do Kubernetes rastreia

A telemetria do Operador Kubernetes rastreia Informações de Identificação Não Pessoal (PII), que incluem, mas não estão limitadas às seguintes informações:

Saiba o que o operador Kubernetes não monitora

A telemetria do operador Kubernetes não rastreia:

RBAC necessário para o MongoDB

O MongoDB requer permissões específicas de controle de acesso baseado em função (RBAC) para coletar telemetria. Não desative essas permissões. Essas permissões permitem que o MongoDB :

• Recupere o UID do cluster Kubernetes.

• Acesse informações de um único nó para determinar o provedor de nuvem, como EKS, GKE ou AKS.

• Consulte o endpoint /version para detectar a versão do servidor Kubernetes e garantir a compatibilidade.

A desabilitação dessas funções do RBAC pode levar a uma funcionalidade degradada, a problemas de compatibilidade e a uma redução da eficácia do suporte. Para manter a funcionalidade completa e receber a melhor experiência de suporte, essas permissões devem permanecer habilitadas.

Veja sua telemetria

Para revisar a telemetria coletada pelo seu Operador do Kubernetes antes de enviar seus dados para MongoDB para análise, siga estas etapas:

 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

Desativar telemetria para o operador Kubernetes

O Operador Kubernetes habilita a telemetria por padrão. Você pode desabilitar a telemetria do Kubernetes Operator das seguintes maneiras:

• Adicione a variável de ambiente MDB_OPERATOR_TELEMETRY_ENABLED à configuração de implantação do Kubernetes Operator e defina como false.

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

• Como alternativa, se você usar o Helm, defina operator.telemetry.enabled falsecomo.

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

Habilitar telemetria para o operador Kubernetes

O Operador Kubernetes habilita a telemetria por padrão. Se a telemetria estiver atualmente desativada, você poderá ativar a telemetria definindo as seguintes variáveis de ambiente como true ou removendo os valores completamente, o que então padroniza as configurações como true.

• Defina as variáveis de ambiente MDB_OPERATOR_TELEMETRY_ENABLED e MDB_OPERATOR_TELEMETRY_SEND_ENABLED na configuração de implantação do Kubernetes Operator como true ou remova os valores completamente, o que padronizará as configurações como true. Para saber mais, 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, se você usar Helm, defina as seguintes configurações como true ou remova os valores completamente, o que padronizará as configurações como true. Para saber mais, 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