Pilote de logging Syslog

Le pilote de logging syslog route les logs vers un serveur syslog. Le protocole syslog utilise une chaîne brute comme message de log et supporte un ensemble limité de métadonnées. Le message syslog doit être formaté d'une manière spécifique pour être valide. À partir d'un message valide, le récepteur peut extraire les informations suivantes :

• Priorité : le niveau de logging, tel que debug, warning, error, info.
• Horodatage : quand l'événement s'est produit.
• Nom d'hôte : où l'événement s'est produit.
• Facilité : quel sous-système a loggé le message, tel que mail ou kernel.
• Nom de processus et ID de processus (PID) : Le nom et l'ID du processus qui a généré le log.

Le format est défini dans RFC 5424 et le pilote syslog de Docker implémente la référence ABNF de la manière suivante :

                TIMESTAMP SP HOSTNAME SP APP-NAME SP PROCID SP MSGID
                    +          +             +           |        +
                    |          |             |           |        |
                    |          |             |           |        |
       +------------+          +----+        |           +----+   +---------+
       v                            v        v                v             v
2017-04-01T17:41:05.616647+08:00 a.vm {taskid:aa,version:} 1787791 {taskid:aa,version:}

Utilisation

Pour utiliser le pilote syslog comme pilote de logging par défaut, définissez les clés log-driver et log-opt aux valeurs appropriées dans le fichier daemon.json, qui se trouve dans /etc/docker/ sur les hôtes Linux ou C:\ProgramData\docker\config\daemon.json sur Windows Server. Pour plus d'informations sur la configuration de Docker en utilisant daemon.json, voir daemon.json.

L'exemple suivant définit le pilote de log à syslog et définit l'option syslog-address. Les options syslog-address supportent à la fois UDP et TCP ; cet exemple utilise UDP.

{
  "log-driver": "syslog",
  "log-opts": {
    "syslog-address": "udp://1.2.3.4:1111"
  }
}

Redémarrez Docker pour que les changements prennent effet.

Note

Les options de configuration log-opts dans le fichier de configuration daemon.json doivent être fournies sous forme de chaînes. Les valeurs numériques et booléennes (telles que la valeur pour syslog-tls-skip-verify) doivent donc être entourées de guillemets (").

Vous pouvez définir le pilote de logging pour un conteneur spécifique en utilisant le drapeau --log-driver avec docker container create ou docker run :

$ docker run \
      --log-driver syslog --log-opt syslog-address=udp://1.2.3.4:1111 \
      alpine echo hello world

Options

Les options de logging suivantes sont supportées comme options pour le pilote de logging syslog. Elles peuvent être définies comme valeurs par défaut dans le daemon.json, en les ajoutant comme paires clé-valeur au tableau JSON log-opts. Elles peuvent aussi être définies sur un conteneur donné en ajoutant un drapeau --log-opt <key>=<value> pour chaque option lors du démarrage du conteneur.