apache/hadoop · error · InvalidConfigurationValueException

dispatchIntervalInMins must be > 0

Error message

dispatchIntervalInMins must be > 0

What it means

Error "dispatchIntervalInMins must be > 0" thrown in apache/hadoop.

Source

Thrown at hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/AggregateMetricsManager.java:55

  // Singleton instance of AggregateMetricsManager.
  private static volatile AggregateMetricsManager instance;

  // Rate limiter to control the rate of dispatching metrics.
  private static volatile SimpleRateLimiter rateLimiter;

  // Map of account name to MetricsBucket.
  private final ConcurrentHashMap<String, MetricsBucket> buckets =
      new ConcurrentHashMap<>();

  // Scheduler for periodic dispatching of metrics.
  private final ScheduledExecutorService scheduler;

  // Private constructor to enforce singleton pattern.
  private AggregateMetricsManager(final long dispatchIntervalInMins,
      final int permitsPerSecond) throws InvalidConfigurationValueException {

    if (dispatchIntervalInMins <= 0) {
      throw new InvalidConfigurationValueException(
          "dispatchIntervalInMins must be > 0");
    }

    if (permitsPerSecond <= 0) {
      throw new InvalidConfigurationValueException(
          "permitsPerSecond must be > 0");
    }

    rateLimiter = new SimpleRateLimiter(permitsPerSecond);

    // Initialize scheduler for periodic dispatching of metrics.
    this.scheduler = Executors.newSingleThreadScheduledExecutor(r -> {
      Thread t = new Thread(r, "ABFS-Aggregated-Metrics-Dispatcher");
      t.setDaemon(true);
      return t;
    });

    // Schedule periodic dispatching of metrics.

View on GitHub (pinned to 2add963021)

Solutions

1. Set the metrics dispatch interval to a positive number of minutes.
2. Fix the corresponding fs.azure.metrics configuration value.

When it happens

Trigger: AggregateMetricsManager is configured with a dispatch interval of zero or less.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/164736db91334d9d. Report an issue: GitHub.