返回介绍

systemd-journal-gatewayd.service 中文手册

发布于 2020-11-08 09:27:17 字数 5578 浏览 1011 评论 0 收藏 0

名称

systemd-journal-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd — 专用于传输日志流的HTTP服务器

大纲

systemd-journal-gatewayd.service

systemd-journal-gatewayd.socket

/usr/lib/systemd/systemd-journal-gatewayd [OPTIONS...]

描述

systemd-journal-gatewayd 提供通过网络传输日志流的服务。客户端必须使用 HTTP 协议。此服务默认在 19531 端口监听。如果使用 --cert= 指定了服务器证书,那么将只接受 HTTPS 连接。

此程序由systemd(1)调用,并且接收一个单独的套接字。可以使用systemctl start systemd-journal-gatewayd.socket 命令启动服务,可以使用 systemctl enable systemd-journal-gatewayd.socket命令将其设为开机自动启动。

选项

可接受的命令行选项如下:

--cert=

指定 PEM 格式的服务器证书文件的路径。使用此选项之后,systemd-journal-gatewayd 将会以 HTTPS 模式运行。此选项必须与 --key= 同时使用。

--key=

指定 PEM 格式的服务器私钥文件的路径。注意,此私钥必须与 --cert= 服务器证书互相匹配。

--trust=

指定 PEM 格式的 CA 证书文件的路径。

-D DIR, --directory=DIR

接收一个以绝对路径表示的日志目录。如果设置了此选项,那么 systemd-journal-gatewayd 将会基于此处设置的 DIR 目录提供日志传输服务,而不是基于默认的日志目录(包括运行时日志目录与系统日志目录)。

-h, --help

显示简短的帮助信息并退出。

--version

显示简短的版本信息并退出。

URL

可以识别的URL格式如下:

/browse

交互式浏览

/entries[?option1&option2=value…]

以各种不同的格式拉取日志事件。

HTTP 头中的 Accept: 用于指定格式,详见下面的"Accept 头"小节。

HTTP 头中的 Range: 用于指定日志事件的范围,详见下面的"Range 头"小节。

可以使用GET参数来控制拉取哪些日志事件。详见下面的"URL GET 参数"小节。

/machine

获取一个以 JSON 格式描述的系统信息。

示例:

{ "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446",
  "boot_id" : "3d3c9efaf556496a9b04259ee35df7f7",
  "hostname" : "fedora",
  "os_pretty_name" : "Fedora 19 (Rawhide)",
  "virtualization" : "kvm",
  …}

/fields/FIELD_NAME

获取日志中 FIELD_NAME 字段的值列表

Accept 头

Accept: format

能够识别的 format 如下:

text/plain

这是默认值。表示以纯文本输出 syslog 格式的日志,每一行就是一个日志事件。与 journalctl --output short 的输出格式相同。

application/json

以 JSON 格式输出日志事件,每一行就是一个日志事件。与 journalctl --output json 的输出格式相同。参见 Journal JSON Format 以了解详情。

text/event-stream

以 JSON 格式输出日志事件,并按照 Server-Sent Events 规范进行封装。与 journalctl --output json-sse 的输出格式相同。

application/vnd.fdo.journal

将日志事件 序列化为一个二进制流(主要内容依然是文本),以便于备份和网络传输。与 journalctl --output export 的输出格式相同。参见 Journal Export Format 以了解详情。

Range 头

Range: entries=cursor[[:num_skip]:num_entries]

其中,cursor 是一个游标(cursor)字符串、num_skip 是一个有符号整数、num_entries 是一个有符号整数。

默认的 Range 是拉取全部日志事件。

URL GET 参数

可以在URL中使用下列参数:

follow

等待新的日志事件。与 journalctl --follow 类似,不同之处在于不限制返回的日志事件的数量。

discrete

按照给定的游标(cursor)检索日志事件。仅返回与指定游标(cursor)匹配的那一条日志事件。

boot

仅检索系统本次启动中的日志事件。相当于 journalctl -b

KEY=match

根据日志字段进行匹配。参见 systemd.journal-fields(7) 手册。

例子

从本机日志中检索本次启动中的日志事件,并按照 JournalExport Format 格式输出:

curl --silent -H'Accept: application/vnd.fdo.journal' \ 'http://localhost:19531/entries?boot'

监听内存转储(core dump)事件:

curl 'http://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1'

参见

systemd(1),journalctl(1),systemd.journal-fields(7),systemd-journald.service(8),systemd-journal-remote.service(8),systemd-journal-upload.service(8)

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文