pmlogger_merge - 云端在线

程序：

您的姓名

pmlogger_check, pmlogger_daily, pmlogger_merge - Performance Co-Pilot的管理
归档日志文件

概要

$PCP_BINADM_DIR/pmlogger_check [-CNTV[-c 控制[-l 日志文件]
$PCP_BINADM_DIR/pmlogger_daily [-NorV[-c 控制[-k 丢弃[-l 日志文件[-m
地址[-s 尺寸[-t 想[-x 压缩[-X 程序[-Y 正则表达式]
$PCP_BINADM_DIR/pmlogger_merge [-fNV[输入基名称 ... 输出名称]

商品描述

这一系列的 shell 脚本和相关的控制文件可以用来创建一个
Performance Co-Pilot 的定制行政和管理制度（请参阅
个人电脑Pintro(1)) 归档日志文件。

pmlogger_daily 打算每天运行一次，最好是在清晨，因为
尽可能在午夜过后不久。 它的任务是聚合和旋转一组或多组
PCP 档案。 一段时间后，旧的 PCP 档案将被丢弃。 本期为 14
天数默认情况下，但可以使用更改 -k 选项。 识别两个特殊值
该期间 （丢弃），即 0 不保留当前档案以外的档案，以及 永远
以防止任何档案被丢弃。

存档数据文件可以选择在一段时间后压缩以节省磁盘空间。
这对于大量的 记录器 控制下的进程
pmlogger_check. 默认情况下不进行压缩。 这 -x 选项启用压缩和
指定压缩存档数据文件的天数，以及 -X 选项
指定用于压缩的程序 - 默认情况下这是 xz(1). 使用 -Y
选项允许指定正则表达式导致文件集中的文件
匹配省略压缩 - 这仅允许压缩数据文件，
并且还可以防止程序尝试多次压缩它。 默认的
正则表达式 是“.(meta|index|Z|gz|bz2|zip|xz|lzma|lzo|lz4)$” - 使用
-v 选项 埃格雷普（1）。

为了适应 PMDA 的发展和生产日志环境的变化，
pmlogger_daily 与...整合 pmlog重写(1) 允许可选和自动
在合并之前重写档案。 如果有要应用的全局重写规则
跨越控制文件中提到的所有档案，然后创建目录
$PCP_SYSCONF_DIR/pmlogrewrite 并放置任何 pmlog重写(1) 在此重写规则
目录。 要重写特定于一类档案的规则，请使用
控制文件中的目录名 - 即 第四 字段 - 并创建一个文件，或
目录，或名为的符号链接 pmlog重写 在此目录中并将
要求的重写规则 pmlog重写 文件或文件中的 pmlog重写
子目录。 pmlogger_daily 将从存档目录中选择重写规则，如果
它们存在，否则重写规则 $PCP_SYSCONF_DIR/pmlogrewrite 如果那个目录
存在，否则不尝试重写。

这款 -r 命令行选项充当覆盖并防止所有存档重写
pmlog重写(1) 独立于任何重写规则文件或目录的存在。

默认情况下，所有可能的档案都将被合并。 这 -o 选项恢复旧的
仅将昨天的档案视为合并候选者的行为。

在只需要合并单个输入存档的特殊情况下， 时间日志MV（1）是
用于重命名存档，而不是使用复制输入存档 pmlogger_merge.

这款 -M 选项可用于禁用存档合并（或重命名）和重写（-M
暗示 -r）。 这在归档增量的情况下最有用
复制到远程存储库，例如使用 rsync的(1). 合并、重命名和重写所有
同步负载增加的风险，尤其是在 pmlogger_daily
已经运行，所以 -M 在这些情况下可能有用。

为了帮助调试或诊断间歇性故障， -t 可以使用选项。
这将打开非常详细的跟踪（-VV) 并在名为的文件中捕获跟踪输出
$PCP_LOG_DIR/pmlogger/每天。日期戳。痕迹， 哪里 日期戳 是时候了 pmlogger_daily
以 YYYYMMDD.HH.MM 格式运行。 除此之外 想 论证将确保
使用创建的跟踪文件 -t 将被保留 想 天然后丢弃。

此外，如果 PCP 的“通知”文件（$PCP_LOG_DIR/通知) 大于 20480
字节， pmlogger_daily 将使用“.old”后缀重命名文件，并开始一个新的
“通知”文件。 旋转阈值可能会从 20480 更改为 尺寸 字节使用
-s 选项。

使用 -m 选择原因 pmlogger_daily 构建“通知”文件的摘要
过去 24 小时内生成的条目，并将该摘要通过电子邮件发送到一组
空格分隔 地址. 此每日摘要存储在文件中
$PCP_LOG_DIR/NOTICES.daily, 当没有新的“通知”条目时，它将为空
在过去的 24 小时内。

剧本 $PCP_BINADM_DIR/pmlogger_daily 可以复制和修改以实现
用于一组 PCP 的周末和/或月末管理的站点特定程序
档案。

pmlogger_check 可以随时运行，旨在检查所需的一组
记录器(1) 进程正在运行，如果没有重新启动任何失败的记录器。 使用
-s 选项提供反向功能，允许设置 记录器 过程
干净地关机。 使用 -C option 查询系统服务运行级别信息
记录器，并使用它来确定是启动还是停止进程。

这款 -T 选项提供了一种更简洁的输出形式 pmlogger_check 那是最合适的
查阅 记录器 “农场”，其中有许多实例 记录器 预计会运行。

pmlogger_merge 是一个包装脚本 提取物(1) 合并所有归档日志
匹配 输入基名称 参数，并使用创建一个新的存档 输出名称 作为
构成归档日志的物理文件的基本名称。 这 输入基名称
参数可能包含样式为的元字符 sh(1). 如果指定，则 -f 选项
创建输出存档后，将删除所有输入文件。

pmlogger_merge 由...使用 pmlogger_daily.

以上皆是 pmlogger_daily 和 pmlogger_check 由 PCP 记录器控制文件控制
指定 记录器 要管理的实例。 默认控制文件是
$PCP_PMLOGGERCONTROL_PATH，但可以使用 -c 选项。 如果
目录 $PCP_PMLOGGERCONTROL_PATH.d（或 控制.d 来自 -c 选项）存在，那么
其中任何附加控制文件的内容将附加到主控制文件
（必须存在）。

警告： $PCP_PMLOGGERCONTROL_PATH 和 $PCP_PMLOGGERCONTROL_PATH.d 文件不能是
可由除 root 之外的任何用户写入。

控制文件应该根据以下规则进行定制，这些规则定义了
控制文件格式的当前版本 (1.1)。

1. 以“#”开头的行是注释。
2. 假设以“$”开头的行是对环境变量的赋值
的风格 sh(1)，所有跟在``$'' 之后的文字都将是 评估由脚本编写
读取控制文件，并将相应的变量导出到
环境。 这对于将变量设置和导出到
管理脚本的环境，例如
$ PMCD_CONNECT_TIMEOUT=20
3.那里 必须 是表单的初始控制文件中的版本行：
$版本=1.1
4. 每个控制文件都应该有一行 记录器 的实例
形成：

主持人 y|n y|n 目录 ARGS

5. 控制文件一行内的字段通常由一个或多个分隔
空格或制表符（尽管请参阅 目录 一些领域
重要的例外）。
6. 第一 字段是作为性能指标来源的主机的名称
这 记录器 实例。
7. 第二 字段指示这是否是 小学 记录器 实例 （y） 或不 （n).
由于主记录器必须运行在本地主机上，并且最多可能有一个
特定主机的主记录器，该字段可以是 y 最多一个 记录器
例如，在这种情况下，主机名必须是本地主机的名称。
8. 第三 字段指示如果这 记录器 实例需要在
控制 袜子(1) 连接到一个 光驱 通过防火墙（y or n).
9. 第四 字段是目录名称。 与此相关的所有文件 记录器
实例将在此目录中创建，这将是当前目录
执行维护这些档案所需的任何程序。 一个有用的
约定是本地主机的主记录器存档与主机名 为myhost 旨在
在目录中维护 $PCP_LOG_DIR/pmlogger/为myhost （这是默认的
记录器 启动脚本在 $PCP_RC_DIR/pcp 将创建档案），而档案
对于远程主机 咕哝 维持在 $PCP_LOG_DIR/pmlogger/咕哝.
10. directory 字段可能包含嵌入式 shell 语法，这些语法将由 sh(1)
生成要使用的真实目录名称。 允许的构造是：
· 任何包含空格的文本（包括空格） $( 和 ).
· 任何包含空格的文本（包括空格） ` 和 ` （反引号）。
· 任何包含空格的文本（包括空格） " 和 " （双引号）。
· 任何包含 a 的单词 $ （假设引入了一个环境变量名称）。
11. 所有其他字段都被解释为要传递给的参数 记录器(1) 和/或
下午新日志(1). 最典型的是，这将是 -c 选项。

以下示例控制行指定本地主机上的主记录器 (笨蛋），
从主机收集和记录性能指标的非主要记录器 颤抖的 和
boing.

$版本=1.1
bozo yn $PCP_LOG_DIR/pmlogger/bozo -c config.default
wobbly nn "/store/wobbly/$(date +%Y)" -c ./wobbly.config
boing nn $PCP_LOG_DIR/pmlogger/boing -c ./pmlogger.config

Typical crontab中(5) 定期执行的条目 pmlogger_daily 和 pmlogger_check 旨在
给定的 $PCP_SYSCONF_DIR/pmlogger/crontab （除非默认安装在 /etc/cron.d
已经）并如下所示。

# 归档日志的日常处理
14 0 * * * $PCP_BINADM_DIR/pmlogger_daily
# 每 30 分钟，检查 pmlogger 实例是否正在运行
25,55 * * * * $PCP_BINADM_DIR/pmlogger_check

为了确保在运行这些脚本时不会无意中发送邮件
cron的(8) 诊断总是发送到日志文件。 默认情况下，这个文件是
$PCP_LOG_DIR/pmlogger/pmlogger_daily.log or $PCP_LOG_DIR/pmlogger/pmlogger_check.log 但是
这可以使用 -l 选项。 如果这个日志文件已经存在时脚本
开始，它将被重命名为 .prev 后缀（覆盖之前保存的任何日志文件）
在对日志文件生成诊断之前。 这 -l 和 -t 不能使用选项
在一起。

从输出 cron的 脚本的执行可以使用 -V 选项
将启用详细跟踪其活动的脚本。 默认情况下脚本
除非遇到某些错误或警告条件，否则不生成任何输出。

使用 onworks.net 服务在线使用 pmlogger_merge