/**
* Create telemetry options for PostgreSQL client instrumentation.
*
* Controls which telemetry signals (traces, metrics, logs) are enabled
* and how query information is captured.
*
* @param bool $traceQueries Create spans for query execution (default: true)
* @param TransactionSpanMode $transactionSpans How transactions are traced: GROUPED (default), PER_OPERATION or OFF
* @param bool $collectMetrics Collect duration and row count metrics (default: true)
* @param bool $logQueries Log executed queries (default: false)
* @param null|int $maxQueryLength Maximum query text length in telemetry (default: 1000, null = unlimited)
* @param bool $includeParameters Include query parameters in telemetry (default: false, security consideration)
*
* @example
* // Default options (traces and metrics enabled)
* $options = postgresql_telemetry_options();
*
* // Enable query logging
* $options = postgresql_telemetry_options(logQueries: true);
*
* // Metrics only, no spans
* $options = postgresql_telemetry_options(
* traceQueries: false,
* transactionSpans: TransactionSpanMode::OFF,
* collectMetrics: true,
* );
*/
postgresql_telemetry_options(bool $traceQueries, TransactionSpanMode $transactionSpans, bool $collectMetrics, bool $logQueries, ?int $maxQueryLength, bool $includeParameters, ?int $maxParameters, ?int $maxParameterLength) : PostgreSqlTelemetryOptions
Sponsor
