Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

SUSE Rancher Prime Integração com serviços de registro

O Operador de Registro agora alimenta a solução de registro do Rancher em vez da antiga solução interna.

Habilitando Registro

Você pode habilitar o registro para um cluster gerenciado pelo Rancher acessando a página de Aplicativos e instalando o aplicativo de registro.

  1. Vá para o cluster onde deseja instalar o registro e clique em Aplicativos.

  2. Clique no aplicativo Registro.

  3. Role até o final do README do gráfico Helm e clique em Instalar.

Resultado: O aplicativo de registro está implantado no namespace cattle-logging-system.

Desinstalar Registro

  1. Vá para o cluster onde deseja instalar o registro e clique em Aplicativos.

  2. Clique em Apps Instalados.

  3. Vá para o namespace cattle-logging-system e marque as caixas para rancher-logging e rancher-logging-crd.

  4. Clique em Excluir.

  5. Confirme Excluir.

Resultado rancher-logging está desinstalado.

Arquitetura

Para mais informações sobre como o aplicativo de registro funciona, veja esta seção.

Controle de acesso com base em função

O registro do Rancher tem dois papéis, logging-admin e logging-view. Para mais informações sobre como e quando usar esses papéis, veja esta página.

Configurando Recursos Personalizados de Registro

Para gerenciar Flows, ClusterFlows, Outputs e ClusterOutputs,

  1. No canto superior esquerdo, clique em ☰ > Gerenciamento de Cluster.

  2. Na página Clusters, vá para o cluster onde você deseja configurar recursos personalizados de registro e clique em Explorar.

  3. Na barra de navegação à esquerda, clique em Registro.

Fluxos e ClusterFlows

Para ajuda com a configuração de Flows e ClusterFlows, veja esta página.

Saídas e ClusterOutputs

Para ajuda com a configuração de Outputs e ClusterOutputs, veja esta página.

Usando uma Imagem Customizada do HostTailer

Para usar uma imagem customizada para o recurso HostTailer, você precisa especificar a imagem na seção containerOverrides de cada fileTailer do 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 o Helm Chart de registro

Para uma lista de opções que podem ser configuradas quando o aplicativo de registro é instalado ou atualizado, consulte esta página.

Suporte ao Windows

Você pode ativar o registro a partir de nós Windows.

Trabalhando com um Diretório Raiz do Docker Customizado

Para detalhes sobre como usar um diretório raiz do Docker customizado, consulte esta seção.

Trabalhando com Taints e Tolerations

Para informações sobre como usar taints e tolerations com o aplicativo de registro, consulte esta página.

Registro V2 com SELinux

Para informações sobre como habilitar o aplicativo de registro para nós com SELinux habilitado, consulte esta seção.

Fontes de Log Adicionais

Por padrão, o Rancher coleta registros dos componentes do plano de controle e dos nós para todos os tipos de cluster. Em alguns casos, registros adicionais podem ser coletados. Para detalhes, consulte esta seção.

Solução de problemas

O buffer de registro sobrecarrega os pods.

Dependendo da sua configuração, o tamanho do buffer padrão pode ser muito grande e causar falhas nos pods. Uma maneira de reduzir a carga é diminuir o intervalo de descarregamento do logger. Isso evita que os registros sobrecarreguem o buffer. Você também pode adicionar mais threads de descarregamento para lidar com momentos em que muitos registros estão tentando preencher o buffer ao mesmo tempo.

Para uma descrição mais completa de como configurar o buffer de registro para atender às necessidades da sua organização, consulte a documentação oficial do operador de registro em buffers e em configuração do Fluentd.

O Namespace cattle-logging Sendo Recriado

Se seu cluster anteriormente implantou registro a partir da visão global na interface legada do Rancher, você pode encontrar um problema em que seu namespace cattle-logging está sendo continuamente recriado.

A solução é excluir todos os recursos personalizados clusterloggings.management.cattle.io e projectloggings.management.cattle.io do namespace específico do cluster no cluster de gerenciamento. A existência desses recursos personalizados faz com que o Rancher crie o namespace cattle-logging no cluster downstream se ele não existir.

O namespace do cluster corresponde ao ID do cluster, então precisamos encontrar o ID do cluster para cada cluster.

  1. No canto superior esquerdo, clique em ☰ > Gerenciamento de Cluster.

  2. Na página Clusters, vá para o cluster do qual você deseja obter o ID e clique em Explorar.

  3. Copie a parte <cluster-id> de uma das URLs abaixo. A parte <cluster-id> é o nome do namespace do cluster.

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

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

Agora que temos o <cluster-id> namespace, podemos excluir os CRs que fazem com que cattle-logging seja continuamente recriado. Aviso: certifique-se de que o registro, a versão instalada a partir da visão global na interface legada do Rancher, não esteja atualmente em uso.

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