Apache

·

Apache collector can collect the number of requests, connections and others from Apache services, and collect indicators to TrueWatch to help monitor and analyze various abnormal situations of Apache.

Configuration¶

Preconditions¶

• Apache version >= 2.4.6 (Unix). Already tested version:

  • 2.4.56
  • 2.4.54
  • 2.4.41
  • 2.4.38
  • 2.4.29
  • 2.4.6

• Default configuration path:

  • /etc/apache2/apache2.conf
  • /etc/apache2/httpd.conf
  • /usr/local/apache2/conf/httpd.conf

• Open Apache mod_status and add the followings in Apache profile:

<Location /server-status>
SetHandler server-status

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

• Restart Apache

sudo apachectl restart

Collector Configuration¶

[[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"
  # ... 

Metric¶

For all of the following data collections, the global election tags will added automatically, we can add extra tags in [inputs.apache.tags] if needed:

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

apache¶

Apache HTTP Server metrics parsed from the machine-readable mod_status server-status?auto output. Available fields depend on Apache version, MPM, platform, and ExtendedStatus configuration.

collector¶

Shared collector availability metric emitted by multiple collectors to report whether the target was successfully scraped.

Custom Object¶

web_server¶

Apache web server instance inventory and collector status information emitted as a custom object.

Log Collection¶

To collect the Apache log, open files in apache.conf and write to the absolute path of the Apache log file. For example:

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

When log collection is turned on, logs with apache log (source) will be generated by default.

Log Pipeline Function Cut Field Description¶

• Apache Error Log Cutting

Error Log Text Example

[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

The list of cut fields is as follows:

• Apache Access Log Cutting

Example of access log text:

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

The list of cut fields is as follows: