• Home
• io.opentelemetry.javaagent
• opentelemetry-javaagent-tooling
• 2.6.0-alpha
• source code
• AgentExtension.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

io.opentelemetry.javaagent.tooling.AgentExtension Maven / Gradle / Ivy

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

package io.opentelemetry.javaagent.tooling;

import io.opentelemetry.javaagent.extension.instrumentation.InstrumentationModule;
import io.opentelemetry.sdk.autoconfigure.spi.ConfigProperties;
import io.opentelemetry.sdk.autoconfigure.spi.Ordered;
import net.bytebuddy.agent.builder.AgentBuilder;

/**
 * An {@link AgentExtension} provides a way to modify/enrich the OpenTelemetry Javaagent behavior.
 * It can be an {@link InstrumentationModule} or a completely custom implementation. Because an
 * extension can heavily modify the javaagent's behavior extreme caution is advised.
 *
 * 
This is a service provider interface that requires implementations to be registered in a
 * provider-configuration file stored in the {@code META-INF/services} resource directory.
 */
public interface AgentExtension extends Ordered {

  /**
   * Extend the passed {@code agentBuilder} with custom logic (e.g. instrumentation).
   *
   * @return The customized agent. Note that this method MUST return a non-null {@link AgentBuilder}
   *     instance that contains all customizations defined in this extension.
   */
  AgentBuilder extend(AgentBuilder agentBuilder, ConfigProperties config);

  /**
   * Returns the name of the extension. It does not have to be unique, but it should be
   * human-readable: javaagent uses the extension name in its logs.
   */
  String extensionName();
}