36.8. 将日志发送到外部 Syslog 服务器

在主机上使用 fluent-plugin-remote-syslog 插件，将日志发送到外部 syslog 服务器。

在 logging-fluentd 或 logging-mux daemonsets 中设置环境变量：

- name: REMOTE_SYSLOG_HOST 1
  value: host1
- name: REMOTE_SYSLOG_HOST_BACKUP
  value: host2
- name: REMOTE_SYSLOG_PORT_BACKUP
  value: 5555

这将建立两个目的地。host1 上的 syslog 服务器将在默认端口 514 上接收消息，host2 则在端口 5555 上接收相同的消息。

另外，您还可以在 logging-fluentd 或 logging-mux ConfigMap 中配置自己的自定义 fluent.conf。

Fluentd 环境变量

参数	描述
`USE_REMOTE_SYSLOG`	默认值为 `false`。设置为 `true` 可启用`fluent-plugin-remote-syslog` gem
`REMOTE_SYSLOG_HOST`	（必需）远程 syslog 服务器的主机名或 IP 地址。
`REMOTE_SYSLOG_PORT`	要连接的端口号。默认值为 `514`。
`REMOTE_SYSLOG_SEVERITY`	设置 syslog 严重性级别。默认值为 `debug`。
`REMOTE_SYSLOG_FACILITY`	设置 syslog 工具。默认值为 `local0`。
`REMOTE_SYSLOG_USE_RECORD`	默认值为 `false`。设置为 `true` 可使用记录的严重性和工具字段对 syslog 消息进行设置。
`REMOTE_SYSLOG_REMOVE_TAG_PREFIX`	从标签中删除前缀，默认为 `''`（空白）。
`REMOTE_SYSLOG_TAG_KEY`	如果指定，则使用此字段作为要在记录上查看的键，以对 syslog 消息设置标签。
`REMOTE_SYSLOG_PAYLOAD_KEY`	如果指定，则使用此字段作为要在记录上查看的键，以对 syslog 消息设置有效负载。
`REMOTE_SYSLOG_TYPE`	设置传输层协议类型。默认为 `syslog_buffered`，它设定 TCP 协议。要切换到 UDP，请将其设定为 `syslog`。

警告

这种实施是不安全的，应当仅在能保证不嗅探连接的环境中使用。

Fluentd Logging Ansible 变量

参数	描述
`openshift_logging_fluentd_remote_syslog`	默认值为 `false`。设置为 `true` 以启用 fluent-plugin-remote-syslog gem。
`openshift_logging_fluentd_remote_syslog_host`	远程 syslog 服务器的主机名或 IP 地址，这是必需的。
`openshift_logging_fluentd_remote_syslog_port`	要连接的端口号，默认为 `514`。
`openshift_logging_fluentd_remote_syslog_severity`	设置 syslog 严重性级别，默认为 `debug`。
`openshift_logging_fluentd_remote_syslog_facility`	设置 syslog 工具，默认为 `local0`。
`openshift_logging_fluentd_remote_syslog_use_record`	默认值为 `false`。设置为 `true` 可使用记录的严重性和工具字段对 syslog 消息进行设置。
`openshift_logging_fluentd_remote_syslog_remove_tag_prefix`	从标签中删除前缀，默认为 `''`（空白）。
`openshift_logging_fluentd_remote_syslog_tag_key`	如果指定了字符串，则使用此字段作为要在记录上查看的键，以对 syslog 消息设置标签。
`openshift_logging_fluentd_remote_syslog_payload_key`	如果指定了字符串，则使用此字段作为要在记录上查看的键，在 syslog 消息上设置有效负载。

MUX Logging Ansible 变量

参数	描述
`openshift_logging_mux_remote_syslog`	默认值为 `false`。设置为 `true` 以启用 fluent-plugin-remote-syslog gem。
`openshift_logging_mux_remote_syslog_host`	远程 syslog 服务器的主机名或 IP 地址，这是必需的。
`openshift_logging_mux_remote_syslog_port`	要连接的端口号，默认为 `514`。
`openshift_logging_mux_remote_syslog_severity`	设置 syslog 严重性级别，默认为 `debug`。
`openshift_logging_mux_remote_syslog_facility`	设置 syslog 工具，默认为 `local0`。
`openshift_logging_mux_remote_syslog_use_record`	默认值为 `false`。设置为 `true` 可使用记录的严重性和工具字段对 syslog 消息进行设置。
`openshift_logging_mux_remote_syslog_remove_tag_prefix`	从标签中删除前缀，默认为 `''`（空白）。
`openshift_logging_mux_remote_syslog_tag_key`	如果指定了字符串，则使用此字段作为要在记录上查看的键，以对 syslog 消息设置标签。
`openshift_logging_mux_remote_syslog_payload_key`	如果指定了字符串，则使用此字段作为要在记录上查看的键，在 syslog 消息上设置有效负载。