APM Server 和 systemd

Elastic Stack

重要事项

这些命令仅适用于 APM Server 二进制文件安装方法。 Fleet 管理的用户应参阅在边缘主机上启动和停止 Elastic Agent。

DEB 和 RPM 软件包包含用于具有 systemd 的 Linux 系统的服务单元。在这些系统上，您可以使用常用的 systemd 命令来管理 APM Server。

我们建议 apm-server 进程以非 root 用户身份运行。因此，这是 APM Server 的 DEB 软件包和 RPM 安装的默认设置。

启动和停止 APM Server

使用 systemctl 启动或停止 APM Server

sudo systemctl start apm-server

sudo systemctl stop apm-server

默认情况下，APM Server 服务在系统启动时自动启动。要启用或禁用自动启动，请使用

sudo systemctl enable apm-server

sudo systemctl disable apm-server

APM Server 状态和日志

要获取服务状态，请使用 systemctl

systemctl status apm-server

日志默认存储在 journald 中。要查看日志，请使用 journalctl

journalctl -u apm-server.service

自定义 APM Server 的 systemd 单元

systemd 服务单元文件包含您可以覆盖以更改默认选项的环境变量。

变量	描述	默认值
`BEAT_LOG_OPTS`	日志选项
`BEAT_CONFIG_OPTS`	配置文件路径的标志	`-c /etc/apm-server/apm-server.yml`
`BEAT_PATH_OPTS`	其他路径	`-path.home /usr/share/apm-server -path.config /etc/apm-server -path.data /var/lib/apm-server -path.logs /var/log/apm-server`

注意

您可以使用 BEAT_LOG_OPTS 为日志记录设置调试选择器。但是，要配置日志记录行为，请设置配置日志记录中描述的日志记录选项。

要覆盖这些变量，请在 /etc/systemd/system/apm-server.service.d 目录中创建一个 drop-in 单元文件。

例如，将以下内容放在 /etc/systemd/system/apm-server.service.d/debug.conf 中的文件将覆盖 BEAT_LOG_OPTS 以启用 Elasticsearch 输出的调试。

		[Service]
Environment="BEAT_LOG_OPTS=-d elasticsearch"

要应用您的更改，请重新加载 systemd 配置并重新启动服务

		systemctl daemon-reload
systemctl restart apm-server

注意

建议您使用配置管理工具来包含 drop-in 单元文件。如果您需要手动添加 drop-in，请使用 systemctl edit apm-server.service。

配置文件所有权

在具有 POSIX 文件权限的系统上，APM Server 配置文件受所有权和文件权限检查的约束。这些检查可防止未经授权的用户提供或修改由 APM Server 运行的配置。

通过 RPM 或 DEB 软件包安装时，/etc/apm-server/apm-server.yml 中的配置文件将由 apm-server 拥有，并且具有 0600 (-rw-------) 的文件权限。

仅当配置文件由运行该进程的用户拥有，或者以 root 身份运行且配置所有权设置为 root:root 时，APM Server 才会启动

如果您的配置文件未通过这些检查，您可能会遇到以下错误

		Exiting: error loading config file: config file ("/etc/apm-server/apm-server.yml")
must be owned by the user identifier (uid=1000) or root

要纠正此问题，您可以使用以下命令更改配置文件的所有权：chown apm-server:apm-server /etc/apm-server/apm-server.yml。

您也可以使 root 成为配置所有者，尽管不建议这样做：sudo chown root:root /etc/apm-server/apm-server.yml。

		Exiting: error loading config file: config file ("/etc/apm-server/apm-server.yml")
can only be writable by the owner but the permissions are "-rw-rw-r--"
(to fix the permissions use: 'chmod go-w /etc/apm-server/apm-server.yml')

	

要纠正此问题，请使用 chmod go-w /etc/apm-server/apm-server.yml 删除所有者以外的任何人的写入权限。

禁用严格的权限检查

您可以使用 --strict.perms=false 从命令行禁用严格的权限检查，但我们强烈建议您保持启用这些检查。