Metrics reference

Resource usage metrics

Metric name Type, units of measurement	Description Labels
resources.storage.used_bytes IGAUGE, bytes	The size of user and service data stored in distributed network storage. Housekeeping data include the data of the primary and secondary indexes.
resources.storage.limit_bytes IGAUGE, bytes	A limit on the size of user and service data that a database can store in distributed network storage.

API metrics

Metric name Type, units of measurement	Description Labels
api.grpc.request.bytes RATE, bytes	The size of queries received by the database in a certain period of time. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery.
api.grpc.request.dropped_count RATE, pieces	The number of requests dropped at the transport (gRPC) layer due to an error. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery.
api.grpc.request.inflight_count IGAUGE, pieces	The number of requests that a database is simultaneously handling in a certain period of time. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery.
api.grpc.request.inflight_bytes IGAUGE, bytes	The size of requests that a database is simultaneously handling in a certain period of time. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery.
api.grpc.response.bytes RATE, bytes	The size of responses sent by the database in a certain period of time. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery.
api.grpc.response.count RATE, pieces	The number of responses sent by the database in a certain period of time. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery. - status is the request execution status. See a more detailed description of statuses under Error Handling.
api.grpc.response.dropped_count RATE, pieces	The number of responses dropped at the transport (gRPC) layer due to an error. Labels: - api_service: The name of the gRPC API service, such as table. - method: The name of a gRPC API service method, such as ExecuteDataQuery.
api.grpc.response.issues RATE, pieces	The number of errors of a certain type arising in the execution of a request over a certain period of time. Tags: - issue_type is the error type wth the only value being optimistic_locks_invalidation. For more on lock invalidation, review Transactions and requests to YDB.

Session metrics

Metric name Type, units of measurement	Description Labels
table.session.active_count IGAUGE, pieces	The number of sessions started by clients and running at a given time.
table.session.closed_by_idle_count RATE, pieces	The number of sessions closed by the DB server in a certain period of time due to exceeding the lifetime allowed for an idle session.

Transaction processing metrics

You can analyze a transaction's execution time using a histogram counter. The intervals are set in milliseconds. The chart shows the number of transactions whose duration falls within a certain time interval.

Metric name Type, units of measurement	Description Labels
table.transaction.total_duration_milliseconds HIST_RATE, pieces	The number of transactions with a certain duration on the server and client. The duration of a transaction is counted from the point of its explicit or implicit start to committing changes or its rollback. Includes the transaction processing time on the server and the time on the client between sending different requests within the same transaction. Labels: - tx_kind: The transaction type, possible values are read_only, read_write, write_only, and pure.
table.transaction.server_duration_milliseconds HIST_RATE, pieces	The number of transactions with a certain duration on the server. The duration is the time of executing requests within a transaction on the server. Does not include the waiting time on the client between sending separate requests within a single transaction. Labels: -tx_kind: The transaction type, possible values areread_only, read_write, write_only, and pure.
table.transaction.client_duration_milliseconds HIST_RATE, pieces	The number of transactions with a certain duration on the client. The duration is the waiting time on the client between sending individual requests within a single transaction. Does not include the time of executing requests on the server. Labels: - tx_kind: The transaction type, possible values are read_only, read_write, write_only, and pure.

Query processing metrics

Metric name Type, units of measurement	Description Labels
table.query.request.bytes RATE, bytes	The size of YQL query text and parameter values to queries received by the database in a certain period of time.
table.query.request.parameters_bytes RATE, bytes	The parameter size to the queries received by the database in a certain period of time.
table.query.response.bytes RATE, bytes	The size of responses sent by the database in a certain period of time.
table.query.compilation.latency_milliseconds HIST_RATE, pieces	Histogram counter. The intervals are set in milliseconds. Shows the number of successfully executed compilation queries whose duration falls within a certain time interval.
table.query.compilation.active_count IGAUGE, pieces	The number of active compilations at a given time.
table.query.compilation.count RATE, pieces	The number of compilations that completed successfully in a certain time period.
table.query.compilation.errors RATE, pieces	The number of compilations that failed in a certain period of time.
table.query.compilation.cache_hits RATE, pieces	The number of queries in a certain period of time, which didn't require any compilation, because there was an existing plan in the cache of prepared queries.
table.query.compilation.cache_misses RATE, pieces	The number of queries in a certain period of time that required query compilation.
table.query.execution.latency_milliseconds HIST_RATE, pieces	Histogram counter. The intervals are set in milliseconds. Shows the number of queries whose execution time falls within a certain interval.

Table partition metrics

Metric name Type, units of measurement	Description Labels
table.datashard.row_count GAUGE, pieces	The number of rows in DB tables.
table.datashard.size_bytes GAUGE, bytes	The size of data in DB tables.
table.datashard.used_core_percents HIST_GAUGE, %	Histogram counter. The intervals are set as a percentage. Shows the number of table partitions using computing resources in the ratio that falls within a certain interval.
table.datashard.read.rows RATE, pieces	The number of rows that are read by all partitions of all DB tables in a certain period of time.
table.datashard.read.bytes RATE, bytes	The size of data that is read by all partitions of all DB tables in a certain period of time.
table.datashard.write.rows RATE, pieces	The number of rows that are written by all partitions of all DB tables in a certain period of time.
table.datashard.write.bytes RATE, bytes	The size of data that is written by all partitions of all DB tables in a certain period of time.
table.datashard.scan.rows RATE, pieces	The number of rows that are read through StreamExecuteScanQuery or StreamReadTable gRPC API calls by all partitions of all DB tables in a certain period of time.
table.datashard.scan.bytes RATE, bytes	The size of data that is read through StreamExecuteScanQuery or StreamReadTable gRPC API calls by all partitions of all DB tables in a certain period of time.
table.datashard.bulk_upsert.rows RATE, pieces	The number of rows that are added through a BulkUpsert gRPC API call to all partitions of all DB tables in a certain period of time.
table.datashard.bulk_upsert.bytes RATE, bytes	The size of data that is added through a BulkUpsert gRPC API call to all partitions of all DB tables in a certain period of time.
table.datashard.erase.rows RATE, pieces	The number of rows deleted from the database in a certain period of time.
table.datashard.erase.bytes RATE, bytes	The size of data deleted from the database in a certain period of time.

Resource usage metrics (for Dedicated mode only)

Metric name Type units of measurement	Description Labels
resources.cpu.used_core_percents RATE, %	CPU usage. If the value is 100, one of the cores is being used for 100%. The value may be greater than 100 for multi-core configurations. Labels: - pool: The computing pool, possible values are user, system, batch, io, and ic.
resources.cpu.limit_core_percents IGAUGE, %	The percentage of CPU available to a database. For example, for a database that has three nodes with four cores in pool=user per node, the value of this metric will be 1200. Labels: - pool: The computing pool, possible values are user, system, batch, io, and ic.
resources.memory.used_bytes IGAUGE, bytes	The amount of RAM used by the database nodes.
resources.memory.limit_bytes IGAUGE, bytes	RAM available to the database nodes.

Query processing metrics (for Dedicated mode only)

Metric name Type units of measurement	Description Labels
table.query.compilation.cache_evictions RATE, pieces	The number of queries evicted from the cache of prepared queries in a certain period of time.
table.query.compilation.cache_size_bytes IGAUGE, bytes	The size of the cache of prepared queries.
table.query.compilation.cached_query_count IGAUGE, pieces	The size of the cache of prepared queries.