10.11. Transmission des journaux à l'aide du protocole syslog

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: rsyslog-east 3
        type: syslog 4
        syslog: 5
          facility: local0
          rfc: RFC3164
          payloadKey: message
          severity: informational
        url: 'tls://rsyslogserver.east.example.com:514' 6
        secret: 7
           name: syslog-secret
      - name: rsyslog-west
        type: syslog
        syslog:
         appName: myapp
         facility: user
         msgID: mymsg
         procID: myproc
         rfc: RFC5424
         severity: debug
        url: 'udp://rsyslogserver.west.example.com:514'
     pipelines:
      - name: syslog-east 8
        inputRefs: 9
        - audit
        - application
        outputRefs: 10
        - rsyslog-east
        - default 11
        parse: json 12
        labels:
          secure: "true" 13
          syslog: "east"
      - name: syslog-west 14
        inputRefs:
        - infrastructure
        outputRefs:
        - rsyslog-west
        - default
        labels:
          syslog: "west"

   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 de syslog.

   5

   En option : Spécifiez les paramètres syslog, énumérés ci-dessous.

   6

   Spécifiez l'URL et le port de l'instance syslog externe. Vous pouvez utiliser le protocole udp (non sécurisé), tcp (non sécurisé) ou tls (TCP 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.

   7

   Si vous utilisez un préfixe tls, vous devez spécifier le nom du secret requis par le point de terminaison 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.

   8

   Facultatif : Spécifiez un nom pour le pipeline.

   9

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

   10

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

   11

   Facultatif : Spécifiez la sortie default pour transmettre les journaux à l'instance Elasticsearch interne.

   12

   Facultatif : Indiquez si les entrées de log JSON structurées doivent être transmises en tant qu'objets JSON dans le champ structured. L'entrée de log doit contenir du JSON structuré valide ; sinon, OpenShift Logging supprime le champ structured et envoie l'entrée de log à l'index par défaut, app-00000x.

   13

   Facultatif : Chaîne. Une ou plusieurs étiquettes à ajouter aux journaux. Citez des valeurs comme "true" pour qu'elles soient reconnues comme des chaînes de caractères et non comme des booléens.

   14

   Facultatif : Configurez plusieurs sorties pour transmettre les journaux à d'autres agrégateurs de journaux externes, quel que soit le type pris en charge :

   • Un nom pour décrire le pipeline.
   • L'adresse inputRefs est le type de journal à transmettre en utilisant le pipeline : application, infrastructure, ou audit.
   • outputRefs est le nom de la sortie à utiliser.
   • Facultatif : Chaîne. Une ou plusieurs étiquettes à ajouter aux journaux.

2. Créer l'objet CR :

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