hashicorp/nomad · error

fingerprint %q retry interval cannot be negative

Error message

fingerprint %q retry interval cannot be negative

What it means

Returned by Fingerprint.Validate when the fingerprint block's RetryInterval is a negative duration. Retry backoff timings must be zero or positive; negative intervals are meaningless and rejected at config load.

Source

Thrown at client/config/fingerprint.go:109

	return &result
}

// Validate the fingerprint block to ensure we do not have any values that
// cannot be handled.
func (f *Fingerprint) Validate() error {

	if f == nil {
		return nil
	}

	if f.Name == "" {
		return errors.New("fingerprint name cannot be empty")
	}
	if !slices.Contains(validEnvFingerprinters, f.Name) {
		return fmt.Errorf("fingerprint %q does not support configuration", f.Name)
	}
	if f.RetryInterval < 0 {
		return fmt.Errorf("fingerprint %q retry interval cannot be negative", f.Name)
	}
	if f.RetryAttempts < -1 {
		return fmt.Errorf("fingerprint %q retry attempts cannot be less than -1", f.Name)
	}
	if len(f.ExtraKeysHCL) > 0 {
		return fmt.Errorf("fingerprint %q contains unknown configuration options: %s",
			f.Name, strings.Join(f.ExtraKeysHCL, ","))
	}

	return nil
}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Set retry_interval to a non-negative duration
2. Omit retry_interval to use the fingerprinter default

When it happens

Trigger: Thrown at client/config/fingerprint.go:109 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/a0ebe525bfab26cb. Report an issue: GitHub.