Apache

·

Apache 采集器可以从 Apache 服务中采集请求数、连接数等，并将指标采集到观测云，帮助监控分析 Apache 各种异常情况。

配置¶

前置条件¶

Apache 版本 >= 2.4.6 (Unix)。已测试版本：
- 2.4.56
- 2.4.54
- 2.4.41
- 2.4.38
- 2.4.29
- 2.4.6
默认配置路径：
- /etc/apache2/apache2.conf
- /etc/apache2/httpd.conf
- /usr/local/apache2/conf/httpd.conf
开启 Apache mod_status，在 Apache 配置文件中添加：

<Location /server-status>
SetHandler server-status

Order Deny,Allow
Deny from all
Allow from [YOUR_IP]
</Location>

重启 Apache

$ sudo apachectl restart
...

采集器配置¶

主机安装Kubernetes

进入 DataKit 安装目录下的 conf.d/apache 目录，复制 apache.conf.sample 并命名为 apache.conf。示例如下：

[[inputs.apache]]
  url = "http://127.0.0.1/server-status?auto"
  # ##(optional) collection interval, default is 30s
  # interval = "30s"

  # username = ""
  # password = ""

  ## Optional TLS Config
  # tls_ca = "/xxx/ca.pem"
  # tls_cert = "/xxx/cert.cer"
  # tls_key = "/xxx/key.key"
  ## Use TLS but skip chain & host verification
  insecure_skip_verify = false

  ## Set true to enable election
  election = true

  # [inputs.apache.log]
  # files = []
  # #grok pipeline script path
  # pipeline = "apache.p"

  [inputs.apache.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

配置好后，重启 DataKit 即可。

目前可以通过 ConfigMap 方式注入采集器配置来开启采集器。

指标集¶

以下所有数据采集，默认会追加全局选举 tag，也可以在配置中通过 [inputs.apache.tags] 指定其它标签：

 [inputs.apache.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

`apache`¶

The collected metrics are affected by the environment in which Apache is installed. The metrics shown on the http://<your-apache-server>/server-status?auto page will prevail.

标签

Tag	Description
host	Hostname.
server_mpm	Apache server Multi-Processing Module, `prefork`, `worker` and `event`. Optional.
server_version	Apache server version. Optional.
url	Apache server status url.

指标列表

Metric	Description
busy_workers	The number of workers serving requests. Type: int Unit: count
closing_connection	The amount of workers that are currently closing a connection Type: int Unit: count
conns_async_closing	The number of asynchronous closing connections,windows not support Type: int Unit: count
conns_async_keep_alive	The number of asynchronous keep alive connections,windows not support Type: int Unit: count
conns_async_writing	The number of asynchronous writes connections,windows not support Type: int Unit: count
conns_total	The total number of requests performed,windows not support Type: int Unit: count
cpu_load	The percent of CPU used,windows not support. Optional. Type: float Unit: percent,percent
disabled	These slots will never be able to handle any requests, indicates a misconfiguration. Type: int Unit: count
dns_lookup	The workers waiting on a DNS lookup Type: int Unit: count
gracefully_finishing	The number of workers finishing their request Type: int Unit: count
idle_cleanup	These workers were idle and their process is being stopped Type: int Unit: count
idle_workers	The number of idle workers Type: int Unit: count
keepalive	The workers intended for a new request from the same client, because it asked to keep the connection alive Type: int Unit: count
logging	The workers writing something to the Apache logs Type: int Unit: count
max_workers	The maximum number of workers apache can start. Type: int Unit: count
net_bytes	The total number of bytes served. Type: int Unit: digital,B
net_hits	The total number of requests performed Type: int Unit: count
open_slot	The amount of workers that Apache can still start before hitting the maximum number of workers Type: int Unit: count
reading_request	The workers reading the incoming request Type: int Unit: count
sending_reply	The number of workers sending a reply/response or waiting on a script (like PHP) to finish so they can send a reply Type: int Unit: count
starting_up	The workers that are still starting up and not yet able to handle a request Type: int Unit: count
uptime	The amount of time the server has been running Type: int Unit: time,s
waiting_for_connection	The number of workers that can immediately process an incoming request Type: int Unit: count

`collector`¶

标签

Tag	Description
instance	Server addr of the instance
job	Server name of the instance

指标列表

Metric	Description
up	Type: int Unit: -

自定义对象¶

`web_server`¶

标签

Tag	Description
col_co_status	Current status of collector on instance(`OK/NotOK`)
host	The server host address
ip	Connection IP of the instance
name	Object uniq ID
reason	If status not ok, we'll get some reasons about the status

指标列表

Metric	Description
display_name	Displayed name in UI Type: string Unit: N/A
uptime	Current instance uptime Type: int Unit: time,s
version	Current version of the instance Type: string Unit: N/A

日志采集¶

如需采集 Apache 的日志，可在 apache.conf 中将 files 打开，并写入 Apache 日志文件的绝对路径。比如：

[[inputs.apache]]
  ...
  [inputs.apache.log]
    files = [
      "/var/log/apache2/error.log",
      "/var/log/apache2/access.log"
    ]

开启日志采集以后，默认会产生日志来源（source）为 apache 的日志。

Info

必须将 DataKit 安装在 Apache 所在主机才能采集 Apache 日志

Pipeline 字段说明¶

Apache 错误日志切割

错误日志文本示例：

[Tue May 19 18:39:45.272121 2021] [access_compat:error] [pid 9802] [client ::1:50547] AH01797: client denied by server configuration: /Library/WebServer/Documents/server-status

切割后的字段列表如下：

字段名	字段值	说明
`status`	`error`	日志等级
`pid`	`9802`	进程 id
`type`	`access_compat`	日志类型
`time`	`1621391985000000000`	纳秒时间戳（作为行协议时间）

Apache 访问日志切割

访问日志文本示例：

127.0.0.1 - - [17/May/2021:14:51:09 +0800] "GET /server-status?auto HTTP/1.1" 200 917

切割后的字段列表如下：

字段名	字段值	说明
`status`	`info`	日志等级
`ip_or_host`	`127.0.0.1`	请求方 IP 或者 host
`http_code`	`200`	http status code
`http_method`	`GET`	http 请求类型
`http_url`	`/`	http 请求 URL
`http_version`	`1.1`	http version
`time`	`1621205469000000000`	纳秒时间戳（作为行协议时间）