pmdaweblog - 云端在线

程序：

您的姓名

pmda网志 - 用于 Web 服务器日志的性能指标域代理 (PMDA)

概要

$PCP_PMDAS_DIR/网络日志/pmdaweblog [-CP[-d 域[-h 帮助文件[-i 端口[-l 日志文件]
[-n 空闲秒[-S NUM[-t 延迟[-u 插座[-U 用户名] 配置文件

商品描述

pmda网志 是一个性能指标域代理（丙二醛(3)) 将 Web 服务器日志扫描到
提取表征 Web 服务器活动的指标。 然后这些性能指标是
通过 Performance Co-Pilot (PCP) 的基础设施提供。

- 配置文件 指定要监视的 Web 服务器、它们的关联访问
日志和错误日志，以及用于提取详细信息的基于正则表达式的方案
有关每次 Web 访问的信息。 该文件作为 PMDA 的一部分进行维护
通过脚本安装和/或卸载 安装 和 删除 在目录中
$PCP_PMDAS_DIR/博客. 有关更多详细信息，请参阅以下部分
安装。

一旦开始， pmda网志 监视一组日志文件并响应请求
信息，将处理已附加到日志文件的任何新信息，
类似于 尾巴(1). 还有定期“追赶”来处理来自
所有日志文件，以及检测日志文件轮换的方案。

像所有其他 PMDA 一样， pmda网志 由 光驱(1) 使用命令行选项
指定于 $PCP_PMCDCONF_PATH - 安装 脚本将提示输入适当的值
对于命令行选项，并更新 $PCP_PMCDCONF_PATH.

简要说明 pmda网志 命令行选项如下：

-C 检查配置并退出。

-d 域
指定 域 数字。 性能指标绝对至关重要
域 此处指定的数字是唯一且一致的。 那是， 域 应该
一台主机上的每个 PMDA 都不同，并且相同 域 应该使用数字
等加工。为 pmda网志 所有主机上的 PMDA。

对于大多数安装，默认 域 如封装在文件中
$PCP_PMDAS_DIR/weblog/domain.h 就足够了。 对于替代值，请检查
$PCP_PMCDCONF_PATH 等加工。为 域 此主机上已在使用的值，以及文件
$PCP_VAR_DIR/pmns/stdpmid 包含一个“众所周知”的存储库 域
可能应该避免的任务。

-h 帮助文件
从提供的帮助文本中获取 帮助文件 而不是从默认位置。

-i 端口
与交流 光驱(1) 在指定的 Internet 上 端口 （可能是一个数字或一个
姓名）。

-l 日志文件
日志文件的位置。 默认情况下，一个名为的日志文件 博客.log 被写成
当前目录 光驱(1) 当 pmda网志 开始了，即
$PCP_LOG_DIR/pmcd. 如果日志文件无法创建或不可写，则输出为
改为写入标准错误。

-n 空闲秒
如果未修改 Web 服务器日志文件 空闲秒 秒，然后是文件
将被关闭并重新开放。 这是唯一的方法 pmda网志 可以检测任何
通过 Web 服务器管理脚本异步轮换日志。 这
默认时间为 20 秒。 可以使用动态更改此值
下午店(1) 修改性能指标的值 网络配置检查.

-p 与交流 光驱(1) 通过管道。

-S NUM 指定每个 Web 服务器的最大数量 程序. 这可能是可取的（从
延迟和负载平衡角度）或必要的（由于文件描述符
限制）将扫描 Web 服务器日志文件的责任委托给几个
程序. pmda网志 将确保每个 程序 最多处理日志文件
NUM 网络服务器。 默认值为每台 80 个 Web 服务器 程序.

-t 延迟
避免需要从 Web 服务器日志中扫描大量信息作为响应
对于单个性能指标请求，至少会检查所有日志文件
每一次 延迟 秒。 默认值为 15 秒。 此值可能会更改
动态使用 下午店(1) 修改性能指标的值
web.config.catchup.

-u 插座
与交流 光驱(1) 通过给定的 Unix 域 插座.

-U 运行代理的用户帐户。 默认是无特权的“pcp”
当前版本的 PCP 中的帐户，但在旧版本中超级用户帐户
（“root”）默认使用。

安装

PCP 框架允许在一台主机上收集指标并从另一台主机进行监控。
这些主机被称为 集电极 和 监控 主机，分别。 主机可能是
既是收集器又是监视器。

收集器主机需要安装代理，而监控主机不需要
代理安装。

对于收集器主机，以 root 身份执行以下操作：

# cd $PCP_PMDAS_DIR/网络日志
＃ 。/安装

安装过程会提示默认安装或非默认安装。 默认
安装将搜索已知的服务器配置并自动配置
找到的任何服务器日志文件的 PMDA。 非默认安装将步骤
通过每个服务器，提示用户输入其他服务器配置和参数
pmda网志. 收集器安装的最终结果是构建一个配置文件
传递给 pmda网志 通过 配置文件 论据。

如果要撤消安装，请以 root 身份执行以下操作：

# cd $PCP_PMDAS_DIR/网络日志
＃ 。/消除

pmda网志 由 光驱(1) 并且永远不应该直接执行。 这 安装 和
删除 脚本通知 光驱(1) 安装或删除代理程序时。

配置

weblog PMDA 的配置文件是一个易于修改的 ASCII 文件。
空行和以 ' 开头的行#' 被忽略。 所有其他行必须是
正则表达式或服务器规范。

用于访问和错误日​​志文件的正则表达式必须是
形成：

正则表达式 正则表达式名称 正则表达式
or

正则表达式_posix 正则表达式名称 订购 正则表达式_posix

- 正则表达式名称 是唯一标识正则表达式的词。 这是
服务器规范中使用的参考。 这 正则表达式 访问日志的格式为
描述为 正则表达式（3）。 该 正则表达式_posix 访问日志的格式为
正则表达式(3). 论据 订购 解释如下。 这 POSIX 表格应该可用
在所有平台上。

正则表达式需要指定最多四个要提取的参数
从 Web 服务器访问日志的每一行，取决于服务器的类型。 在最
常见情况有两个参数表示方法和大小。

对于非 POSIX 版本，参数 $0 应该包含方法： 的GET, 校长 , 解决方案&帖子 or
PUT. 方法 PUT 被视为同义词 解决方案&帖子，其他任何东西都归类为
其他.

第二个论点， $1, 应包含请求的大小。 大小为``-'' 或 ' ''
被视为未知。

争论 $3 应该包含返回给客户端浏览器的状态代码和参数 $4
应该包含从远程主机返回到服务器的状态代码。 这些后者
两个参数用于缓存服务器并且必须指定为一对（或 $3 会
忽略）。 有关状态代码的更多信息，请参阅网站
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

一些合法的非 POSIX 用于监控访问日志的正则表达式规范是：

# CERN、NCSA、Netscape 等访问日志的模式
正则表达式 CERN ] "([A-Za-z][-A-Za-z]+)$0 .*" [-0-9]+ ([-0-9]+)$1

# FTP 服务器访问日志的模式（通常在 SYSLOG 中）
正则表达式 SYSLOG_FTP ftpd[.*]: ([gp][-A-Za-z]+)$0( )$1

有 1 种特殊类型的访问日志 正则表达式名称 乌贼。 这种格式提取 4
参数，但由于 乌贼 日志文件使用基于文本的状态代码，它作为
特例。

在下面的例子中， NS_PROXY 解析 Netscape/W3C 相当常见 扩展 历史记录 格式 和
鱿鱼 解析默认的 Squid 对象缓存格式日志文件。

# Netscape 代理服务器扩展日志的模式
正则表达式 NS_PROXY ] "([A-Za-z][-A-Za-z]+)$0 .*" ([-0-9]+)$2 \
([-0-9]+)$1 ([-0-9]+)$3

# Squid 缓存日志的模式
正则表达式鱿鱼 [0-9]+.[0-9]+[ ]+[0-9]+ [a-zA-Z0-9.]+ \
([_A-Z]+)$3([0-9]+)$2 ([0-9]+)$1 ([A-Z]+)$0

- 正则表达式 因为错误日志不需要任何参数，只需要匹配。 一些合法的
表达式是：

# CERN、NCSA、Netscape 等错误日志的模式
正则表达式 CERN_err 。

# FTP 服务器错误日志的模式（通常在 SYSLOG 中）
正则表达式 SYSLOG_FTP_err FTP 登录失败

If POSIX 使用了合规的正则表达式，因为需要额外的信息
不能在正则表达式中指定参数的顺序。 对于倒退
兼容性，两个参数的常见情况，命令可以指定为 方法，大小
or 尺寸，方法 在一般情况下，排序由以下之一指定
方法：

n1,n2,n3,n4
其中 nX 是 1 到 4 之间的数字。每个逗号分隔的字段表示（按顺序）
参数编号为 方法、大小、client_status、server_status

- 用于内容被忽略的错误日志等情况。

至于非 POSIX 格式 鱿鱼 RegexName 被视为特殊情况来匹配
非数字状态代码。

一些合法的 POSIX 用于监控访问日志的正则表达式规范是：

# CERN、NCSA、Netscape、Apache 等访问日志的模式
regex_posix CERN 方法，大小 ][ \]+"([A-Za-z][-A-Za-z]+) \
[^"]*" [-0-9]+ ([-0-9]+)

# CERN、NCSA、Netscape、Apache 等访问日志的模式
regex_posix CERN 1,2 ][ \]+"([A-Za-z][-A-Za-z]+) \
[^"]*" [-0-9]+ ([-0-9]+)

# FTP 服务器访问日志的模式（通常在 SYSLOG 中）
regex_posix SYSLOG_FTP 方法，大小 ftpd[.*]: \
([gp][-A-Za-z]+)( )

# Netscape 代理服务器扩展日志的模式
regex_posix NS_PROXY 1,3,2,4 ][ ]+"([A-Za-z][-A-Za-z]+) \
[^"]*" ([-0-9]+) ([-0-9]+) ([-0-9]+)

# Squid 缓存日志的模式
regex_posix SQUID 4,3,2,1 [0-9]+.[0-9]+[ ]+[0-9]+ \
[a-zA-Z0-9.]+ ([_A-Z]+)([0-9]+) ([0-9]+) ([AZ]+)

# CERN、NCSA、Netscape 等错误日志的模式
regex_posix CERN_err - 。

# FTP 服务器错误日志的模式（通常在 SYSLOG 中）
regex_posix SYSLOG_FTP_err - FTP 登录失败

可以使用以下语法指定 Web 服务器：

服务器 服务器名称 on|折扣 访问正则表达式 访问文件 错误正则表达式 错误文件

- 服务器名称 对于每个服务器必须是唯一的，并且是为实例赋予的名称
相关的性能指标。 看 PMAPI(3)对于PCP实例的讨论
域。 这 on or 折扣 标志指示在 PMDA 时是否要监视服务器
已安装。 这可以使用动态更改 下午店(1) 对于度量
web.perserver.watched, 中命名的每个 Web 服务器都有一个实例 配置文件.

为每个 Web 服务器监视两个文件，访问和错误日​​志。 每个文件
需要先前声明的正则表达式的名称和文件名。 日志
安装 weblog PMDA 时，为每个服务器指定的文件不必存在。
PMDA 将继续检查不存在的日志文件并在可能的情况下打开它们。
一些合法的服务器规范是：

# Netscape Server 在端口 80 上的 IP 地址为 127.55.555.555
服务器 127.55.555.555:80 在 CERN /logs/access CERN_err /logs/errors

# FTP 服务器。
SYSLOG_FTP 上的服务器 ftpd /var/log/messages SYSLOG_FTP_err /var/log/messages

洞穴

使用不正确数量的参数指定正则表达式，除了
2 用于访问日志，而没有用于错误日志，可能会导致 PMDA 行为不正确和
甚至崩溃。 这是由于接口的限制 正则表达式（3）。

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