MDM Monitoring Metrics

The following article provides a comprehensive list of available monitoring metrics for MDM, organized by functional categories.

System and infrastructure metrics

gRPC server metrics

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_grpc_server_request_seconds_max`	Gauge	The duration of incoming gRPC calls, grouped by `serviceName`, `method`, `status`, and `type`.
`ataccama_one_grpc_server_request_seconds`	Summary	The duration of incoming gRPC calls, grouped by `serviceName`, `method`, `status`, and `type`.
`ataccama_one_grpc_server_stream_received_total`	Counter	The number of received gRPC streaming messages on the server side, grouped by `serviceName` and `method`.
`ataccama_one_grpc_server_exceptions_count_total`	Counter	Total number of exceptions on gRPC request processing.

ataccama_one_grpc_server_request_seconds_max

Gauge

The duration of incoming gRPC calls, grouped by serviceName, method, status, and type.

ataccama_one_grpc_server_request_seconds

Summary

The duration of incoming gRPC calls, grouped by serviceName, method, status, and type.

ataccama_one_grpc_server_stream_received_total

Counter

The number of received gRPC streaming messages on the server side, grouped by serviceName and method.

ataccama_one_grpc_server_exceptions_count_total

Counter

Total number of exceptions on gRPC request processing.

gRPC client metrics

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_grpc_client_pool_active`	Gauge	The number of active clients in the gRPC pool.
`ataccama_one_grpc_client_call_seconds_max`	Gauge	The duration of outgoing gRPC calls, grouped by `serviceName`, `method`, `status`, and `type`.
`ataccama_one_grpc_client_call_seconds_count`	Counter	The number of outgoing gRPC calls, grouped by `serviceName`, `method`, `status`, and `type`.
`ataccama_one_grpc_client_call_seconds_sum`	Gauge	The duration of outgoing gRPC calls, grouped by `serviceName`, `method`, `status`, and `type`.
`ataccama_one_grpc_client_stream_sent_total`	Counter	The number of sent gRPC streaming messages on the client side, grouped by `serviceName` and `method`.

ataccama_one_grpc_client_pool_active

Gauge

The number of active clients in the gRPC pool.

ataccama_one_grpc_client_call_seconds_max

Gauge

The duration of outgoing gRPC calls, grouped by serviceName, method, status, and type.

ataccama_one_grpc_client_call_seconds_count

Counter

The number of outgoing gRPC calls, grouped by serviceName, method, status, and type.

ataccama_one_grpc_client_call_seconds_sum

Gauge

The duration of outgoing gRPC calls, grouped by serviceName, method, status, and type.

ataccama_one_grpc_client_stream_sent_total

Counter

The number of sent gRPC streaming messages on the client side, grouped by serviceName and method.

HTTP server metrics

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_http_server_exceptions_count_total`	Counter	Total number of exceptions on HTTP request processing.
`ataccama_one_http_server_request_seconds`	Summary	The duration of incoming HTTP calls, grouped by `uri`, `method`, and `response`.
`ataccama_one_http_server_request_seconds_count`	Counter	Total number of incoming http calls, grouped by `uri`, `method`, and `response`.
`ataccama_one_http_server_request_seconds_sum`	Gauge	Total duration of incoming HTTP calls, grouped by `uri`, `method`, and `response`.
`ataccama_one_http_server_request_seconds_max`	Gauge	Maximum time spent in incoming HTTP call processing, grouped by `uri`, `method`, and `response`.

ataccama_one_http_server_exceptions_count_total

Counter

Total number of exceptions on HTTP request processing.

ataccama_one_http_server_request_seconds

Summary

The duration of incoming HTTP calls, grouped by uri, method, and response.

ataccama_one_http_server_request_seconds_count

Counter

Total number of incoming http calls, grouped by uri, method, and response.

ataccama_one_http_server_request_seconds_sum

Gauge

Total duration of incoming HTTP calls, grouped by uri, method, and response.

ataccama_one_http_server_request_seconds_max

Gauge

Maximum time spent in incoming HTTP call processing, grouped by uri, method, and response.

JVM and process metrics

Metric Metric type Description

Metric	Metric type	Description
`jvm_buffer_total_capacity_bytes`	Gauge	An estimate of the total capacity of the buffers in this pool.
`jvm_gc_live_data_size_bytes`	Gauge	Size of long-lived heap memory pool after reclamation.
`jvm_gc_pause_seconds`	Summary	Time spent in GC pause.
`jvm_gc_pause_seconds_max`	Gauge	Maximum time spent in GC pause.
`jvm_memory_used_bytes`	Gauge	The amount of memory used.
`jvm_gc_memory_allocated_bytes_total`	Counter	Incremented for an increase in the size of the (young) heap memory pool after one GC until the next.
`process_uptime_seconds`	Gauge	The uptime of the Java Virtual Machine (JVM).
`process_cpu_usage`	Gauge	The recent CPU usage for the JVM process.
`system_cpu_count`	Gauge	The number of processors available to the JVM.

jvm_buffer_total_capacity_bytes

Gauge

An estimate of the total capacity of the buffers in this pool.

jvm_gc_live_data_size_bytes

Gauge

Size of long-lived heap memory pool after reclamation.

jvm_gc_pause_seconds

Summary

Time spent in GC pause.

jvm_gc_pause_seconds_max

Gauge

Maximum time spent in GC pause.

jvm_memory_used_bytes

Gauge

The amount of memory used.

jvm_gc_memory_allocated_bytes_total

Counter

Incremented for an increase in the size of the (young) heap memory pool after one GC until the next.

process_uptime_seconds

Gauge

The uptime of the Java Virtual Machine (JVM).

process_cpu_usage

Gauge

The recent CPU usage for the JVM process.

system_cpu_count

Gauge

The number of processors available to the JVM.

Tomcat metrics

Metric Metric type Description

Metric	Metric type	Description
`tomcat_sessions_alive_max_seconds`	Gauge	Maximum duration of an alive Tomcat session.
`tomcat_sessions_active_current_sessions`	Gauge	Current number of active Tomcat sessions.

tomcat_sessions_alive_max_seconds

Gauge

Maximum duration of an alive Tomcat session.

tomcat_sessions_active_current_sessions

Gauge

Current number of active Tomcat sessions.

MDA service metrics

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mda_service_request_seconds_count`	Counter	Total number of calls to the MDM Web App layer, grouped by `method`.
`ataccama_one_mda_service_request_seconds_sum`	Gauge	Total duration of calls to the MDM Web App layer, grouped by `method`.
`ataccama_one_mda_service_request_seconds_max`	Gauge	Maximum time spent in calls to the MDM Web App layer, grouped by `method`.

ataccama_one_mda_service_request_seconds_count

Counter

Total number of calls to the MDM Web App layer, grouped by method.

ataccama_one_mda_service_request_seconds_sum

Gauge

Total duration of calls to the MDM Web App layer, grouped by method.

ataccama_one_mda_service_request_seconds_max

Gauge

Maximum time spent in calls to the MDM Web App layer, grouped by method.

MDM business metrics

Data access operations

Data access metrics track record processing across four categories: batch operations, publish actions from the web application, online services (REST, SOAP), and streaming platforms (such as Kafka or SQS). Each category contains metrics for input records and final changes categorized by operation type (Insert, Update, Delete).

Batch operations

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_batch_records_input_count_total`	Counter	The number of records that were ever inputted to any batch load operation.
`ataccama_one_mdm_batch_records_changed_count_total`	Counter	The number of records that were changed by a batch load operation. The `change_type` label specifies how data was modified: `I` for Insert, `U` for Update, `D` for Delete.

ataccama_one_mdm_batch_records_input_count_total

Counter

The number of records that were ever inputted to any batch load operation.

ataccama_one_mdm_batch_records_changed_count_total

Counter

The number of records that were changed by a batch load operation. The change_type label specifies how data was modified: I for Insert, U for Update, D for Delete.

Publish operations

This category covers publish operations that a user initiated from the web application.

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_publishing_records_input_count_total`	Counter	The number of records inputted to publish actions from the web application.
`ataccama_one_mdm_publishing_records_changes_count_total`	Counter	The number of changed records by publish actions from the web application. The `change_type` label specifies how data was modified: `I` for Insert, `U` for Update, `D` for Delete.

ataccama_one_mdm_publishing_records_input_count_total

Counter

The number of records inputted to publish actions from the web application.

ataccama_one_mdm_publishing_records_changes_count_total

Counter

The number of changed records by publish actions from the web application. The change_type label specifies how data was modified: I for Insert, U for Update, D for Delete.

Service (REST, SOAP) operations

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_services_records_input_count_total`	Counter	The number of records on input for publish actions from online services (for example, REST, SOAP).
`ataccama_one_mdm_services_records_changes_count_total`	Counter	The number of changed records by publish actions from online services. The `change_type` label specifies how data was modified: `I` for Insert, `U` for Update, `D` for Delete.

ataccama_one_mdm_services_records_input_count_total

Counter

The number of records on input for publish actions from online services (for example, REST, SOAP).

ataccama_one_mdm_services_records_changes_count_total

Counter

The number of changed records by publish actions from online services. The change_type label specifies how data was modified: I for Insert, U for Update, D for Delete.

Streaming operations

This category covers record processing executed on streaming platforms like Kafka or SQS.

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_streaming_records_input_count_total`	Counter	The number of records that were ever inputted to any streaming operation.
`ataccama_one_mdm_streaming_records_changed_count_total`	Counter	The number of records changed by streaming operations. The `change_type` label specifies how data was modified: `I` for Insert, `U` for Update, `D` for Delete.

ataccama_one_mdm_streaming_records_input_count_total

Counter

The number of records that were ever inputted to any streaming operation.

ataccama_one_mdm_streaming_records_changed_count_total

Counter

The number of records changed by streaming operations. The change_type label specifies how data was modified: I for Insert, U for Update, D for Delete.

User activity and configuration

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_configured_mda_users_count`	Gauge	The number of configured MDM Web App users, categorized by permission type. The `permission` label specifies user permission type: `readOnly`, `readWrite`.
`ataccama_one_mdm_active_users_count`	Counter, Gauge	The total number of users with activity in MDM Web App. The `actions` label specifies activity type: `readOnly`, `readWrite`.
`ataccama_one_mdm_active_users_last_hour_count`	Counter, Gauge	The number of users active in the last hour in MDM Web App. The `actions` label specifies activity type: `readOnly`, `readWrite`.
`ataccama_one_mdm_active_users_last_day_count`	Counter, Gauge	The number of users active in the last 24 hours in MDM Web App. The `actions` label specifies activity type: `readOnly`, `readWrite`.

ataccama_one_mdm_configured_mda_users_count

Gauge

The number of configured MDM Web App users, categorized by permission type. The permission label specifies user permission type: readOnly, readWrite.

ataccama_one_mdm_active_users_count

Counter, Gauge

The total number of users with activity in MDM Web App. The actions label specifies activity type: readOnly, readWrite.

ataccama_one_mdm_active_users_last_hour_count

Counter, Gauge

The number of users active in the last hour in MDM Web App. The actions label specifies activity type: readOnly, readWrite.

ataccama_one_mdm_active_users_last_day_count

Counter, Gauge

The number of users active in the last 24 hours in MDM Web App. The actions label specifies activity type: readOnly, readWrite.

Data model structure

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_records_count`	Gauge	The total number of records in the system. The `type` label specifies record category: `instance`, `master`.
`ataccama_one_mdm_largest_entity_records_count`	Gauge	The number of records in the largest entity. The `type` label specifies entity category: `master` and `instance`.
`ataccama_one_mdm_entities_count`	Gauge	The total number of entities in the data model. The `type` label specifies the entity category.
`ataccama_one_mdm_relationships_count`	Gauge	The total number of relationships in the data model.
`ataccama_one_mdm_instance_entities_columns_count`	Gauge	The number of columns in the logical model for instance entities. The `origins` label specifies column origin: `all`, `source`, `copy`.
`ataccama_one_mdm_master_entities_columns_count`	Gauge	The number of columns in the logical model for master entities. The `origins` label specifies column origin: `all`, `copy`.
`ataccama_one_mdm_instance_entities_history_collectors_columns_count`	Gauge	The number of history collectors used in instance entities.
`ataccama_one_mdm_instance_entities_with_multiple_master_entities_count`	Gauge	The number of instance entities linked to multiple master entities.
`ataccama_one_mdm_instance_entities_with_multiple_matching_columns_count`	Gauge	The number of instance entities with multiple matching columns.
`ataccama_one_mdm_master_entities_with_matching_count`	Gauge	The number of master entities configured with matching criteria.

ataccama_one_mdm_records_count

Gauge

The total number of records in the system. The type label specifies record category: instance, master.

ataccama_one_mdm_largest_entity_records_count

Gauge

The number of records in the largest entity. The type label specifies entity category: master and instance.

ataccama_one_mdm_entities_count

Gauge

The total number of entities in the data model. The type label specifies the entity category.

ataccama_one_mdm_relationships_count

Gauge

The total number of relationships in the data model.

ataccama_one_mdm_instance_entities_columns_count

Gauge

The number of columns in the logical model for instance entities. The origins label specifies column origin: all, source, copy.

ataccama_one_mdm_master_entities_columns_count

Gauge

The number of columns in the logical model for master entities. The origins label specifies column origin: all, copy.

ataccama_one_mdm_instance_entities_history_collectors_columns_count

Gauge

The number of history collectors used in instance entities.

ataccama_one_mdm_instance_entities_with_multiple_master_entities_count

Gauge

The number of instance entities linked to multiple master entities.

ataccama_one_mdm_instance_entities_with_multiple_matching_columns_count

Gauge

The number of instance entities with multiple matching columns.

ataccama_one_mdm_master_entities_with_matching_count

Gauge

The number of master entities configured with matching criteria.

Task and draft management

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_drafts_count`	Gauge	The total number of drafts and historical drafts in MDM Web App. The `state` label specifies draft status: `open`, `closed`.
`ataccama_one_mdm_tasks_count`	Gauge	The total number of tasks in MDM Web App. The `type` label specifies task purpose: `record_change`, `manual_match`, `matching_proposal`, `create`, `generic`.
`ataccama_one_mdm_tasks_count_today`	Gauge	The daily number of tasks created, resolved, or closed in MDM Web App. The `type` label specifies task purpose: `record_change`, `manual_match`, `matching_proposal`, `create`, `generic`.

ataccama_one_mdm_drafts_count

Gauge

The total number of drafts and historical drafts in MDM Web App. The state label specifies draft status: open, closed.

ataccama_one_mdm_tasks_count

Gauge

The total number of tasks in MDM Web App. The type label specifies task purpose: record_change, manual_match, matching_proposal, create, generic.

ataccama_one_mdm_tasks_count_today

Gauge

The daily number of tasks created, resolved, or closed in MDM Web App. The type label specifies task purpose: record_change, manual_match, matching_proposal, create, generic.

Performance and monitoring

Startup performance

Startup metrics measure the duration of various application startup phases.

The ataccama_one_mdm_startup_total_seconds_sum metric represents the total startup time from JVM initiation to the application context being fully started.

All startup metrics are Prometheus summary types, providing _count, _sum (total time in seconds), and _max (maximum time in seconds) values. They all include a startup_ts="<TIMESTAMP>" label, which records the JVM startup timestamp.

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_startup_total_seconds`	Summary	Measures the total startup time from the JVM startup until the application context is started. Labels: `startup_ts` (JVM startup timestamp).
`ataccama_one_mdm_startup_application_context_active_seconds`	Summary	Measures the time taken for the application context to become active during startup. Labels: `startup_ts` (JVM startup timestamp).
`ataccama_one_mdm_startup_application_context_seconds`	Summary	Measures the time taken for the application context startup phase. This includes initialization of beans and other context-related setup. Labels: `startup_ts` (JVM startup timestamp), `error` (indicates if an error occurred during this phase, for example, `none`).
`ataccama_one_mdm_startup_jvm_seconds`	Summary	Measures the JVM startup time, from the beginning of JVM initialization to the start of the root context. Labels: `startup_ts` (JVM startup timestamp).
`ataccama_one_mdm_startup_management_context_active_seconds`	Summary	Measures the time taken for the management context to become active during startup. Labels: `startup_ts` (JVM startup timestamp).
`ataccama_one_mdm_startup_management_context_seconds`	Summary	Measures the time taken for the management context startup phase. Labels: `startup_ts` (JVM startup timestamp), `error` (indicates if an error occurred during this phase, for example, `none`).
`ataccama_one_mdm_startup_root_context_seconds`	Summary	Measures the startup time of the root context. Labels: `startup_ts` (JVM startup timestamp).

ataccama_one_mdm_startup_total_seconds

Summary

Measures the total startup time from the JVM startup until the application context is started. Labels: startup_ts (JVM startup timestamp).

ataccama_one_mdm_startup_application_context_active_seconds

Summary

Measures the time taken for the application context to become active during startup. Labels: startup_ts (JVM startup timestamp).

ataccama_one_mdm_startup_application_context_seconds

Summary

Measures the time taken for the application context startup phase. This includes initialization of beans and other context-related setup. Labels: startup_ts (JVM startup timestamp), error (indicates if an error occurred during this phase, for example, none).

ataccama_one_mdm_startup_jvm_seconds

Summary

Measures the JVM startup time, from the beginning of JVM initialization to the start of the root context. Labels: startup_ts (JVM startup timestamp).

ataccama_one_mdm_startup_management_context_active_seconds

Summary

Measures the time taken for the management context to become active during startup. Labels: startup_ts (JVM startup timestamp).

ataccama_one_mdm_startup_management_context_seconds

Summary

Measures the time taken for the management context startup phase. Labels: startup_ts (JVM startup timestamp), error (indicates if an error occurred during this phase, for example, none).

ataccama_one_mdm_startup_root_context_seconds

Summary

Measures the startup time of the root context. Labels: startup_ts (JVM startup timestamp).

Data Quality engine threadpool monitoring

Metrics for monitoring the Data Quality engine thread pool. These allow tracking of thread creation and completion, enabling calculation of currently active threads.

The difference between created and finished counts indicates the number of currently executing threads.

In versions prior to 16.1.0, this metric was available as dqc_threadpool_threads_total and dqc_threadpool_threads_finished_total.

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_dqc_threadpool_threads_total`	Counter	The total number of threads in the DQ engine, distinguished by their lifecycle stage. The `type` label specifies the stage of the thread’s lifecycle: `created` for newly created threads, `finished` for threads that have completed execution.

ataccama_one_mdm_dqc_threadpool_threads_total

Counter

The total number of threads in the DQ engine, distinguished by their lifecycle stage. The type label specifies the stage of the thread’s lifecycle: created for newly created threads, finished for threads that have completed execution.

Copy column operations

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_copy_columns_ops_count`	Counter	The total number of copy-column operations executed.

ataccama_one_mdm_copy_columns_ops_count

Counter

The total number of copy-column operations executed.

Event handling

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_event_handlers_count`	Gauge	The total number of event handlers in the MDM system.
`ataccama_one_mdm_event_handlers_publishers_count`	Gauge	The number of event handlers that function as publishers in the system.

ataccama_one_mdm_event_handlers_count

Gauge

The total number of event handlers in the MDM system.

ataccama_one_mdm_event_handlers_publishers_count

Gauge

The number of event handlers that function as publishers in the system.

System configuration

Metric Metric type Description

Metric	Metric type	Description
`ataccama_one_mdm_persistence_vldb_enabled`	Gauge	Indicates whether VLDB persistence is enabled for a specific instance.

ataccama_one_mdm_persistence_vldb_enabled

Gauge

Indicates whether VLDB persistence is enabled for a specific instance.

Was this page useful?