grafana/k6 · error

unknown DNS configuration field: %s

Error message

unknown DNS configuration field: %s

What it means

Raised by DNSConfig's internal unmarshal when a key in the K6_DNS configuration string is not one of the recognized fields (policy, select, ttl). It is a generic unknown-key guard for DNS settings.

Source

Thrown at lib/types/dns.go:230

		switch k {
		case "policy":
			p, err := DNSPolicyString(v)
			if err != nil {
				return err
			}
			c.Policy.DNSPolicy = p
			c.Policy.Valid = true
		case "select":
			s, err := DNSSelectString(v)
			if err != nil {
				return err
			}
			c.Select.DNSSelect = s
			c.Select.Valid = true
		case "ttl":
			c.TTL = null.StringFrom(v)
		default:
			return fmt.Errorf("unknown DNS configuration field: %s", k)
		}
	}
	return nil
}

View on GitHub (pinned to 01ffac6f24)

Solutions

1. Use only the keys policy, select and ttl in K6_DNS
2. Check for typos such as "strategy" or "timeout"

When it happens

Trigger: Thrown at lib/types/dns.go:230 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of grafana/k6@01ffac6f24 (2026-08-18). Data as JSON: /api/errors/7ee7d837c7f03bf7. Report an issue: GitHub.