Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

SUSE Rancher Prime Integración con servicios de registro

El Operador de registro ahora potencia la solución de registro de Rancher en lugar de la anterior solución interna.

Habilitando registro

Puedes habilitar el registro para un clúster downstream de Rancher yendo a la página de Apps e instalando la aplicación de registro.

  1. Ve al clúster donde deseas instalar el registro y haz clic en Apps.

  2. Haz clic en la aplicación Registro.

  3. Desplázate hasta la parte inferior del README del gráfico de Helm y haz clic en Instalar.

Resultado: La aplicación de registro se despliega en el espacio de nombres cattle-logging-system.

Desinstalar Registro

  1. Ve al clúster donde deseas instalar el registro y haz clic en Apps.

  2. Haz clic en Installed Apps.

  3. Ve al espacio de nombres cattle-logging-system y marca las casillas para rancher-logging y rancher-logging-crd.

  4. Haz clic en Eliminar.

  5. Confirma Eliminar.

Result rancher-logging está desinstalado.

Arquitectura

Para más información sobre cómo funciona la aplicación de registro, consulta esta sección.

Control de acceso basado en funciones

El registro de Rancher tiene dos roles, logging-admin y logging-view. Para más información sobre cómo y cuándo usar estos roles, consulta esta página.

Configurando Recursos Personalizados de Registro

Para gestionar Flows, ClusterFlows, Outputs y ClusterOutputs,

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En la página Clústeres, ve al clúster donde deseas configurar recursos personalizados de registro y haz clic en Explorar.

  3. En la barra de navegación izquierda, haz clic en Registro.

Flujos y Flujos de Clúster

Para ayuda con la configuración de Flows y ClusterFlows, consulta esta página.

Salidas y Salidas de Clúster

Para ayuda con la configuración de Outputs y ClusterOutputs, consulta esta página.

Usando una Imagen Personalizada de HostTailer

Para usar una imagen personalizada para el recurso HostTailer, necesitas especificar la imagen en la sección containerOverrides de cada fileTailer del recurso HostTailer.

apiVersion: logging-extensions.banzaicloud.io/v1alpha1
kind: HostTailer
metadata:
  name: cluster-system-log
spec:
  workloadMetaOverrides:
    annotations: {}
    labels: {}
  fileTailers:
    - disabled: false
      name: kubelet-log
      path: /var/lib/rancher/rke2/agent/logs/*.log
      containerOverrides:
        image: <your_registry>/<your_image>:<your_tag>
    - disabled: false
      name: containerd-log
      path: /var/lib/rancher/rke2/agent/containerd/*.log
      containerOverrides:
        image: <your_registry>/<your_image>:<your_tag>
    - name: kube-audit
      path: /var/log/kube-audit/audit-log.json
      disabled: false
      containerOverrides:
        image: <your_registry>/<your_image>:<your_tag>

Configurando el Gráfico de Helm de Registro

Para una lista de opciones que se pueden configurar cuando se instala o actualiza la aplicación de registro, consulta esta página.

Soporte para Windows

Puedes habilitar el registro desde nodos de Windows.

Trabajando con un Directorio Raíz de Docker Personalizado

Para detalles sobre el uso de un directorio raíz de Docker personalizado, consulta esta sección.

Trabajando con Taints y Tolerations

Para información sobre cómo usar taints y tolerations con la aplicación de registro, consulta esta página.

Registro V2 con SELinux

Para información sobre cómo habilitar la aplicación de registro para nodos habilitados para SELinux, consulta esta sección.

Fuentes de registro adicionales

Por defecto, Rancher recoge registros para componentes del plano de control y componentes de nodos para todos los tipos de clúster. En algunos casos, se pueden recoger registros adicionales. Para detalles, consulta esta sección.

Solución de problemas

El búfer de registro sobrecarga los pods.

Dependiendo de tu configuración, el tamaño de búfer por defecto puede ser demasiado grande y causar fallos en los pods. Una forma de reducir la carga es disminuir el intervalo de vaciado del registrador. Esto evita que los registros sobrecarguen el búfer. También puedes añadir más hilos de vaciado para manejar momentos en los que muchos registros intentan llenar el búfer a la vez.

Para una descripción más completa de cómo configurar el búfer de registro para adaptarse a las necesidades de tu organización, consulta la documentación oficial del operador de registro sobre buffers y sobre Fluentd configuration.

El cattle-logging espacio de nombres se está recreando.

Si tu clúster desplegó anteriormente el registro desde la vista global en la interfaz de usuario heredada de Rancher, puedes encontrar un problema donde su espacio de nombres cattle-logging se está recreando continuamente.

La solución es eliminar todos los recursos personalizados clusterloggings.management.cattle.io y projectloggings.management.cattle.io del espacio de nombres específico del clúster en el clúster downstream. La existencia de estos recursos personalizados provoca que Rancher cree el espacio de nombres cattle-logging en el clúster downstream si no existe.

El espacio de nombres del clúster coincide con el ID del clúster, por lo que necesitamos encontrar el ID del clúster para cada clúster.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En la página Clústeres, ve al clúster del que deseas obtener el ID y haz clic en Explore.

  3. Copia la parte <cluster-id> de una de las URL a continuación. La parte <cluster-id> es el nombre del espacio de nombres del clúster.

# Cluster Management UI
https://<your-url>/c/<cluster-id>/

# Cluster Dashboard
https://<your-url>/dashboard/c/<cluster-id>/

Ahora que tenemos el espacio de nombres <cluster-id>, podemos eliminar los CRs que causan que cattle-logging se recree continuamente. Advertencia: asegúrate de que el registro, la versión instalada desde la vista global en la interfaz de usuario heredada de Rancher, no esté actualmente en uso.

kubectl delete crd clusterloggings.management.cattle.io -n <cluster-id>
kubectl delete crd projectloggings.management.cattle.io -n <cluster-id>