Package org.apache.ignite.spi.tracing
Interface TracingConfigurationManager
- 
 public interface TracingConfigurationManagerAllows to configure tracing, read the configuration and restore it to the defaults.
- 
- 
Field SummaryFields Modifier and Type Field Description static TracingConfigurationParametersDEFAULT_COMMUNICATION_CONFIGURATIONDefault communication configuration.static TracingConfigurationParametersDEFAULT_DISCOVERY_CONFIGURATIONDefault discovery configuration.static TracingConfigurationParametersDEFAULT_EXCHANGE_CONFIGURATIONDefault exchange configuration.static TracingConfigurationParametersDEFAULT_SQL_CONFIGURATIONDefault SQL tracing configuration.static TracingConfigurationParametersDEFAULT_TX_CONFIGURATIONDefault transaction tracing configuration.static TracingConfigurationParametersNOOP_CONFIGURATIONDefault noop configuration.
 - 
Method SummaryAll Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default @NotNull TracingConfigurationParametersget(@NotNull TracingConfigurationCoordinates coordinates)Get the most specific tracing parameters for the specified tracing coordinates (scope, label, etc.).@NotNull Map<TracingConfigurationCoordinates,TracingConfigurationParameters>getAll(@Nullable Scope scope)List all pairs of tracing configuration coordinates and tracing configuration parameters or list all pairs of tracing configuration and parameters for the specific scope.voidreset(@NotNull TracingConfigurationCoordinates coordinates)Reset tracing configuration for the specific tracing coordinates (scope, label, etc.) to default values.voidresetAll(@Nullable Scope scope)Reset tracing configuration for the specific scope, or all tracing configurations if scope not specified.voidset(@NotNull TracingConfigurationCoordinates coordinates, @NotNull TracingConfigurationParameters parameters)Set new tracing configuration for the specific tracing coordinates (scope, label, etc.).
 
- 
- 
- 
Field Detail- 
DEFAULT_SQL_CONFIGURATIONstatic final TracingConfigurationParameters DEFAULT_SQL_CONFIGURATION Default SQL tracing configuration.
 - 
DEFAULT_TX_CONFIGURATIONstatic final TracingConfigurationParameters DEFAULT_TX_CONFIGURATION Default transaction tracing configuration.
 - 
DEFAULT_EXCHANGE_CONFIGURATIONstatic final TracingConfigurationParameters DEFAULT_EXCHANGE_CONFIGURATION Default exchange configuration.
 - 
DEFAULT_DISCOVERY_CONFIGURATIONstatic final TracingConfigurationParameters DEFAULT_DISCOVERY_CONFIGURATION Default discovery configuration.
 - 
DEFAULT_COMMUNICATION_CONFIGURATIONstatic final TracingConfigurationParameters DEFAULT_COMMUNICATION_CONFIGURATION Default communication configuration.
 - 
NOOP_CONFIGURATIONstatic final TracingConfigurationParameters NOOP_CONFIGURATION Default noop configuration.
 
- 
 - 
Method Detail- 
setvoid set(@NotNull @NotNull TracingConfigurationCoordinates coordinates, @NotNull @NotNull TracingConfigurationParameters parameters) throws IgniteExceptionSet new tracing configuration for the specific tracing coordinates (scope, label, etc.). If tracing configuration with specified coordinates already exists it'll be overrided, otherwise new one will be created.- Parameters:
- coordinates-- TracingConfigurationCoordinatesSpecific set of locators like- Scopeand label, that defines subset of traces and/or spans that'll use given configuration.
- parameters-- TracingConfigurationParameterse.g. sampling rate, set of included scopes etc.
- Throws:
- IgniteException- If failed to set tracing configuration.
 
 - 
get@NotNull default @NotNull TracingConfigurationParameters get(@NotNull @NotNull TracingConfigurationCoordinates coordinates) throws IgniteException Get the most specific tracing parameters for the specified tracing coordinates (scope, label, etc.). The most specific means:- If there's tracing configuration that matches all tracing configuration attributes (scope and label) — it'll be returned.
- If there's no tracing configuration with specified label, or label wasn't specified — scope specific tracing configuration will be returned.
- If there's no tracing configuration with specified scope — default scope specific configuration will be returned.
 - Parameters:
- coordinates-- TracingConfigurationCoordinatesSpecific set of locators like- Scopeand label that defines a subset of traces and/or spans that'll use given configuration.
- Returns:
- TracingConfigurationParametersinstance.
- Throws:
- IgniteException- If failed to get tracing configuration.
 
 - 
getAll@NotNull @NotNull Map<TracingConfigurationCoordinates,TracingConfigurationParameters> getAll(@Nullable @Nullable Scope scope) throws IgniteException List all pairs of tracing configuration coordinates and tracing configuration parameters or list all pairs of tracing configuration and parameters for the specific scope.- Parameters:
- scope- Nullable scope of tracing configuration to be retrieved. If null - all configuration will be returned.
- Returns:
- The whole set of tracing configuration.
- Throws:
- IgniteException- If failed to get tracing configuration.
 
 - 
resetvoid reset(@NotNull @NotNull TracingConfigurationCoordinates coordinates) throws IgniteExceptionReset tracing configuration for the specific tracing coordinates (scope, label, etc.) to default values. Please pay attention, that there's no default values for label specific coordinates, so such kinds of configurations will be removed.- Parameters:
- coordinates-- TracingConfigurationCoordinatesspecific set of locators like- Scopeand label that defines a subset of traces and/or spans that will be reset.
- Throws:
- IgniteException- If failed to reset tracing configuration.
 
 - 
resetAllvoid resetAll(@Nullable @Nullable Scope scope) throws IgniteExceptionReset tracing configuration for the specific scope, or all tracing configurations if scope not specified.- Parameters:
- scope-- Scopethat defines a set of applicable tracing configurations.
- Throws:
- IgniteException- If failed to reset tracing configuration.
 
 
- 
 
-