10.13. Transférer les journaux à Loki

Procédure

1. Créez ou modifiez un fichier YAML qui définit l'objet ClusterLogForwarder CR :

     apiVersion: "logging.openshift.io/v1"
     kind: ClusterLogForwarder
     metadata:
       name: instance 1
       namespace: openshift-logging 2
     spec:
       outputs:
        - name: loki-insecure 3
          type: "loki" 4
          url: http://loki.insecure.com:3100 5
          loki:
             tenantKey: kubernetes.namespace_name
             labelKeys: kubernetes.labels.foo
        - name: loki-secure 6
          type: "loki"
          url: https://loki.secure.com:3100
          secret:
             name: loki-secret 7
          loki:
             tenantKey: kubernetes.namespace_name 8
             labelKeys: kubernetes.labels.foo 9
       pipelines:
        - name: application-logs 10
          inputRefs:  11
          - application
          - audit
          outputRefs: 12
          - loki-secure

   1

   Le nom du CR ClusterLogForwarder doit être instance.

   2

   L'espace de noms pour le CR ClusterLogForwarder doit être openshift-logging.

   3

   Spécifiez un nom pour la sortie.

   4

   Spécifiez le type comme "loki".

   5

   Spécifiez l'URL et le port du système Loki sous la forme d'une URL absolue valide. Vous pouvez utiliser le protocole http (non sécurisé) ou https (HTTP sécurisé). Si le proxy à l'échelle du cluster utilisant l'annotation CIDR est activé, la sortie doit être un nom de serveur ou un FQDN, et non une adresse IP. Le port par défaut de Loki pour la communication HTTP(S) est 3100.

   6

   Pour une connexion sécurisée, vous pouvez spécifier une URL https ou http que vous authentifiez en spécifiant un secret.

   7

   Pour un préfixe https, indiquez le nom du secret requis par le point d'extrémité pour la communication TLS. Le secret doit exister dans le projet openshift-logging et doit avoir des clés de : tls.crt, tls.key, et ca-bundle.crt qui pointent vers les certificats respectifs qu'elles représentent. Sinon, pour les préfixes http et https, vous pouvez spécifier un secret contenant un nom d'utilisateur et un mot de passe. Pour plus d'informations, voir l'exemple suivant : "Exemple : Définition d'un secret contenant un nom d'utilisateur et un mot de passe.\N-"

   8

   Facultatif : Spécifiez un champ clé de métadonnées pour générer des valeurs pour le champ TenantID dans Loki. Par exemple, le paramètre tenantKey: kubernetes.namespace_name utilise les noms des espaces de noms Kubernetes comme valeurs pour les identifiants de locataire dans Loki. Pour connaître les autres champs d'enregistrement que vous pouvez spécifier, voir le lien "Champs d'enregistrement" dans la section suivante "Ressources supplémentaires".

   9

   Facultatif : Spécifiez une liste de clés de champs de métadonnées pour remplacer les étiquettes Loki par défaut. Les noms des étiquettes Loki doivent correspondre à l'expression régulière [a-zA-Z_:][a-zA-Z0-9_:]*. Les caractères illégaux dans les clés de métadonnées sont remplacés par _ pour former le nom de l'étiquette. Par exemple, la clé de métadonnées kubernetes.labels.foo devient l'étiquette Loki kubernetes_labels_foo. Si vous ne définissez pas labelKeys, la valeur par défaut est : [log_type, kubernetes.namespace_name, kubernetes.pod_name, kubernetes_host]. Veillez à ce que l'ensemble des étiquettes soit restreint, car Loki limite la taille et le nombre d'étiquettes autorisées. Voir Configuration de Loki, limits_config. Vous pouvez toujours effectuer des requêtes basées sur n'importe quel champ de l'enregistrement à l'aide de filtres de requête.

   10

   Facultatif : Spécifiez un nom pour le pipeline.

   11

   Spécifiez les types de journaux à transférer en utilisant le pipeline : application, infrastructure ou audit.

   12

   Spécifiez le nom de la sortie à utiliser lors du transfert des journaux avec ce pipeline.

   Note

   Comme Loki exige que les flux de journaux soient correctement classés par date, labelKeys inclut toujours le jeu d'étiquettes kubernetes_host, même si vous ne le spécifiez pas. Cette inclusion garantit que chaque flux provient d'un seul hôte, ce qui empêche les horodatages d'être désordonnés en raison des différences d'horloge sur les différents hôtes.

2. Créer l'objet CR :

   oc create -f <nom-de-fichier>.yaml