› › › › ›

APM Server 和 systemd

编辑

APM Server 和 systemd

编辑

这些命令仅适用于 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 从命令行禁用严格的权限检查，但我们强烈建议您保持启用这些检查。

« 高可用性监控 APM Server »