README

This is a read-only subtree split of https://github.com/open-telemetry/opentelemetry-php-contrib.

OpenTelemetry mysqli auto-instrumentation

Please read https://opentelemetry.io/docs/instrumentation/php/automatic/ for instructions on how to install and configure the extension and SDK.

Overview

Auto-instrumentation hooks are registered via composer, and client kind spans will automatically be created when calling following functions or methods:

• mysqli_connect

• mysqli::__construct

• mysqli::connect

• mysqli_real_connect

• mysqli::real_connect

• mysqli_query

• mysqli::query

• mysqli_real_query

• mysqli::real_query

• mysqli_execute_query

• mysqli::execute_query

• mysqli_multi_query

• mysqli::multi_query

• mysqli_next_result

• mysqli::next_result

• mysqli_begin_transaction

• mysqli::begin_transaction

• mysqli_rollback

• mysqli::rollback

• mysqli_commit

• mysqli::commit

• mysqli_stmt_execute

• mysqli_stmt::execute

• mysqli_stmt_next_result

• mysqli_stmt::next_result

Configuration

Disabling mysqli instrumentation

The extension can be disabled via runtime configuration:

OTEL_PHP_DISABLED_INSTRUMENTATIONS=mysqli

Database Context Propagation

Enable context propagation for database queries by installing the following packages:

composer require open-telemetry/opentelemetry-sqlcommenter

Currently, only the following functions support context propagation:

• mysqli::query
• mysqli_query
• mysqli::real_query
• mysqli_real_query