Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

SUSE Rancher Prime Intégration avec les services de journalisation

Le Opérateur de journalisation alimente désormais la solution de journalisation de Rancher à la place de l’ancienne solution interne.

Activation de la journalisation

Vous pouvez activer la journalisation pour un cluster géré par Rancher en allant sur la page des applis et en installant l’appli de journalisation.

  1. Allez au cluster où vous souhaitez installer la journalisation et cliquez sur Applis.

  2. Cliquez sur l’appli Journalisation.

  3. Faites défiler jusqu’en bas du README du chart Helm et cliquez sur Installer.

Résultat : L’application de journalisation est déployée dans l’espace de noms cattle-logging-system.

Désinstaller la journalisation

  1. Allez au cluster où vous souhaitez installer la journalisation et cliquez sur Applis.

  2. Cliquez sur Applis installées.

  3. Allez dans l’espace de noms cattle-logging-system et cochez les cases pour rancher-logging et rancher-logging-crd.

  4. Cliquez sur Supprimer.

  5. Confirmez Supprimer.

Résultat rancher-logging est désinstallé.

Architecture

Pour plus d’informations sur le fonctionnement de l’appli de journalisation, consultez cette section.

Contrôle d’accès en fonction du rôle

Rancher logging a deux rôles, logging-admin et logging-view. Pour plus d’informations sur la façon et le moment d’utiliser ces rôles, consultez cette page.

Configuration des ressources personnalisées de journalisation

Pour gérer Flows, ClusterFlows, Outputs et ClusterOutputs,

  1. Dans le coin supérieur gauche, cliquez sur ☰ > Gestion des clusters.

  2. Sur la page Clusters, allez au cluster où vous souhaitez configurer les ressources personnalisées de journalisation et cliquez sur Explorer.

  3. Dans la barre de navigation de gauche, cliquez sur Journalisation.

Flux et ClusterFlows

Pour obtenir de l’aide sur la configuration de Flows et ClusterFlows, consultez cette page.

Sorties et ClusterOutputs

Pour obtenir de l’aide sur la configuration de Outputs et ClusterOutputs, consultez cette page.

Utilisation d’une image Custom HostTailer

Pour utiliser une image personnalisée pour la ressource HostTailer, vous devez spécifier l’image dans la section containerOverrides de chaque fileTailer de la ressource 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>

Configuration du Helm Chart de journalisation

Pour une liste des options pouvant être configurées lors de l’installation ou de la mise à niveau de l’application de journalisation, voir cette page.

Support Windows

Vous pouvez activer la journalisation depuis les nœuds Windows.

Travailler avec un répertoire racine Docker personnalisé

Pour des détails sur l’utilisation d’un répertoire racine Docker personnalisé, voir cette section.

Travailler avec des taints et des tolérances

Pour des informations sur l’utilisation des taints et des tolérances avec l’application de journalisation, voir cette page.

Journalisation V2 avec SELinux

Pour des informations sur l’activation de l’application de journalisation sur les nœuds où SELinux est activé, voir cette section.

Sources de journalisation supplémentaires

Par défaut, Rancher collecte les journaux pour les composants du plan de contrôle et les composants des nœuds pour tous les types de clusters. Dans certains cas, des journaux supplémentaires peuvent être collectés. Pour des détails, voir cette section.

Dépannage

Le tampon de journalisation surcharge les pods

Selon votre configuration, la taille de tampon par défaut peut être trop grande et provoquer des échecs de pods. Une façon de réduire la charge est de diminuer l’intervalle de vidage du journaliseur. Cela empêche les journaux de trop remplir le tampon. Vous pouvez également ajouter plus de threads de vidage pour gérer les moments où de nombreux journaux tentent de remplir le tampon en même temps.

Pour une description plus complète de la façon de configurer le tampon de journalisation pour répondre aux besoins de votre organisation, voir la documentation officielle de l’opérateur de journalisation sur tampons et sur configuration de Fluentd.

Le cattle-logging espace de noms est en cours de recréation

Si votre cluster a précédemment déployé la journalisation depuis la vue globale dans l’interface utilisateur héritée de Rancher, vous pouvez rencontrer un problème où son cattle-logging espace de noms est continuellement recréé.

La solution consiste à supprimer toutes les ressources personnalisées clusterloggings.management.cattle.io et projectloggings.management.cattle.io de l’espace de noms spécifique au cluster dans le cluster de gestion. L’existence de ces ressources personnalisées entraîne la création de l’espace de noms cattle-logging dans le cluster en aval s’il n’existe pas.

L’espace de noms du cluster correspond à l’ID du cluster, nous devons donc trouver l’ID du cluster pour chaque cluster.

  1. Dans le coin supérieur gauche, cliquez sur ☰ > Gestion des clusters.

  2. Sur la page Clusters, allez au cluster dont vous souhaitez obtenir l’ID et cliquez sur Explorer.

  3. Copiez la portion <cluster-id> d’une des URL ci-dessous. La portion <cluster-id> est le nom de l’espace de noms du cluster.

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

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

Maintenant que nous avons l’espace de noms <cluster-id>, nous pouvons supprimer les CR qui provoquent la recréation continue de cattle-logging. Avertissement&nbsp;: assurez-vous que la journalisation, la version installée depuis la vue globale dans l’interface utilisateur héritée de Rancher, n’est pas actuellement utilisée.

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