mod_status.c revision d69e1ed15b5db3d832c1f6c8c403ef397248857a
842ae4bd224140319ae7feec1872b93dfd491143fielding/* Licensed to the Apache Software Foundation (ASF) under one or more
842ae4bd224140319ae7feec1872b93dfd491143fielding * contributor license agreements. See the NOTICE file distributed with
842ae4bd224140319ae7feec1872b93dfd491143fielding * this work for additional information regarding copyright ownership.
842ae4bd224140319ae7feec1872b93dfd491143fielding * The ASF licenses this file to You under the Apache License, Version 2.0
842ae4bd224140319ae7feec1872b93dfd491143fielding * (the "License"); you may not use this file except in compliance with
842ae4bd224140319ae7feec1872b93dfd491143fielding * the License. You may obtain a copy of the License at
04891cf70e0bfc38bfb027541dc821f04c754ff7nd * Unless required by applicable law or agreed to in writing, software
04891cf70e0bfc38bfb027541dc821f04c754ff7nd * distributed under the License is distributed on an "AS IS" BASIS,
04891cf70e0bfc38bfb027541dc821f04c754ff7nd * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
04891cf70e0bfc38bfb027541dc821f04c754ff7nd * See the License for the specific language governing permissions and
04891cf70e0bfc38bfb027541dc821f04c754ff7nd * limitations under the License.
3568de757bac0b47256647504c186d17ca272f85rbb/* Status Module. Display lots of internal data about how Apache is
3568de757bac0b47256647504c186d17ca272f85rbb * performing and the state of all children processes.
3568de757bac0b47256647504c186d17ca272f85rbb * To enable this, add the following lines into any config file:
3568de757bac0b47256647504c186d17ca272f85rbb * <Location /server-status>
3568de757bac0b47256647504c186d17ca272f85rbb * SetHandler server-status
3568de757bac0b47256647504c186d17ca272f85rbb * </Location>
3568de757bac0b47256647504c186d17ca272f85rbb * You may want to protect this location by password or domain so no one
3568de757bac0b47256647504c186d17ca272f85rbb * else can look at it. Then you can access the statistics with a URL like:
3568de757bac0b47256647504c186d17ca272f85rbb * /server-status - Returns page using tables
3568de757bac0b47256647504c186d17ca272f85rbb * /server-status?notable - Returns page for browsers without table support
3568de757bac0b47256647504c186d17ca272f85rbb * /server-status?refresh - Returns page with 1 second refresh
3568de757bac0b47256647504c186d17ca272f85rbb * /server-status?refresh=6 - Returns page with refresh every 6 seconds
3568de757bac0b47256647504c186d17ca272f85rbb * /server-status?auto - Returns page with data for automatic parsing
3568de757bac0b47256647504c186d17ca272f85rbb * Mark Cox, mark@ukweb.com, November 1995
3568de757bac0b47256647504c186d17ca272f85rbb * 12.11.95 Initial version for www.telescope.org
3568de757bac0b47256647504c186d17ca272f85rbb * 13.3.96 Updated to remove rprintf's [Mark]
3568de757bac0b47256647504c186d17ca272f85rbb * 18.3.96 Added CPU usage, process information, and tidied [Ben Laurie]
3568de757bac0b47256647504c186d17ca272f85rbb * 18.3.96 Make extra Scoreboard variables #definable
3568de757bac0b47256647504c186d17ca272f85rbb * 25.3.96 Make short report have full precision [Ben Laurie suggested]
3568de757bac0b47256647504c186d17ca272f85rbb * 25.3.96 Show uptime better [Mark/Ben Laurie]
3568de757bac0b47256647504c186d17ca272f85rbb * 29.3.96 Better HTML and explanation [Mark/Rob Hartill suggested]
3568de757bac0b47256647504c186d17ca272f85rbb * 09.4.96 Added message for non-STATUS compiled version
3568de757bac0b47256647504c186d17ca272f85rbb * 18.4.96 Added per child and per slot counters [Jim Jagielski]
3568de757bac0b47256647504c186d17ca272f85rbb * 01.5.96 Table format, cleanup, even more spiffy data [Chuck Murcko/Jim J.]
3568de757bac0b47256647504c186d17ca272f85rbb * 18.5.96 Adapted to use new rprintf() routine, incidentally fixing a missing
3568de757bac0b47256647504c186d17ca272f85rbb * piece in short reports [Ben Laurie]
3568de757bac0b47256647504c186d17ca272f85rbb * 21.5.96 Additional Status codes (DNS and LOGGING only enabled if
3568de757bac0b47256647504c186d17ca272f85rbb * extended STATUS is enabled) [George Burgyan/Jim J.]
3568de757bac0b47256647504c186d17ca272f85rbb * 10.8.98 Allow for extended status info at runtime (no more STATUS)
3568de757bac0b47256647504c186d17ca272f85rbb * [Jim J.]
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding#define DEFAULT_TIME_FORMAT "%A, %d-%b-%Y %H:%M:%S %Z"
b6e310e482c42cc323a28fa6fec653e11e0552e5jortonstatic int server_limit, thread_limit, threads_per_child, max_servers;
98fb535f829e2a95aabd82420931f476661fa8e3jorton/* Implement 'ap_run_status_hook'. */
f0e395a55abfcad3d2bd7c63470003b08a93d567ndAPR_IMPLEMENT_OPTIONAL_HOOK_RUN_ALL(ap, STATUS, int, status_hook,
7cd5419264796cfeaf8215383cf0f89130a81fectrawick/* ugh... need to know if we're running with a pthread implementation
7cd5419264796cfeaf8215383cf0f89130a81fectrawick * such as linuxthreads that treats individual threads as distinct
7cd5419264796cfeaf8215383cf0f89130a81fectrawick * processes; that affects how we add up CPU time in a process
3568de757bac0b47256647504c186d17ca272f85rbb/* Format the number of bytes nicely */
41634f717c623556a16b27b25d7d909a66fe20f8wrowestatic void format_byte_out(request_rec *r, apr_off_t bytes)
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "%.1f kB", (float) bytes / KBYTE);
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "%.1f MB", (float) bytes / MBYTE);
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "%.1f GB", (float) bytes / GBYTE);
41634f717c623556a16b27b25d7d909a66fe20f8wrowestatic void format_kbyte_out(request_rec *r, apr_off_t kbytes)
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "%.1f MB", (float) kbytes / KBYTE);
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "%.1f GB", (float) kbytes / MBYTE);
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantzstatic void show_time(request_rec *r, apr_interval_time_t tsecs)
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, " %d day%s", days, days == 1 ? "" : "s");
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, " %d hour%s", hrs, hrs == 1 ? "" : "s");
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, " %d minute%s", mins, mins == 1 ? "" : "s");
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, " %d second%s", secs, secs == 1 ? "" : "s");
3568de757bac0b47256647504c186d17ca272f85rbb/* Main handler for x-httpd-status requests */
3568de757bac0b47256647504c186d17ca272f85rbb/* ID values for command table */
3568de757bac0b47256647504c186d17ca272f85rbb const char *form_data_str;
3568de757bac0b47256647504c186d17ca272f85rbb const char *hdr_out_str;
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantzstatic const struct stat_opt status_options[] = /* see #defines above */
3568de757bac0b47256647504c186d17ca272f85rbb/* add another state for slots above the MaxClients setting */
6653a33e820463abd4f81915b7a1eba0f602e200brianp const char *loc;
3568de757bac0b47256647504c186d17ca272f85rbb unsigned long count;
ca53a74f4012a45cbad48e940eddf27d866981f9dougm if (strcmp(r->handler, STATUS_MAGIC_TYPE) && strcmp(r->handler,
d90b36a9e6f6ea9a583694f4db5e5edd54a750b3minfrin "server-status")) {
3568de757bac0b47256647504c186d17ca272f85rbb pid_buffer = apr_palloc(r->pool, server_limit * sizeof(pid_t));
3568de757bac0b47256647504c186d17ca272f85rbb stat_buffer = apr_palloc(r->pool, server_limit * thread_limit * sizeof(char));
48d2edbfb84e5559b5da0f8d614ccab805cc67a8rbb "Server status unavailable in inetd mode");
3568de757bac0b47256647504c186d17ca272f85rbb ap_set_content_type(r, "text/html; charset=ISO-8859-1");
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard * Simple table-driven form data set parser that lets you alter the header
9f979f5c8061f6f6f560d1824e0e378ff5b91931rpluem apr_size_t len = strlen(status_options[i].form_data_str);
9f979f5c8061f6f6f560d1824e0e378ff5b91931rpluem long t = 0;
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard ap_set_content_type(r, "text/plain; charset=ISO-8859-1");
7cd5419264796cfeaf8215383cf0f89130a81fectrawick for (i = 0; i < server_limit; ++i) {
98cd3186185bb28ae6c95a3f159899fcf56a663ftrawick clock_t proc_tu = 0, proc_ts = 0, proc_tcu = 0, proc_tcs = 0;
64c351fd973428b5bb4c28e983fa86875ea4e60fdougm for (j = 0; j < thread_limit; ++j) {
64c351fd973428b5bb4c28e983fa86875ea4e60fdougm ws_record = ap_get_scoreboard_worker_from_indexes(i, j);
7cd5419264796cfeaf8215383cf0f89130a81fectrawick /* XXX what about the counters for quiescing/seg faulted
7cd5419264796cfeaf8215383cf0f89130a81fectrawick * processes? should they be counted or not? GLA
7cd5419264796cfeaf8215383cf0f89130a81fectrawick if (lres != 0 || (res != SERVER_READY && res != SERVER_DEAD)) {
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard#endif /* HAVE_TIMES */
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard /* up_time in seconds */
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz "<html><head>\n<title>Apache Status</title>\n</head><body>\n",
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rvputs(r, ap_get_server_name(r), " (via ", r->connection->local_ip,
dd028aa8111afb6534fece555e8c2d408894671etrawick ap_get_server_built(), "\n</dt></dl><hr /><dl>\n", NULL);
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard ap_ht_time(r->pool, nowtime, DEFAULT_TIME_FORMAT, 0),
f714f1a7002928d785e53e70349700a7f595fee3trawick ap_rprintf(r, "<dt>Parent Server Config. Generation: %d</dt>\n",
3568de757bac0b47256647504c186d17ca272f85rbb ap_rprintf(r, "<dt>Parent Server MPM Generation: %d</dt>\n",
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard /* Allow for OS/2 not having CPU stats */
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "Uptime: %ld\n", (long) (up_time));
4a13940dc2990df0a798718d3a3f9cf1566c2217bjh else { /* !short_report */
3568de757bac0b47256647504c186d17ca272f85rbb ap_rprintf(r, "<dt>Total accesses: %lu - Total Traffic: ", count);
3568de757bac0b47256647504c186d17ca272f85rbb /* Allow for OS/2 not having CPU stats */
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "<dt>CPU Usage: u%g s%g cu%g cs%g",
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz format_byte_out(r, (unsigned long)(KBYTE * (float) kbcount
3568de757bac0b47256647504c186d17ca272f85rbb format_byte_out(r, (unsigned long)(KBYTE * (float) kbcount
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard / (float) count));
3568de757bac0b47256647504c186d17ca272f85rbb } /* short_report */
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard } /* ap_extended_status */
cd8f8c995d415473f3bfb0b329b2450f2a722c3atrawick ap_rprintf(r, "<dt>%d requests currently being processed, "
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "BusyWorkers: %d\nIdleWorkers: %d\n", busy, ready);
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard /* send the scoreboard 'table' out */
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard for (i = 0; i < server_limit; ++i) {
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard for (j = 0; j < thread_limit; ++j) {
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard if (stat_buffer[indx] != status_flags[SERVER_DISABLED]) {
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard if ((written % STATUS_MAXLINE == (STATUS_MAXLINE - 1))
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard ap_rputs("\"<b><code>_</code></b>\" Waiting for Connection, \n", r);
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard ap_rputs("\"<b><code>S</code></b>\" Starting up, \n", r);
cd8f8c995d415473f3bfb0b329b2450f2a722c3atrawick ap_rputs("\"<b><code>R</code></b>\" Reading Request,<br />\n", r);
cd8f8c995d415473f3bfb0b329b2450f2a722c3atrawick ap_rputs("\"<b><code>W</code></b>\" Sending Reply, \n", r);
3568de757bac0b47256647504c186d17ca272f85rbb ap_rputs("\"<b><code>K</code></b>\" Keepalive (read), \n", r);
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard ap_rputs("\"<b><code>D</code></b>\" DNS Lookup,<br />\n", r);
cb97ae2ff6969c2789b8e03f1bc4187fa73b6bafwrowe ap_rputs("\"<b><code>C</code></b>\" Closing connection, \n", r);
0f113d7123e8bd3e3e2e9b6373461a1a773bfccatrawick ap_rputs("\"<b><code>L</code></b>\" Logging, \n", r);
0f113d7123e8bd3e3e2e9b6373461a1a773bfccatrawick ap_rputs("\"<b><code>G</code></b>\" Gracefully finishing,<br /> \n", r);
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rputs("\"<b><code>I</code></b>\" Idle cleanup of worker, \n", r);
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard ap_rputs("\"<b><code>.</code></b>\" Open slot with no current process,<br />\n", r);
c0659e61002e9d6ff77b2dca72540e0af1b2ca64stoddard for (i = 0; i < server_limit; ++i) {
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz for (j = 0; j < thread_limit; ++j) {
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick if (++k >= 3) {
64c351fd973428b5bb4c28e983fa86875ea4e60fdougm "<th>Srv</th><th>PID</th><th>Acc</th>"
2e7f1d7da527c09e717251e186deffe55e6fbd0ftrawick "<th>M</th>"
2e7f1d7da527c09e717251e186deffe55e6fbd0ftrawick "<th>CPU\n</th>"
3568de757bac0b47256647504c186d17ca272f85rbb "<th>SS</th><th>Req</th>"
64c351fd973428b5bb4c28e983fa86875ea4e60fdougm "<th>Conn</th><th>Child</th><th>Slot</th>"
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz "<th>Client</th><th>VHost</th>"
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz "<th>Request</th></tr>\n\n", r);
e8f95a682820a599fe41b22977010636be5c2717jim for (i = 0; i < server_limit; ++i) {
64c351fd973428b5bb4c28e983fa86875ea4e60fdougm for (j = 0; j < thread_limit; ++j) {
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ws_record = ap_get_scoreboard_worker_from_indexes(i, j);
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick if (ws_record->pid) { /* MPM sets per-worker pid and generation */
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "<b>Server %d-%d</b> (-): %d|%lu|%lu [",
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "<b>Server %d-%d</b> (%"
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "u%g s%g cu%g cs%g"
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "\n %ld %ld (",
f886987cd0bd4220c14043c4d9be77ec22902e73trawick " <i>%s {%s}</i> <b>[%s]</b><br />\n\n",
64c351fd973428b5bb4c28e983fa86875ea4e60fdougm else { /* !no_table_report */
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "<tr><td><b>%d-%d</b></td><td>-</td><td>%d/%lu/%lu",
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "<tr><td><b>%d-%d</b></td><td>%"
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick "</td><td>%d/%lu/%lu",
e8f95a682820a599fe41b22977010636be5c2717jim "<td>%.2f</td>"
44d2e75323651320b480d8bc2f098448a08de4fcwrowe "<td>%ld</td><td>%ld",
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz ap_rprintf(r, "</td><td>%-1.1f</td><td>%-2.2f</td><td>%-2.2f\n",
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick (float)conn_bytes / KBYTE, (float) my_bytes / MBYTE,
1ec8bd0373f11c07688ec9afbbf778cf78a0bc52wrowe "<td nowrap>%s</td></tr>\n\n",
f886987cd0bd4220c14043c4d9be77ec22902e73trawick } /* no_table_report */
f886987cd0bd4220c14043c4d9be77ec22902e73trawick } /* for (j...) */
1ec8bd0373f11c07688ec9afbbf778cf78a0bc52wrowe } /* for (i...) */
8bfe865d8d61be4ba4a89e45427a3c4211ebabdctrawick<tr><th>Srv</th><td>Child Server number - generation</td></tr>\n \
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz<tr><th>PID</th><td>OS process ID</td></tr>\n \
3568de757bac0b47256647504c186d17ca272f85rbb<tr><th>Acc</th><td>Number of accesses this connection / this child / this slot</td></tr>\n \
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz<tr><th>M</th><td>Mode of operation</td></tr>\n"
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz"<tr><th>CPU</th><td>CPU usage, number of seconds</td></tr>\n"
3568de757bac0b47256647504c186d17ca272f85rbb"<tr><th>SS</th><td>Seconds since beginning of most recent request</td></tr>\n \
98fb535f829e2a95aabd82420931f476661fa8e3jorton<tr><th>Req</th><td>Milliseconds required to process most recent request</td></tr>\n \
98fb535f829e2a95aabd82420931f476661fa8e3jorton<tr><th>Conn</th><td>Kilobytes transferred this connection</td></tr>\n \
e8f95a682820a599fe41b22977010636be5c2717jim<tr><th>Child</th><td>Megabytes transferred this child</td></tr>\n \
e8f95a682820a599fe41b22977010636be5c2717jim<tr><th>Slot</th><td>Total megabytes transferred this slot</td></tr>\n \
98fb535f829e2a95aabd82420931f476661fa8e3jorton</table>\n", r);
e8f95a682820a599fe41b22977010636be5c2717jim } /* if (ap_extended_status && !short_report) */
3568de757bac0b47256647504c186d17ca272f85rbb ap_rputs("<hr />To obtain a full report with current status "
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz "information you need to use the "
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantz "<code>ExtendedStatus On</code> directive.\n", r);
0f081398cf0eef8cc7c66a535d450110a92dc8aefielding /* Run extension hooks to insert extra content. */
3568de757bac0b47256647504c186d17ca272f85rbbstatic int status_pre_config(apr_pool_t *p, apr_pool_t *plog, apr_pool_t *ptemp)
3568de757bac0b47256647504c186d17ca272f85rbb /* When mod_status is loaded, default our ExtendedStatus to 'on'
3568de757bac0b47256647504c186d17ca272f85rbb * other modules which prefer verbose scoreboards may play a similar game.
3568de757bac0b47256647504c186d17ca272f85rbb * If left to their own requirements, mpm modules can make do with simple
3568de757bac0b47256647504c186d17ca272f85rbb * scoreboard entries.
9d0665da83d1e22c0ea0e5f6f940f70f75bf5237ianhstatic int status_init(apr_pool_t *p, apr_pool_t *plog, apr_pool_t *ptemp,
7cd5419264796cfeaf8215383cf0f89130a81fectrawick status_flags[SERVER_DEAD] = '.'; /* We don't want to assume these are in */
7cd5419264796cfeaf8215383cf0f89130a81fectrawick status_flags[SERVER_READY] = '_'; /* any particular order in scoreboard.h */
7cd5419264796cfeaf8215383cf0f89130a81fectrawick ap_mpm_query(AP_MPMQ_HARD_LIMIT_THREADS, &thread_limit);
7cd5419264796cfeaf8215383cf0f89130a81fectrawick ap_mpm_query(AP_MPMQ_HARD_LIMIT_DAEMONS, &server_limit);
7cd5419264796cfeaf8215383cf0f89130a81fectrawick ap_mpm_query(AP_MPMQ_MAX_THREADS, &threads_per_child);
ca53a74f4012a45cbad48e940eddf27d866981f9dougm /* work around buggy MPMs */
28c170ac8e99644de58cad454c6e0f9b4b359be6jerenkrantzstatic void status_child_init(apr_pool_t *p, server_rec *s)
#ifdef HAVE_TIMES