libreoffice-online/wsd/metrics.txt
Michael Meeks 3a1deab1d4 Prometheus - log per-document details for getMetrics.
This should perform and still be reasonably compact even
for large numbers of documents.

Change-Id: I3820af6c23806d569c23a893bd8db040dfb351e8
Signed-off-by: Michael Meeks <michael.meeks@collabora.com>
2022-09-05 12:31:33 +01:00

185 lines
16 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Below is the description of the metrics returned by 'getMetrics' REST endpoint.
The general format of the output is complient with Prometheus text-based format
which can be found here: https://prometheus.io/docs/instrumenting/exposition_formats/#text-based-format
GLOBAL
global_host_system_memory_bytes - Total host system memory in bytes.
global_memory_available_bytes Memory available to our application in bytes. This is equal to global_host_system_memory_bytes * memproportion where memproportion represents the maximum percentage of system memory consumed by all of the Collabora Online, after which we start cleaning up idle documents. This parameter can be setup in coolwsd.xml.
global_memory_used_bytes Total memory usage: PSS(coolwsd) + RSS(forkit) + Private_Dirty(all assigned coolkits).
global_memory_free_bytes - global_memory_available_bytes - global_memory_used_bytes
COOLWSD
coolwsd_count number of running coolwsd processes.
coolwsd_thread_count number of threads in the current coolwsd process.
coolwsd_cpu_time_seconds the CPU usage by current coolwsd process.
coolwsd_memory_used_bytes the memory used by current coolwsd process: PSS(coolwsd).
FORKIT
forkit_process_count number of running forkit processes.
forkit_thread_count number of threads in the current forkit process.
forkit_cpu_time_seconds the CPU usage by the current forkit process.
forkit_memory_used_bytes - the memory used by the current forkit process: RSS(forkit).
KITS
kit_count total number of running kit processes.
kit_unassigned_count number of running kit processes that are not assigned to documents.
kit_assigned_count number of running kit processes that are assigned to documents (number of currently open documents).
kit_segfault_count - number of kit processes terminated with SIGSEGV or SIGBUS signals since the start of application.
kit_lost_terminated_count - number of kit processes that were lost by coolwsd and were terminated by cleanup mechanism.
kit_thread_count_total - total number of threads in all running kit processes.
kit_thread_count_average average number of threads per running kit process.
kit_thread_count_min - minimum from the number of threads in each running kit process.
kit_thread_count_max maximum from the number of threads in each running kit process.
kit_memory_used_total_bytes total Private_Dirty memory used by all running kit processes.
kit_memory_used_average_bytes average between the Private_Dirty memory used by each active kit process.
kit_memory_used_min_bytes minimum from the Private_Dirty memory used by each running kit process.
kit_memory_used_max_bytes - maximum from the Private_Dirty memory used by each running kit process.
kit_cpu_time_total_seconds total CPU time for all running kit processes.
kit_cpu_time_average_seconds average between the CPU time each running kit process used.
kit_cpu_time_min_seconds minimum from the CPU time each running kit process used.
kit_cpu_time_max_seconds - maximum from the CPU time each running kit process used.
RESOURCE CONSUMING DOCUMENTS (See config.per_document.cleanup section in coolwsd.xml)
document_resource_consuming_count - number of active documents that were detected as resource consuming.
document_resource_consuming_abort_started_count - number of resource consuming documents for which the termination process started (SIGABRT/SIGKILL signal was sent to the associated kit process) but they are still considered active by coolwsd. This is relevant because it shows how many resource consuming docs possibly could not be terminated or for which the termination process is too long.
document_resource_consuming_aborted_count - number of terminated resource consuming documents.
DOCUMENT VIEWS
document_all_views_all_count_total - total number of views (active or expired) of all documents (active and expired).
document_all_views_all_count_average average between the number of all views (active or expired) per document (active or expired).
document_all_views_all_count_min minimum from the number of all views (active or expired) of each document (active or expired).
document_all_views_all_count_max maximum from the number of all views (active or expired) of each document (active or expired).
document_active_views_all_count_total - total number of all views (active or expired) of active documents.
document_active_views_all_count_average average between the number of all views (active or expired) of each active document.
document_active_views_all_count_min minimum from the number of all views (active or expired) of each active document.
document_active_views_all_count_max maximum from the number of all views (active or expired) of each active document.
document_expired_views_all_count_total - total number of all views (active or expired) of expired documents.
document_expired_views_all_count_average average between the number of all views (active or expired) of each expired document.
document_expired_views_all_count_min minimum from the number of all views (active or expired) of each expired document.
document_expired_views_all_count_max maximum from the number of all views (active or expired) of each expired document.
document_active_views_active_count_total total number of active views of all active documents.
document_active_views_active_count_average average between the number of active views of each active document.
document_active_views_active_count_min minimum from the number of active views of each active document.
document_active_views_active_count_max maximum from the number of active views of each active document.
document_active_views_expired_count_total total number of expired views of all active documents.
document_active_views_expired_count_average average between the number of expired views of each active document.
document_active_views_expired_count_min minimum from the number of expired views of each active document.
document_active_views_expired_count_max maximum from the number of expired views of each active document.
DOCUMENT OPENED TIME
document_all_opened_time_total_seconds - sum of time each document (active or expired) was kept opened.
document_all_opened_time_average_seconds average between the time intervals each document (active or expired) was kept opened.
document_all_opened_time_min_seconds minimum from the time intervals each document (active or expired) was kept opened.
document_all_opened_time_max_seconds - maximum from the time intervals each document (active or expired) was kept opened.
document_active_opened_time_total_seconds - sum of time each active document was kept opened.
document_active_opened_time_average_seconds average between the time intervals each active document was kept opened.
document_active_opened_time_min_seconds - minimum from the time intervals each active document was kept opened.
document_active_opened_time_max_seconds - maximum from the time intervals each active document was kept opened.
document_expired_opened_time_total_seconds - sum of time each expired document was kept opened.
document_expired_opened_time_average_seconds average between the time intervals each expired document was kept opened.
document_expired_opened_time_min_seconds - minimum from the time intervals each expired document was kept opened.
document_expired_opened_time_max_seconds maximum from the time intervals each expired document was kept opened.
DOCUMENT BYTES SENT TO CLIENTS
document_all_sent_to_clients_total_bytes - total number of bytes sent to clients by all documents (active or expired).
document_all_sent_to_clients_average_bytes average between the number of bytes sent to clients by each document (active or expired).
document_all_sent_to_clients_min_bytes - minimum from the number of bytes sent to clients by each document (active or expired).
document_all_sent_to_clients_max_bytes - maximum from the number of bytes sent to clients by each document (active or expired).
document_active_sent_to_clients_total_bytes - total number of bytes sent to clients by active documents.
document_active_sent_to_clients_average_bytes - average between the number of bytes sent to clients by each active document.
document_active_sent_to_clients_min_bytes - minimum from the number of bytes sent to clients by each active document.
document_active_sent_to_clients_max_bytes - maximum from the number of bytes sent to clients by each active document.
document_expired_sent_to_clients_total_bytes - total number of bytes sent to clients by expired documents.
document_expired_sent_to_clients_average_bytes average between the number of bytes sent to clients by each expired document.
document_expired_sent_to_clients_min_bytes - minimum from the number of bytes sent to clients by each expired document.
document_expired_sent_to_clients_max_bytes - maximum from the number of bytes sent to clients by each expired document.
DOCUMENT BYTES RECEIVED FROM CLIENTS
document_all_received_from_clients_total_bytes - total number of bytes received from clients by all documents (active or expired).
document_all_received_from_clients_average_bytes average between the number of bytes received from clients by each document (active or expired).
document_all_received_from_clients_min_bytes - minimum from the number of bytes received from clients by each document (active or expired).
document_all_received_from_clients_max_bytes - maximum from the number of bytes received from clients by each document (active or expired).
document_active_received_from_clients_total_bytes - total number of bytes received from clients by active documents.
document_active_received_from_clients_average_bytes - average between the number of bytes received from clients by each active document.
document_active_received_from_clients_min_bytes - minimum from the number of bytes received from clients by each active document.
document_active_received_from_clients_max_bytes - maximum from the number of bytes received from clients by each active document.
document_expired_received_from_clients_total_bytes - total number of bytes received from clients by expired documents.
document_expired_received_from_clients_average_bytes - average between the number of bytes received from clients by each expired document.
document_expired_received_from_clients_min_bytes - minimum from the number of bytes received from clients by each expired document.
document_expired_received_from_clients_max_bytes - maximum from the number of bytes received from clients by each expired document.
DOCUMENT DOWNLOAD DURATION
document_all_wopi_download_duration_total_seconds - sum of download duration of each document (active or expired).
document_all_wopi_download_duration_average_seconds average between the download duration of each document (active or expired).
document_all_wopi_download_duration_min_seconds minimum from the download duration of each document (active or expired).
document_all_wopi_download_duration_max_seconds - maximum from the download duration of each document (active or expired).
document_active_wopi_download_duration_total_seconds - sum of download duration of each active document.
document_active_wopi_download_duration_average_seconds - average between the download duration of each active document.
document_active_wopi_download_duration_min_seconds - minimum from the download duration of each active document.
document_active_wopi_download_duration_max_seconds - maximum from the download duration of each active document.
document_expired_wopi_download_duration_total_seconds - sum of download duration of each expired document.
document_expired_wopi_download_duration_average_seconds - average between the download duration of each expired document.
document_expired_wopi_download_duration_min_seconds - minimum from the download duration of each expired document.
document_expired_wopi_download_duration_max_seconds - maximum from the download duration of each expired document.
DOCUMENT UPLOAD DURATION
document_all_wopi_upload_duration_total_seconds - sum of upload duration of each document (active or expired).
document_all_wopi_upload_duration_average_seconds average between the upload duration of each document (active or expired).
document_all_wopi_upload_duration_min_seconds minimum from the upload duration of each document (active or expired).
document_all_wopi_upload_duration_max_seconds - maximum from the upload duration of each document (active or expired).
document_active_wopi_upload_duration_total_seconds - sum of upload duration of each active document.
document_active_wopi_upload_duration_average_seconds - average between the upload duration of each active document.
document_active_wopi_upload_duration_min_seconds - minimum from the upload duration of each active document.
document_active_wopi_upload_duration_max_seconds - maximum from the upload duration of each active document.
document_expired_wopi_upload_duration_total_seconds - sum of upload duration of each expired document.
document_expired_wopi_upload_duration_average_seconds - average between the upload duration of each expired document.
document_expired_wopi_upload_duration_min_seconds - minimum from the upload duration of each expired document.
document_expired_wopi_upload_duration_max_seconds - maximum from the upload duration of each expired document.
DOCUMENT VIEW LOAD DURATION
document_all_view_load_duration_total_seconds - sum of load duration of each view (active or expired) of each document (active or expired).
document_all_view_load_duration_average_seconds average between the load duration of all views (active or expired) of each document (active or expired).
document_all_view_load_duration_min_seconds minimum from the load duration of all views (active or expired) of each document (active or expired).
document_all_view_load_duration_max_seconds - maximum from the load duration of all views (active or expired) of each document (active or expired).
document_active_view_load_duration_total_seconds - sum of load duration of all views (active or expired) of each active document.
document_active_view_load_duration_average_seconds - average between the load duration of all views (active or expired) of each active document.
document_active_view_load_duration_min_seconds - minimum from the load duration of all views (active or expired) of each active document.
document_active_view_load_duration_max_seconds - maximum from the load duration of all views (active or expired) of each active document.
document_expired_view_load_duration_total_seconds - sum of load duration of all views (active or expired) of each expired document.
document_expired_view_load_duration_average_seconds - average between the load duration of all views (active or expired) of each expired document.
document_expired_view_load_duration_min_seconds - minimum from the load duration of all views (active or expired) of each expired document.
document_expired_view_load_duration_max_seconds - maximum from the load duration of all views (active or expired) of each expired document.
SELECTED ERRORS - all integer counts
error_storage_space_low - local storage space too low to operate
error_storage_connection - unable to connect to storage
error_bad_request - we returned an HTTP bad request to a caller
error_bad_argument - we returned an HTTP bad argument to a caller
error_unauthorized_request - an authorization exception usually on CheckFileInfo
error_service_unavailable - internal error, service is unavailable
error_parse_error - badly formed data provided for us to parse.
PER DOCUMENT DETAILS - suffixed by {pid=<pid>} for each document:
doc_host - host this document was fetched from
doc_key - key often WOPISrc used to fetch the document
doc_active_views - number of views/users currently
doc_is_modified - is the document modified, or not ie. saved/readonly
doc_memory_used_bytes - bytes of memory dirtied by this process
doc_cpu_used_seconds - number of seconds of CPU time used
doc_open_time_seconds - time since the document was first opened
doc_download_time_seconds - how long it took to download the doc
doc_upload_time_seconds - how long it last took to up-load the doc or 0 if unsaved.