29d68aa033
continue to use the pid as a short-ish label to disambiguate metrics,
but also define the pid with more labels in the 1st instance.
doc_pid{host="localhost",key="https://localhost:9980/.../hello-world.odt",filename="hello-world.odt"} 1261609
doc_views{pid=1261609} 2
doc_views_active{pid=1261609} 2
doc_is_modified{pid=1261609} 1
...
Change-Id: I573f6d5c8ceb9a7daee83d1f2ee9f42b8e0cd089
Signed-off-by: Michael Meeks <michael.meeks@collabora.com>
187 lines
17 KiB
Text
187 lines
17 KiB
Text
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_pid - define the pid of the related document with these labels:
|
||
host= - host this document was fetched from
|
||
key= - key often WOPISrc used to fetch the document
|
||
filename= - filename of 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.
|