Changelog

What’s new?

1.2.2

  • PST-708: Updated APM dependency version that was causing the TraceContext of DLC events to be null in the DLC Cache.

1.2.1

  • PST-706: Removed NPE when checking if events have errors during Loading or Unloading of data.

Known Issues

  • Parsing of large files will cause null TraceContext value for HealthEvents, leading to the DLC not properly adding events to the Cache.

1.2.0

DEE Customizations

  • PST-690: Fixed DEE issue in AEnhancedDrillthroughService in case of entries with the same underlying datastore field and entries without dictionaries. Fixed export of vector.

Data Connector Design and Customizations

  • PST-6684: Removed IScopedFetchSource interface as it causes confusion, and is functionally identical to IFetchingDataSource.
  • PST-685: Fixed DLC response timeTakenMs to show ms instead of nanoseconds
  • PST-670: Added CustomKafkaAvroDeserializerGenericRecord and CustomKafkaAvroDeserializerObjectTuple classes
  • PST-688: Integrated APM tracing for DLC health events.

1.1.0

DEE Customizations

Data Connector Design and Customizations

  • PST-662 Product Center’s ParquetParserBuilder has been implemented. This implementation requires AP version 5.9.2+.
  • PST-668 Added ability to customize ordering of Topics within a given transaction. More on Custom Ordering for Loading Topics page.

Migration Notes

1.2.0

APM Integration

APM has been added into DLC and is used to trace events. If you were using a combined HealthEventDispatcher of APM and DLC, this is no longer necessary as the DLC now uses APM’s IHealthEventDispatcher. To ensure APM is configured correctly, the following configurations will need to be implemented into your project.

Required Configurations

The following Configs must be included in your project’s application config.

Required Configuration Classes Replaces Configuration Class
APMTracingConfig.class N/A
APMActivePivotServicesConfig.class ActivePivotServicesConfig

An example of including these configuration classes can be seen as follows:

    @Configuration
    @Import({
        // Required Configurations for Tracing and APM
        APMTracingConfig.class,
        APMActivePivotServicesConfig.class
    })
    public class ApplicationConfig {
    }
Registry Setup
  • APM must be defined with high precedence in ActivePivot’s Registry. This is because some classes are Extended Plugins or Types overriding the core code. It is important to make sure they are picked first by the Registry. Make sure you add the package com.activeviam.apm to be picked first. The below snipit can be added to your application’s configuration.
/** Before anything else we statically initialize the ActiveViam Registry. */
static {
    Registry.setContributionProvider(
        new ClasspathContributionProvider(
            "com.activeviam.apm",  // First has highest priority
            "com.qfs",
            "com.quartetfs",
            "com.activeviam"
        )
    );
}
Initial Data Load
  • If you are executing any DLC tasks via Spring Beans during initialization of your application, you must ensure that the APM_TRACING Bean is created first either by the @DependsOn or by Autowiring the APM_TRACING Bean. Please see code sample below as an example:
    @Bean
    @DependsOn(value = {APM_TRACING})
    public Void initialLoad() {
        // Load data here...
    }

Updated Tracing

Prior to 1.2.0, the DLC would respond to operations with a taskName, such as “LoadDataTxControllerTask-0”. Now, using APM’s tracing, the DLC will respond with a unique hex string, such as “7a8c982a87b050f2”. This hex string will act as our taskName and will still be used as the DLC’s Cache Key. This tracer hex string will be added to HealthEvent’s eventProperties map as a TraceContext object. For more information on Tracing, see Tracing.

APM_TRACING Bean must be configured before data loading

  • If you are executing any DLC tasks via Spring Beans during initialization of your application, you must ensure that the APM_TRACING Bean is created first either by the @DependsOn or by Autowiring the APM_TRACING Bean. Please see code sample below as an example:
    @Bean
    @DependsOn(value = {APM_TRACING})
    public Void initialLoad() {
        // Load data here...
    }
search.js