配置日志
编辑配置日志
编辑
这些配置选项仅与 APM Server 二进制用户相关。由 Fleet 管理的用户应查看查看 Elastic Agent 日志，了解如何查看日志和更改 Elastic Agent 的日志级别。
apm-server.yml 配置文件中的 logging 部分包含用于配置日志输出的选项。
日志系统可以将日志写入 syslog 或轮转日志文件。如果未显式配置日志，则使用文件输出。
logging.level: info logging.to_files: true logging.files: path: /var/log/apm-server name: apm-server keepfiles: 7 permissions: 0640
除了在配置文件中设置日志选项外，您还可以从命令行修改日志输出配置。请参阅 命令参考。
当 APM Server 在带有 systemd 的 Linux 系统上运行时，默认情况下它会使用 -e 命令行选项，这会使其将所有日志输出写入 stderr，以便可以被 journald 捕获。其他输出将被禁用。请参阅 APM Server 和 systemd 以了解更多信息并学习如何更改此设置。
配置选项
编辑您可以在 apm-server.yml 配置文件的 logging 部分中指定以下选项
logging.to_stderr为 true 时，将所有日志输出写入标准错误输出。这相当于使用 -e 命令行选项。
logging.to_syslog为 true 时，将所有日志输出写入 syslog。
Windows 不支持此选项。
logging.to_eventlog为 true 时，将所有日志输出写入 Windows 事件日志。
logging.to_files为 true 时，将所有日志输出写入文件。当日志文件大小达到限制时，日志文件会自动轮转。
只有存在日志输出时，APM Server 才会创建日志文件。例如，如果您将日志level 设置为 error 且没有错误，则日志中指定的目录中将不会有日志文件。
logging.level最低日志级别。可以是 debug、info、warning 或 error 之一。默认日志级别为 info。
-
debug - 记录调试消息，包括所有刷新事件的详细打印输出。还会记录信息性消息、警告、错误和严重错误。当日志级别为
debug时，您可以指定selectors列表，以显示特定组件的调试消息。如果未指定选择器，则使用*选择器来显示所有组件的调试消息。 -
info - 记录信息性消息，包括已发布事件的数量。还会记录任何警告、错误或严重错误。
-
warning - 记录警告、错误和严重错误。
-
error - 记录错误和严重错误。
logging.selectors由不同 APM Server 组件使用的仅用于调试的选择器标签列表。使用 * 为所有组件启用调试输出。使用 publisher 显示与事件发布相关的调试消息。
可用选择器的列表可能在不同版本之间发生更改，因此请避免创建依赖于特定选择器的测试。
要查看哪些选择器可用，请在调试模式下运行 APM Server（在配置中设置 logging.level: debug）。选择器名称会出现在日志级别之后，并用方括号括起来。
要配置多个选择器，请使用以下 YAML 列表语法
logging.selectors: [ harvester, input ]
要在命令行上覆盖选择器，请使用 -d 全局标志（-d 也会设置调试日志级别）。有关详细信息，请参阅 命令参考。
logging.metrics.enabled默认情况下，APM Server 会定期记录其在上一段时间内已更改的内部指标。对于每个已更改的指标，将记录该期间开始时的值与当前值的差值。此外，所有非零内部指标的总值都会在关闭时记录。将此设置为 false 以禁用此行为。默认为 true。
这是一个示例日志行
2017-12-17T19:17:42.667-0500 INFO [metrics] log/log.go:110 Non-zero metrics in the last 30s: beat.info.uptime.ms=30004 beat.memstats.gc_next=5046416
请注意，我们目前不为内部指标提供向后兼容性保证，因此它们也没有记录在案。
logging.metrics.period记录内部指标的时间间隔。默认为 30s。
logging.files.path日志文件写入的目录。默认为日志路径。有关详细信息，请参阅安装布局部分。
logging.files.name日志写入的文件名。默认为 *apm-server*。
logging.files.rotateeverybytes日志文件的最大大小。如果达到限制，则会生成一个新的日志文件。默认大小限制为 10485760 (10 MB)。
logging.files.keepfiles在磁盘上保留的最近轮转日志文件的数量。较旧的文件将在日志轮转期间被删除。默认值为 7。keepfiles 选项的值必须在 2 到 1024 个文件之间。
logging.files.permissions轮转日志文件时应用的权限掩码。默认值为 0600。permissions 选项必须是以八进制表示的有效 Unix 样式文件权限掩码。在 Go 中，八进制表示的数字必须以 *0* 开头。
允许的最大权限掩码为 0640。如果通过此设置指定了更高的权限掩码，则该掩码将受 0027 的 umask 限制。
示例
- 0640：授予文件所有者读写访问权限，并授予与文件关联的组成员读访问权限。
- 0600：授予文件所有者读写访问权限，并禁止所有其他人访问。
logging.files.interval除了基于大小的轮转外，还启用按时间间隔的日志文件轮转。间隔必须至少为 1s。1m、1h、24h、7*24h、30*24h 和 365*24h 的值与本地系统时钟报告的分钟、小时、天、周、月和年对齐。所有其他间隔均从 Unix 纪元开始计算。默认为禁用。
logging.files.rotateonstartup如果日志文件在启动时已存在，则立即轮转该文件并开始写入新文件，而不是追加到现有文件。默认为 true。
logging.files.redirect_stderr [预览] 此功能处于技术预览阶段，可能会在未来的版本中更改或删除。Elastic 将努力修复任何问题，但技术预览中的功能不受官方 GA 功能的支持 SLA 约束。 为 true 时，打印到 APM Server 标准错误输出的诊断消息也会记录到日志文件中。这在 APM Server 意外终止的情况下非常有用，因为 Go 运行时检测到了错误，但日志文件中没有诊断信息。此功能仅在写入文件时可用（logging.to_files 为 true）。默认情况下禁用。
日志格式
编辑日志格式对于每个日志输出通常是相同的。一个例外是 syslog 输出，其中时间戳不包含在消息中，因为 syslog 会添加自己的时间戳。
每条日志消息由以下部分组成
- ISO8601 格式的时间戳
- 级别
- 括号中包含的记录器名称（可选）
- 调用者的文件名和行号
- 消息
- 以 JSON 编码的结构化数据（可选）
以下是一些示例
2017-12-17T18:54:16.241-0500 INFO logp/core_test.go:13 未命名的全局记录器
2017-12-17T18:54:16.242-0500 INFO [example] logp/core_test.go:16 一些消息
2017-12-17T18:54:16.242-0500 INFO [example] logp/core_test.go:19 一些消息 {"x": 1}