This is an automated email from the ASF dual-hosted git repository.
ddanielr pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/main by this push:
new bd5bdac89 Updated the Monitoring & Metrics page for 4.x (#498)
bd5bdac89 is described below
commit bd5bdac89fb8df5ee90ecfb5e823e32253f95fe9
Author: Dave Marion <[email protected]>
AuthorDate: Mon Oct 26 12:27:43 2026 -0400
Updated the Monitoring & Metrics page for 4.x (#498)
This change reverts the accumulo-monitor-1.png to its prior
state so that the 2.x docs have the correct image. Added new
images for the 4.x monitor, updated the links to those images,
and updated the content in the monitoring and metrics page
of the administration section in the 4.x user guide.
---
_docs-4/administration/monitoring-metrics.md | 35 +++++++++++----------------
_docs-4/getting-started/features.md | 4 +--
images/accumulo-monitor-1.png | Bin 92089 -> 215277 bytes
images/accumulo4-monitor-1.png | Bin 0 -> 91333 bytes
images/accumulo4-monitor-2.png | Bin 0 -> 103557 bytes
5 files changed, 16 insertions(+), 23 deletions(-)
diff --git a/_docs-4/administration/monitoring-metrics.md
b/_docs-4/administration/monitoring-metrics.md
index c8f63dd64..c02937630 100644
--- a/_docs-4/administration/monitoring-metrics.md
+++ b/_docs-4/administration/monitoring-metrics.md
@@ -14,40 +14,33 @@ The monitor can be viewed at:
* [http://localhost:9995](http://localhost:9995) - if Accumulo is running
locally (for development)
* `http://<MONITOR_HOST>:9995/` - if Accumulo is running on a cluster
-The Overview page (shown below) contains some summary information about the
Accumulo instance and graphs
-displaying various metrics over time. These include ingest and scan
performance and other useful measurements.
+The Overview page (shown below) contains some summary information about the
Accumulo instance deployment and
+instance, ingest, scan and compaction metrics.
-<a class="p-3 border rounded d-block" href="{{ site.baseurl
}}/images/accumulo-monitor-1.png">
-<img src="{{ site.baseurl }}/images/accumulo-monitor-1.png" class="img-fluid
rounded" alt="monitor overview"/>
+<a class="p-3 border rounded d-block" href="{{ site.baseurl
}}/images/accumulo4-monitor-1.png">
+<img src="{{ site.baseurl }}/images/accumulo4-monitor-1.png" class="img-fluid
rounded" alt="monitor overview"/>
</a>
-The Manager Server, Tablet Servers, and Tables pages display metrics grouped
in different ways (e.g. by tablet server or by table).
-Metrics typically include number of entries (key/value pairs), ingest and
query rates.
-The number of running scans, major and minor compactions are in the form
_number_running_ (_number_queued_).
-Another important metric is hold time, which is the amount of time a tablet
has been waiting but unable to flush its memory in a minor compaction.
+The Monitor pages under the Servers menu display metrics for the server
processes. The metrics are grouped into
+separate tables where it makes sense to do so. Below is an example of the
Managers page. The other pages under
+the Server menu have a similar design.
-<a class="p-3 border rounded d-block" href="{{ site.baseurl
}}/images/accumulo-monitor-2.png">
-<img src="{{ site.baseurl }}/images/accumulo-monitor-2.png" class="img-fluid
rounded" alt="monitor manager"/>
+<a class="p-3 border rounded d-block" href="{{ site.baseurl
}}/images/accumulo4-monitor-2.png">
+<img src="{{ site.baseurl }}/images/accumulo4-monitor-2.png" class="img-fluid
rounded" alt="monitor manager"/>
</a>
-The Server Activity page graphically displays tablet server status, with each
server represented as a circle or square.
-Different metrics may be assigned to the nodes' color and speed of oscillation.
-The Overall Avg metric is only used on the Server Activity page, and
represents the average of all the other metrics (after normalization).
-Similarly, the Overall Max metric picks the metric with the maximum normalized
value.
+The Tables Monitor page shows summary information for each table. Clicking on
the link for a table will
+take you to a page that shows more detailed information about that table.
-The Garbage Collector page displays a list of garbage collection cycles, the
number of files found of each type (including deletion candidates in use and
files actually deleted), and the length of the deletion cycle.
-The Traces page displays data for recent traces performed (see the following
section for information on [tracing][tracing]).
-The Recent Logs page displays warning and error logs forwarded to the monitor
from all Accumulo processes.
-Also, the XML and JSON links provide metrics in XML and JSON formats,
respectively.
+The Activity drop-down has pages for Compaction, FaTE, Scan, and Tablet
Recovery activity.
+The Alerts page contains messages about the state of the instance. There are
toggles in the settings
+menu to show or hide the different alert priorities and categories.
The Accumulo monitor does a best-effort to not display any sensitive
information to users; however,
the monitor is intended to be a tool used with care. It is not a
production-grade webservice. It is
a good idea to whitelist access to the monitor via an authentication proxy or
firewall. It
is strongly recommended that the Monitor is not exposed to any
publicly-accessible networks.
-Things highlighted in yellow may be in need of attention.
-If anything is highlighted in red on the monitor page, it is something that
definitely needs attention.
-
### SSL
SSL may be enabled for the monitor page by setting the following properties in
the `accumulo.properties` file:
diff --git a/_docs-4/getting-started/features.md
b/_docs-4/getting-started/features.md
index 68ca28493..4ce0e167c 100644
--- a/_docs-4/getting-started/features.md
+++ b/_docs-4/getting-started/features.md
@@ -318,8 +318,8 @@ The [Accumulo Monitor][monitor] provides basic information
about the system heal
performance. It displays information about the server processes, table sizes,
ingest,
query and compaction statistics, FaTE and recovery information, and
last-update information.
-<a class="p-3 border rounded d-block" href="/images/accumulo-monitor-1.png">
-<img src="/images/accumulo-monitor-1.png" class="img-fluid rounded"
alt="monitor overview"/>
+<a class="p-3 border rounded d-block" href="/images/accumulo4-monitor-1.png">
+<img src="/images/accumulo4-monitor-1.png" class="img-fluid rounded"
alt="monitor overview"/>
</a>
### Tracing
diff --git a/images/accumulo-monitor-1.png b/images/accumulo-monitor-1.png
index 6a83f3f25..c6a711a49 100644
Binary files a/images/accumulo-monitor-1.png and
b/images/accumulo-monitor-1.png differ
diff --git a/images/accumulo4-monitor-1.png b/images/accumulo4-monitor-1.png
new file mode 100644
index 000000000..25d6a18e4
Binary files /dev/null and b/images/accumulo4-monitor-1.png differ
diff --git a/images/accumulo4-monitor-2.png b/images/accumulo4-monitor-2.png
new file mode 100644
index 000000000..835bfb93b
Binary files /dev/null and b/images/accumulo4-monitor-2.png differ