5.4. Installation de logging et de l’opérateur Loki à l’aide de la console Web

Procédure

1. Dans le Red Hat OpenShift Service sur AWS Web console Administrator perspective, allez à Opérateurs OperatorHub.

2. Entrez Loki Opérateur dans le champ Filtrer par mot-clé. Cliquez sur l’opérateur Loki dans la liste des opérateurs disponibles, puis cliquez sur Installer.

   Important

   L’opérateur Loki communautaire n’est pas soutenu par Red Hat.

3. Choisissez stable ou stable-x.y comme canal de mise à jour.

   Note

   Le canal stable ne fournit que des mises à jour de la version la plus récente de l’enregistrement. Afin de continuer à recevoir des mises à jour pour les versions antérieures, vous devez changer votre canal d’abonnement en stable-x.y, où x.y représente la version majeure et mineure de la journalisation que vous avez installée. À titre d’exemple, stable-5.7.

   L’opérateur Loki doit être déployé dans l’espace de noms du groupe d’opérateur mondial openshift-operators-redhat, de sorte que le mode Installation et Namespace installé sont déjà sélectionnés. Lorsque cet espace de noms n’existe pas déjà, il est créé pour vous.

4. Activez la surveillance des clusters recommandée par l’opérateur sur cet espace de noms.

   Cette option définit l’étiquette openshift.io/cluster-monitoring: "vrai" étiquette dans l’objet Namespace. Il faut sélectionner cette option pour s’assurer que la surveillance des clusters gratte l’espace de noms openshift-operators-redhat.

5. Dans le cas de l’approbation de mise à jour, sélectionnez Automatique, puis cliquez sur Installer.

   Lorsque la stratégie d’approbation de l’abonnement est définie sur Automatique, le processus de mise à jour démarre dès qu’une nouvelle version de l’opérateur est disponible dans le canal sélectionné. Lorsque la stratégie d’approbation est définie sur Manuel, vous devez approuver manuellement les mises à jour en attente.

6. Installez l’opérateur de journalisation Red Hat OpenShift:

   1. Dans le Red Hat OpenShift Service sur la console web AWS, cliquez sur Opérateurs OperatorHub.
   2. Choisissez Red Hat OpenShift Logging dans la liste des opérateurs disponibles, puis cliquez sur Installer.
   3. Assurez-vous que l’espace de noms A spécifique sur le cluster est sélectionné sous Mode d’installation.
   4. Assurez-vous que l’espace de noms recommandé par l’opérateur est ouvert de connexion sous Namespace installé.

   5. Activer l’opérateur recommande la surveillance des clusters sur cet espace de noms.

      Cette option définit l’étiquette openshift.io/cluster-monitoring: "vrai" étiquette dans l’objet Namespace. Il faut sélectionner cette option pour s’assurer que la surveillance des clusters gratte l’espace de noms openshift-logging.

   6. Choisissez stable-5.y comme canal de mise à jour.

   7. Choisissez une stratégie d’approbation.

      • La stratégie automatique permet au gestionnaire de cycle de vie de l’opérateur (OLM) de mettre à jour automatiquement l’opérateur lorsqu’une nouvelle version est disponible.
      • La stratégie du Manuel exige qu’un utilisateur ayant les informations d’identification appropriées approuve la mise à jour de l’opérateur.
   8. Cliquez sur Install.
7. Accédez à la page Opérateurs installés Opérateurs installés. Cliquez sur l’onglet Toutes les instances.
8. Dans la liste déroulante Créer une nouvelle liste déroulante, sélectionnez LokiStack.

9. Choisissez la vue YAML, puis utilisez le modèle suivant pour créer un LokiStack CR:

   Exemple LokiStack CR

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki 

   1

   
     namespace: openshift-logging 

   2

   
   spec:
     size: 1x.small 

   3

   
     storage:
       schemas:
       - version: v13
         effectiveDate: "<yyyy>-<mm>-<dd>"
       secret:
         name: logging-loki-s3 

   4

   
         type: s3 

   5

   
         credentialMode: 

   6

   
     storageClassName: <storage_class_name> 

   7

   
     tenants:
       mode: openshift-logging 

   8

   Copy to Clipboard Toggle word wrap

   1

   J’utilise le nom logging-loki.

   2

   Il faut spécifier l’espace de noms openshift-logging.

   3

   Indiquez la taille du déploiement. Dans l’enregistrement 5.8 et les versions ultérieures, les options de taille prises en charge pour les instances de production de Loki sont 1x.extra-petit, 1x.petit, ou 1x.medium.

   4

   Indiquez le nom de votre log store secret.

   5

   Indiquez le type de stockage correspondant.

   6

   Champ optionnel, journalisation 5.9 et ultérieure. Les valeurs configurées par l’utilisateur pris en charge sont les suivantes: statique est le mode d’authentification par défaut disponible pour tous les types de stockage d’objet pris en charge à l’aide d’informations d’identification stockées dans un jeton Secret. Dans ce mode, la configuration statique ne contient pas d’informations d’identification nécessaires au stockage d’objets. Au lieu de cela, ils sont générés pendant l’exécution à l’aide d’un service, ce qui permet des informations d’identification plus courtes et un contrôle beaucoup plus granulaire. Ce mode d’authentification n’est pas pris en charge pour tous les types de stockage d’objets. token-cco est la valeur par défaut lorsque Loki s’exécute en mode STS géré et utilise CCO sur les clusters STS/WIF.

   7

   Indiquez le nom d’une classe de stockage pour le stockage temporaire. Afin d’obtenir des performances optimales, spécifiez une classe de stockage qui alloue le stockage en bloc. Les classes de stockage disponibles pour votre cluster peuvent être répertoriées à l’aide de la commande oc get storageclasses.

   8

   LokiStack par défaut s’exécute en mode multi-locataires, qui ne peut pas être modifié. Il y a un locataire pour chaque type de journal : audit, infrastructure et journaux d’applications. Cela permet le contrôle d’accès pour les utilisateurs individuels et les groupes d’utilisateurs à différents flux de journaux.

   Important

   Il n’est pas possible de modifier le nombre 1x pour la taille du déploiement.

10. Cliquez sur Create.

11. Créer une instance OpenShift Logging:

    1. Basculez à la page Administration Définitions de ressources personnalisées.
    2. Dans la page Définitions de ressources personnalisées, cliquez sur ClusterLogging.
    3. Dans la page Détails de la définition des ressources personnalisées, sélectionnez Afficher les instances dans le menu Actions.

    4. Dans la page ClusterLoggings, cliquez sur Créer ClusterLogging.

       Il vous faudra peut-être actualiser la page pour charger les données.

    5. Dans le champ YAML, remplacer le code par ce qui suit:

       apiVersion: logging.openshift.io/v1
       kind: ClusterLogging
       metadata:
         name: instance 

       1

       
         namespace: openshift-logging 

       2

       
       spec:
         collection:
           type: vector
         logStore:
           lokistack:
             name: logging-loki
           retentionPolicy:
             application:
               maxAge: 7d
             audit:
               maxAge: 7d
             infra:
               maxAge: 7d
           type: lokistack
         visualization:
           type: ocp-console
           ocpConsole:
             logsLimit: 15
       
         managementState: Managed

       Copy to Clipboard Toggle word wrap

       1

       Le nom doit être instance.

       2

       L’espace de noms doit être ouvert-logging.

La vérification

1. Allez à Opérateurs Opérateurs installés.
2. Assurez-vous que le projet openshift-logging est sélectionné.
3. Dans la colonne État, vérifiez que vous voyez des cocheries vertes avec InstallSucceeded et le texte à jour.