[mysql_otel] MySQL OpenTelemetry Content Pack (#14729)

Author: mykola-elastic

.github/CODEOWNERS

@@ -317,6 +317,7 @@
 /packages/mongodb @elastic/obs-infraobs-integrations
 /packages/mongodb_atlas @elastic/obs-infraobs-integrations
 /packages/mysql @elastic/obs-infraobs-integrations
+/packages/mysql_otel @elastic/obs-infraobs-integrations
 /packages/mysql_enterprise @elastic/sec-windows-platform
 /packages/nagios_xi @elastic/obs-infraobs-integrations
 /packages/nats @elastic/obs-infraobs-integrations

packages/mysql_otel/LICENSE.txt

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

packages/mysql_otel/changelog.yml

@@ -0,0 +1,6 @@
+# newer versions go on top
+- version: "0.1.0"
+  changes:
+    - description: Initial draft of the MySQL OTEL content package
+      type: enhancement
+      link: https://github.com/elastic/integrations/pull/14729

packages/mysql_otel/docs/README.md

@@ -0,0 +1,104 @@
+# MYSQL metrics for OpenTelemetry Collector
+
+The MySQL metrics from MySQL OTEL receiver allows you to monitor [MySQL](https://www.mysql.com), an open-source Relational Database Management System (RDBMS) that enables users to store, manage, and retrieve structured data efficiently.
+
+The MySQL OpenTelemetry assets provide a visual representation of MySQL metrics collected via OpenTelemetry ([MySQL receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/mysqlreceiver)), enabling you to monitor database performance and troubleshoot issues effectively in real time.
+
+## Compatibility
+
+The content pack has been tested with [OpenTelemetry MySQL receiver v0.129.0](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/v0.129.0/receiver/mysqlreceiver/README.md).
+
+Databases tested against:
+- MySQL 8.0, 9.4
+- MariaDB 10.11, 11.8
+
+## Requirements
+
+You need Elasticsearch for storing and searching your data and Kibana for visualizing and managing it.
+You can use our hosted Elasticsearch Service on Elastic Cloud, which is recommended, or self-manage the Elastic Stack on your own hardware.
+
+## Setup
+
+1. Install and configure the EDOT Collector or upstream Collector to export metrics to ElasticSearch, as shown in the following example:
+
+```yaml
+receivers:
+  mysql:
+    endpoint: localhost:3306
+    username: <MYSQL_USER>
+    password: <MYSQL_PASSWORD>
+    database: <your database name>
+    collection_interval: 10s
+    initial_delay: 1s
+    statement_events:
+      digest_text_limit: 120
+      time_limit: 24h
+      limit: 250
+    metrics:
+      mysql.query.client.count:
+        enabled: true
+      mysql.client.network.io:
+        enabled: true
+      mysql.commands:
+        enabled: true
+      mysql.max_used_connections:
+        enabled: true
+      mysql.connection.errors:
+        enabled: true
+      mysql.table_open_cache:
+        enabled: true
+      mysql.replica.sql_delay:
+        enabled: true
+      mysql.replica.time_behind_source:
+        enabled: true
+exporters:
+  debug:
+    verbosity: detailed
+  elasticsearch/otel:
+    endpoints: https://elasticsearch:9200
+    user: <userid>
+    password: <pwd>
+    mapping:
+      mode: otel
+    metrics_dynamic_index:
+      enabled: true
+service:
+  pipelines:
+    metrics:
+      exporters: [debug, elasticsearch/otel]
+      receivers: [mysql]
+```
+
+Use this configuration to run the collector.
+
+The following metrics should be enabled in the `mysqlreceiver` configuration for the dashboards to be populated:
+
+For Database Overview dashboard:
+```yaml
+mysql.query.client.count:
+  enabled: true
+mysql.client.network.io:
+  enabled: true
+mysql.commands:
+  enabled: true
+mysql.max_used_connections:
+  enabled: true
+mysql.connection.errors:
+  enabled: true
+mysql.table_open_cache:
+  enabled: true
+```
+
+For Replica Status dashboard:
+```yaml
+mysql.replica.sql_delay:
+  enabled: true
+mysql.replica.time_behind_source:
+  enabled: true
+```
+
+## Metrics reference
+
+### MySQL metrics
+
+Please refer to [the documentation of the OpenTelemetry's MySQL receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/mysqlreceiver/documentation.md).