io.opentelemetry.instrumentation.apachedbcp.ApacheDbcpTelemetry Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of opentelemetry-apache-dbcp-2.0 Show documentation

Instrumentation of Java libraries using OpenTelemetry.

There is a newer version: 2.8.0-alpha

Show newest version

/*
 * Copyright The OpenTelemetry Authors
 * SPDX-License-Identifier: Apache-2.0
 */

package io.opentelemetry.instrumentation.apachedbcp;

import io.opentelemetry.api.OpenTelemetry;
import org.apache.commons.dbcp2.BasicDataSourceMXBean;

/** Entrypoint for instrumenting Apache DBCP database connection pools. */
public final class ApacheDbcpTelemetry {

  /** Returns a new {@link ApacheDbcpTelemetry} configured with the given {@link OpenTelemetry}. */
  public static ApacheDbcpTelemetry create(OpenTelemetry openTelemetry) {
    return new ApacheDbcpTelemetry(openTelemetry);
  }

  private final OpenTelemetry openTelemetry;

  private ApacheDbcpTelemetry(OpenTelemetry openTelemetry) {
    this.openTelemetry = openTelemetry;
  }

  /** Start collecting metrics for given connection pool. */
  public void registerMetrics(BasicDataSourceMXBean dataSource, String dataSourceName) {
    DataSourceMetrics.registerMetrics(openTelemetry, dataSource, dataSourceName);
  }

  /** Stop collecting metrics for given connection pool. */
  public void unregisterMetrics(BasicDataSourceMXBean dataSource) {
    DataSourceMetrics.unregisterMetrics(dataSource);
  }
}