This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/collector/components/contrib/mysqlreceiver.md.

MySQL Receiver

OpenTelemetry Collector receiver · contrib distribution

  • Component ID: contrib-mysqlreceiver
  • Name: mysqlreceiver
  • Type: receiver
  • Distribution: contrib
  • Repository: opentelemetry-collector-contrib

Stability

LevelSignals
betametrics
developmentlogs

Metrics

MetricTypeValue typeUnitStabilityEnabledAttributesDescription
mysql.buffer_pool.data_pagessumint1developmentyesbuffer_pool_data (string)The number of data pages in the InnoDB buffer pool.
mysql.buffer_pool.limitsumintBydevelopmentyesThe configured size of the InnoDB buffer pool.
mysql.buffer_pool.operationssum (monotonic)int1developmentyesbuffer_pool_operations (string)The number of operations on the InnoDB buffer pool.
mysql.buffer_pool.page_flushessum (monotonic)int1developmentyesThe number of requests to flush pages from the InnoDB buffer pool.
mysql.buffer_pool.pagessumint1developmentyesbuffer_pool_pages (string)The number of pages in the InnoDB buffer pool.
mysql.buffer_pool.usagesumintBydevelopmentyesbuffer_pool_data (string)The number of bytes in the InnoDB buffer pool.
mysql.client.network.iosum (monotonic)intBydevelopmentnodirection (string)The number of transmitted bytes between server and clients.
mysql.commandssum (monotonic)int1developmentnocommand (string)The number of times each type of command has been executed.
mysql.connection.countsum (monotonic)int1developmentnoThe number of connection attempts (successful or not) to the MySQL server.
mysql.connection.errorssum (monotonic)int1developmentnoconnection_error (string)Errors that occur during the client connection process.
mysql.double_writessum (monotonic)int1developmentyesdouble_writes (string)The number of writes to the InnoDB doublewrite buffer.
mysql.file.opengaugeint1developmentnoThe number of currently open files.
mysql.handlerssum (monotonic)int1developmentyeshandler (string)The number of requests to various MySQL handlers.
mysql.index.io.wait.countsum (monotonic)int1developmentyesindex_name (string), io_waits_operations (string), schema (string), table_name (string)The total count of I/O wait events for an index.
mysql.index.io.wait.timesum (monotonic)intnsdevelopmentyesindex_name (string), io_waits_operations (string), schema (string), table_name (string)The total time of I/O wait events for an index.
mysql.innodb.data_file.iosum (monotonic)intBydevelopmentnodisk.io.direction (string)The total bytes read from and written to InnoDB data files.
mysql.innodb.operation.pendingsumint1developmentnooperations (string)The number of pending InnoDB data file operations.
mysql.innodb.row_lock.wait.countgaugeint{wait}developmentnoThe number of InnoDB row lock waits currently pending.
mysql.innodb.row_lock.wait.duration.avggaugedoublesdevelopmentnoThe average InnoDB row lock wait duration since server startup or last status reset.
mysql.innodb.row_lock.wait.duration.maxgaugedoublesdevelopmentnoThe maximum InnoDB row lock wait duration since server startup or last status reset.
mysql.joinssum (monotonic)int1developmentnojoin_kind (string)The number of joins that perform table scans.
mysql.lockssum (monotonic)int1developmentyeslocks (string)The number of MySQL locks.
mysql.log_operationssum (monotonic)int1developmentyeslog_operations (string)The number of InnoDB log operations.
mysql.max_used_connectionssumint1developmentnoMaximum number of connections used simultaneously since the server started.
mysql.myisam.key_cache.block.unusedgaugeint{block}developmentnoThe number of unused MyISAM key cache blocks.
mysql.myisam.key_cache.block.used.maxgaugeint{block}developmentnoThe maximum number of MyISAM key cache blocks simultaneously in use since the server started or status counters were reset.
mysql.myisam.key_cache.disk.operationsum (monotonic)int{operation}developmentnomysql.myisam.key_cache.operation.type (string)The number of physical MyISAM key cache disk operations.
mysql.myisam.key_cache.requestsum (monotonic)int{request}developmentnomysql.myisam.key_cache.operation.type (string)The number of logical MyISAM key cache requests.
mysql.mysqlx_connectionssum (monotonic)int1developmentyesconnection_status (string)The number of mysqlx connections. This metric is specific for MySQL working as Document Store (X-Plugin). more docs
mysql.mysqlx_worker_threadssumint1developmentnomysqlx_threads (string)The number of worker threads available. This metric is specific for MySQL working as Document Store (X-Plugin). more docs
mysql.opened_resourcessum (monotonic)int1developmentyesopened_resources (string)The number of opened resources.
mysql.operationssum (monotonic)int1developmentyesoperations (string)The number of InnoDB operations.
mysql.page_operationssum (monotonic)int1developmentyespage_operations (string)The number of InnoDB page operations.
mysql.page_sizesumintBydevelopmentnoInnoDB page size.
mysql.prepared_statementssum (monotonic)int1developmentyesprepared_statements_command (string)The number of times each type of prepared statement command has been issued.
mysql.query.client.countsum (monotonic)int1developmentnoThe number of statements executed by the server. This includes only statements sent to the server by clients.
mysql.query.countsum (monotonic)int1developmentnoThe number of statements executed by the server.
mysql.query.slow.countsum (monotonic)int1developmentnoThe number of slow queries.
mysql.replica.sql_delaysumintsdevelopmentnoThe number of seconds that the replica must lag the source.
mysql.replica.temp_table.opengaugeint{table}developmentnoThe number of temporary tables currently open by the replica while applying replicated events.
mysql.replica.thread.runninggaugeint1developmentnomysql.replica.channel.name (string), mysql.replica.thread.type (string)Whether the replica IO and SQL threads report a running status. A value of 1 means the thread reports Yes; 0 means any other status, including No or Connecting. If the thread type or channel name attributes are disabled or dropped, configure the aggregation strategy as min or max based on the desired collapsed status.
mysql.replica.time_behind_sourcesumintsdevelopmentnoThis field is an indication of how “late” the replica is.
mysql.row_lockssum (monotonic)int1developmentyesrow_locks (string)The number of InnoDB row locks.
mysql.row_operationssum (monotonic)int1developmentyesrow_operations (string)The number of InnoDB row operations.
mysql.sortssum (monotonic)int1developmentyessorts (string)The number of MySQL sorts.
mysql.statement_event.countsumint1developmentnodigest (string), digest_text (string), event_state (string), schema (string)Summary of current and recent statement events.
mysql.statement_event.wait.timesumintnsdevelopmentnodigest (string), digest_text (string), schema (string)The total wait time of the summarized timed events.
mysql.table.average_row_lengthsumintBydevelopmentnoschema (string), table_name (string)The average row length in bytes for a given table.
mysql.table.io.wait.countsum (monotonic)int1developmentyesio_waits_operations (string), schema (string), table_name (string)The total count of I/O wait events for a table.
mysql.table.io.wait.timesum (monotonic)intnsdevelopmentyesio_waits_operations (string), schema (string), table_name (string)The total time of I/O wait events for a table.
mysql.table.lock_wait.read.countsumint1developmentnoread_lock_type (string), schema (string), table_name (string)The total table lock wait read events.
mysql.table.lock_wait.read.timesumintnsdevelopmentnoread_lock_type (string), schema (string), table_name (string)The total table lock wait read events times.
mysql.table.lock_wait.write.countsumint1developmentnoschema (string), table_name (string), write_lock_type (string)The total table lock wait write events.
mysql.table.lock_wait.write.timesumintnsdevelopmentnoschema (string), table_name (string), write_lock_type (string)The total table lock wait write events times.
mysql.table.opengaugeint1developmentnoThe number of currently open tables.
mysql.table.rowssumint1developmentnoschema (string), table_name (string)The number of rows for a given table.
mysql.table.sizesumintBydevelopmentnoschema (string), table_name (string), table_size_type (string)The table size in bytes for a given table.
mysql.table_open_cachesum (monotonic)int1developmentnocache_status (string)The number of hits, misses or overflows for open tables cache lookups.
mysql.thread.slow_launchsum (monotonic)int1developmentnoThe number of threads that have taken more than slow_launch_time seconds to create.
mysql.threadssumint1developmentyesthreads (string)The state of MySQL threads.
mysql.tmp_resourcessum (monotonic)int1developmentyestmp_resource (string)The number of created temporary resources.
mysql.uptimesum (monotonic)intsdevelopmentyesThe number of seconds that the server has been up.

Attributes

AttributeTypeDescription
buffer_pool_datastringThe status of buffer pool data.
buffer_pool_operationsstringThe buffer pool operations types.
buffer_pool_pagesstringThe buffer pool pages types.
cache_statusstringThe status of cache access.
client.addressstringHostname or address of the client.
client.portintTCP port used by the client.
commandstringThe command types.
connection_errorstringThe connection error type.
connection_statusstringThe connection status.
db.namespacestringThe default database for the thread, or empty if none has been selected (originally processlist_db).
db.query.textstringThe SQL statement text for the event.
db.system.namestringThe name of the database system.
digeststringDigest.
digest_textstringText before digestion.
directionstringThe name of the transmission direction.
disk.io.directionstringThe disk IO operation direction.
double_writesstringThe doublewrite types.
event_statestringPossible event states.
handlerstringThe handler types.
index_namestringThe name of the index.
io_waits_operationsstringThe io_waits operation type.
join_kindstringThe kind of join.
locksstringThe table locks type.
log_operationsstringThe log operation types. 'fsyncs' aren't available in MariaDB 10.8 or later.
mysql.event_idintThe thread associated with the event and the thread current event number when the event starts.
mysql.events_statements_current.digeststringThe statement digest SHA-256 value as a string of 64 hexadecimal characters, or empty if the statements_digest consumer is no.
mysql.events_statements_current.timer_waitdoubleElapsed time the current statement has been executing, in seconds.
mysql.events_statements_summary_by_digest.count_starintThe number of times the statement was executed, report in delta value.
mysql.events_statements_summary_by_digest.digeststringThe statement digest SHA-256 value as a string of 64 hexadecimal characters, or empty if the statements_digest consumer is no.
mysql.events_statements_summary_by_digest.sum_timer_waitdoubleThe total time spent executing the statement, report in delta seconds.
mysql.events_waits_current.timer_waitdoubleTiming information for the event, indicating elapsed time the event waited in seconds.
mysql.myisam.key_cache.operation.typestringThe MyISAM key cache operation type.
mysql.query_planstringThe query plan for the statement, if available.
mysql.query_plan.hashstringThis attribute is set to the same value as mysql.events_statements_summary_by_digest.digest (query digest) by design.
mysql.replica.channel.namestringThe replication channel name.
mysql.replica.thread.typestringThe replica thread type.
mysql.session.idintThe unique identifier for the session associated with the event.
mysql.session.statusstringSimplified session status, either 'waiting', 'running' or 'other'.
mysql.threads.processlist_commandstringThe type of command the thread is executing on behalf of the client for foreground threads, or Sleep if the session is idle.
mysql.threads.processlist_statestringAn action, event, or state that indicates what the thread is doing.
mysql.threads.thread_idintThe unique identifier for the thread executing the statement.
mysql.wait_typestringThe name of the instrument that produced the event.
mysqlx_threadsstringThe worker thread count kind.
network.peer.addressstringIP address of the peer client.
network.peer.portintTCP port used by the peer client.
opened_resourcesstringThe kind of the resource.
operationsstringThe operation types.
page_operationsstringThe page operation types.
prepared_statements_commandstringThe prepare statement command types.
read_lock_typestringRead operation types.
row_locksstringThe row lock type.
row_operationsstringThe row operation type.
schemastringThe schema of the object.
sortsstringThe sort count type.
table_namestringTable name for event or process.
table_size_typestringThe table size types.
threadsstringThe thread count type.
tmp_resourcestringThe kind of temporary resources.
user.namestringThe user associated with a foreground thread, empty for a background thread (originally processlist_user).
write_lock_typestringWrite operation types.

Data

  • JSON (latest): /data/collector/components/contrib-mysqlreceiver/latest.json
  • JSON (pinned): /data/collector/components/contrib-mysqlreceiver/contrib-mysqlreceiver-228c2070e2e9.json
  • Explore: /collector/components/contrib/mysqlreceiver