apache/hadoop · error · InvalidConfigurationValueException

permitsPerSecond must be > 0

Error message

permitsPerSecond must be > 0

What it means

Error "permitsPerSecond 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:60

  // 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.
    this.scheduler.scheduleWithFixedDelay(
        this::dispatchMetrics,
        dispatchIntervalInMins,
        dispatchIntervalInMins,
        TimeUnit.MINUTES);

View on GitHub (pinned to 2add963021)

Solutions

1. Set the rate limiter permits-per-second value to a positive number.
2. Correct the fs.azure metrics/throughput configuration property.

When it happens

Trigger: AggregateMetricsManager rate limiting is configured with a non-positive permits-per-second value.

Common situations: See trigger scenarios.

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