Skip to content

Commit

Permalink
Add dynamic configuration to enable detailed Lettuce metrics
Browse files Browse the repository at this point in the history
  • Loading branch information
eager-signal committed Feb 13, 2024
1 parent ff59ef8 commit 699b0c7
Show file tree
Hide file tree
Showing 9 changed files with 76 additions and 20 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -312,7 +312,13 @@ public void run(WhisperServerConfiguration config, Environment environment) thro

UncaughtExceptionHandler.register();

MetricsUtil.configureRegistries(config, environment);
DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager =
new DynamicConfigurationManager<>(config.getAppConfig().getApplication(),
config.getAppConfig().getEnvironment(),
config.getAppConfig().getConfigurationName(),
DynamicConfiguration.class);

MetricsUtil.configureRegistries(config, environment, dynamicConfigurationManager);

final boolean useRemoteAddress = Optional.ofNullable(
System.getenv("SIGNAL_USE_REMOTE_ADDRESS"))
Expand Down Expand Up @@ -342,12 +348,6 @@ public void run(WhisperServerConfiguration config, Environment environment) thro
DynamoDbClient dynamoDbClient = DynamoDbFromConfig.client(config.getDynamoDbClientConfiguration(),
AWSSDK_CREDENTIALS_PROVIDER);

DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager =
new DynamicConfigurationManager<>(config.getAppConfig().getApplication(),
config.getAppConfig().getEnvironment(),
config.getAppConfig().getConfigurationName(),
DynamicConfiguration.class);

BlockingQueue<Runnable> messageDeletionQueue = new LinkedBlockingQueue<>();
Metrics.gaugeCollectionSize(name(getClass(), "messageDeletionQueueSize"), Collections.emptyList(),
messageDeletionQueue);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,10 @@ public class DynamicConfiguration {
@Valid
DynamicVirtualThreadConfiguration virtualThreads = new DynamicVirtualThreadConfiguration(Collections.emptySet());

@JsonProperty
@Valid
DynamicMetricsConfiguration metricsConfiguration = new DynamicMetricsConfiguration(false);

public Optional<DynamicExperimentEnrollmentConfiguration> getExperimentEnrollmentConfiguration(
final String experimentName) {
return Optional.ofNullable(experiments.get(experimentName));
Expand Down Expand Up @@ -113,4 +117,8 @@ public DynamicVirtualThreadConfiguration getVirtualThreads() {
return virtualThreads;
}

public DynamicMetricsConfiguration getMetricsConfiguration() {
return metricsConfiguration;
}

}
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
/*
* Copyright 2024 Signal Messenger, LLC
* SPDX-License-Identifier: AGPL-3.0-only
*/

package org.whispersystems.textsecuregcm.configuration.dynamic;

/**
* @param enableLettuceRemoteTag - whether the `remote` tag should be added. Note: although this is dynamic, meters are
* cached after creation, so changes will only affect servers launched after the change.
*/
public record DynamicMetricsConfiguration(boolean enableLettuceRemoteTag) {
}
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,9 @@
import java.util.concurrent.TimeUnit;
import org.whispersystems.textsecuregcm.WhisperServerConfiguration;
import org.whispersystems.textsecuregcm.WhisperServerVersion;
import org.whispersystems.textsecuregcm.configuration.dynamic.DynamicConfiguration;
import org.whispersystems.textsecuregcm.push.PushLatencyManager;
import org.whispersystems.textsecuregcm.storage.DynamicConfigurationManager;
import org.whispersystems.textsecuregcm.util.Constants;

public class MetricsUtil {
Expand All @@ -41,7 +43,8 @@ private static String name(String name, String... parts) {
return sb.toString();
}

public static void configureRegistries(final WhisperServerConfiguration config, final Environment environment) {
public static void configureRegistries(final WhisperServerConfiguration config, final Environment environment,
DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager) {
SharedMetricRegistries.add(Constants.METRICS_NAME, environment.metrics());

{
Expand All @@ -54,7 +57,7 @@ public static void configureRegistries(final WhisperServerConfiguration config,
"version", WhisperServerVersion.getServerVersion(),
"env", config.getDatadogConfiguration().getEnvironment()));

configureMeterFilters(dogstatsdMeterRegistry.config());
configureMeterFilters(dogstatsdMeterRegistry.config(), dynamicConfigurationManager);
Metrics.addRegistry(dogstatsdMeterRegistry);
}

Expand All @@ -64,7 +67,8 @@ public static void configureRegistries(final WhisperServerConfiguration config,
}

@VisibleForTesting
static MeterRegistry.Config configureMeterFilters(MeterRegistry.Config config) {
static MeterRegistry.Config configureMeterFilters(MeterRegistry.Config config,
final DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager) {
final DistributionStatisticConfig defaultDistributionStatisticConfig = DistributionStatisticConfig.builder()
.percentiles(.75, .95, .99, .999)
.build();
Expand All @@ -84,6 +88,8 @@ public Meter.Id map(final Meter.Id id) {
return id.withName(PREFIX + "." + id.getName())
.replaceTags(id.getTags().stream()
.filter(tag -> !"command".equals(tag.getKey()))
.filter(tag -> dynamicConfigurationManager.getConfiguration().getMetricsConfiguration().
enableLettuceRemoteTag() || !"remote".equals(tag.getKey()))
.toList());
}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,11 +63,13 @@ protected void run(final Environment environment, final Namespace namespace,
final WhisperServerConfiguration configuration) throws Exception {

UncaughtExceptionHandler.register();
MetricsUtil.configureRegistries(configuration, environment);

this.namespace = namespace;
this.commandDependencies = CommandDependencies.build(getName(), environment, configuration);

MetricsUtil.configureRegistries(configuration, environment, commandDependencies.dynamicConfigurationManager());


final int segments = Objects.requireNonNull(namespace.getInt(SEGMENT_COUNT));

logger.info("Crawling accounts with {} segments and {} processors",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,8 @@ record CommandDependencies(
ClientPresenceManager clientPresenceManager,
KeysManager keysManager,
FaultTolerantRedisCluster cacheCluster,
ClientResources redisClusterClientResources) {
ClientResources redisClusterClientResources,
DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager) {

static CommandDependencies build(
final String name,
Expand Down Expand Up @@ -196,7 +197,8 @@ static CommandDependencies build(
clientPresenceManager,
keys,
cacheCluster,
redisClusterClientResources
redisClusterClientResources,
dynamicConfigurationManager
);
}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,9 @@ protected void run(Environment environment, Namespace namespace, WhisperServerCo

UncaughtExceptionHandler.register();

MetricsUtil.configureRegistries(configuration, environment);
final CommandDependencies deps = CommandDependencies.build("message-persister-service", environment, configuration);

MetricsUtil.configureRegistries(configuration, environment, deps.dynamicConfigurationManager());

if (configuration.getServerFactory() instanceof DefaultServerFactory defaultServerFactory) {
defaultServerFactory.getApplicationConnectors()
Expand All @@ -61,7 +63,6 @@ protected void run(Environment environment, Namespace namespace, WhisperServerCo
});
}

final CommandDependencies deps = CommandDependencies.build("message-persister-service", environment, configuration);

final DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager = new DynamicConfigurationManager<>(
configuration.getAppConfig().getApplication(),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,9 @@ protected void run(Environment environment, Namespace namespace, WhisperServerCo

UncaughtExceptionHandler.register();

MetricsUtil.configureRegistries(configuration, environment);
final CommandDependencies deps = CommandDependencies.build("scheduled-apn-sender", environment, configuration);

MetricsUtil.configureRegistries(configuration, environment, deps.dynamicConfigurationManager());

if (configuration.getServerFactory() instanceof DefaultServerFactory defaultServerFactory) {
defaultServerFactory.getApplicationConnectors()
Expand All @@ -63,7 +65,6 @@ protected void run(Environment environment, Namespace namespace, WhisperServerCo
});
}

final CommandDependencies deps = CommandDependencies.build("scheduled-apn-sender", environment, configuration);

final FaultTolerantRedisCluster pushSchedulerCluster = new FaultTolerantRedisCluster("push_scheduler",
configuration.getPushSchedulerCluster(), deps.redisClusterClientResources());
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,20 @@

import static org.assertj.core.api.Assertions.assertThat;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.when;

import io.micrometer.core.instrument.Meter;
import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.simple.SimpleMeterRegistry;
import java.util.List;
import org.assertj.core.api.AbstractStringAssert;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;
import org.whispersystems.textsecuregcm.configuration.dynamic.DynamicConfiguration;
import org.whispersystems.textsecuregcm.configuration.dynamic.DynamicMetricsConfiguration;
import org.whispersystems.textsecuregcm.storage.DynamicConfigurationManager;


class MetricsUtilTest {
Expand All @@ -25,10 +33,18 @@ void name() {
MetricsUtil.name(MetricsUtilTest.class, "namespace", "metric"));
}

@Test
void lettuceTagRejection() {
@ParameterizedTest
@ValueSource(booleans = {true, false})
void lettuceTagRejection(final boolean enableLettuceRemoteTag) {
DynamicConfiguration dynamicConfiguration = mock(DynamicConfiguration.class);
DynamicMetricsConfiguration metricsConfiguration = new DynamicMetricsConfiguration(enableLettuceRemoteTag);
when(dynamicConfiguration.getMetricsConfiguration()).thenReturn(metricsConfiguration);
DynamicConfigurationManager<DynamicConfiguration> dynamicConfigurationManager =
mock(DynamicConfigurationManager.class);
when(dynamicConfigurationManager.getConfiguration()).thenReturn(dynamicConfiguration);

MeterRegistry registry = new SimpleMeterRegistry();
MetricsUtil.configureMeterFilters(registry.config());
MetricsUtil.configureMeterFilters(registry.config(), dynamicConfigurationManager);

registry.counter("lettuce.command.completion.max", "command", "hello", "remote", "world", "allowed", "!").increment();
final List<Meter> meters = registry.getMeters();
Expand All @@ -37,6 +53,13 @@ void lettuceTagRejection() {
Meter meter = meters.get(0);
assertThat(meter.getId().getName()).isEqualTo("chat.lettuce.command.completion.max");
assertThat(meter.getId().getTag("command")).isNull();
AbstractStringAssert<?> remoteTag = assertThat(meter.getId().getTag("remote"));

if (enableLettuceRemoteTag) {
remoteTag.isNotNull();
} else {
remoteTag.isNull();
}
assertThat(meter.getId().getTag("allowed")).isNotNull();
}
}

0 comments on commit 699b0c7

Please sign in to comment.