apache/hadoop · error · RuntimeException

Failed to initialize AggregateMetricsManager

Error message

Failed to initialize AggregateMetricsManager

What it means

Error "Failed to initialize AggregateMetricsManager" thrown in apache/hadoop.

Source

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

   * Get the singleton instance of AggregateMetricsManager.
   *
   * @param dispatchIntervalInMins Interval in minutes for dispatching metrics.
   * @param permitsPerSecond       Rate limit for dispatching metrics.
   * @return Singleton instance of AggregateMetricsManager.
   */
  public static AggregateMetricsManager getInstance(final long dispatchIntervalInMins,
      final int permitsPerSecond) {
    if (instance != null) {
      return instance;
    }

    synchronized (AggregateMetricsManager.class) {
      if (instance == null) {
        try {
          instance = new AggregateMetricsManager(
              dispatchIntervalInMins, permitsPerSecond);
        } catch (InvalidConfigurationValueException e) {
          throw new RuntimeException(
              "Failed to initialize AggregateMetricsManager", e);
        }
      }
      return instance;
    }
  }

  /**
   * Register an AbfsClient with the manager.
   * @param account Account name.
   * @param abfsClient AbfsClient instance.
   */
  public void registerClient(String account, AbfsClient abfsClient) {
    if (StringUtils.isEmpty(account) || abfsClient == null) {
      return;
    }

    buckets.computeIfAbsent(account,

View on GitHub (pinned to 2add963021)

Solutions

1. Inspect the underlying cause in the logs (configuration or sink initialization error) and correct it.
2. Verify all fs.azure.metrics.* settings and reachable metric sinks.

When it happens

Trigger: AggregateMetricsManager fails to start due to bad metrics configuration or sink setup.

Common situations: See trigger scenarios.

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