{"record":{"id":"ab5572cae15ce4c9","repo":"quarkusio/quarkus","slug":"unable-to-convert-s-obtained-from-the-s-system","errorCode":null,"errorMessage":"Unable to convert %s (obtained from the %s system property) into a known logging level.","messagePattern":"Unable to convert (.+?) \\(obtained from the (.+?) system property\\) into a known logging level\\.","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"independent-projects/bootstrap/runner/src/main/java/io/quarkus/bootstrap/logging/InitialConfigurator.java","lineNumber":29,"sourceCode":"\n/**\n *\n */\npublic final class InitialConfigurator implements LogContextInitializer {\n\n    public static final QuarkusDelayedHandler DELAYED_HANDLER = new QuarkusDelayedHandler();\n    private static final Level MIN_LEVEL;\n\n    private static final String SYS_PROP_NAME = \"logging.initial-configurator.min-level\";\n\n    static {\n        Level minLevel = Level.ALL;\n        String minLevelSysProp = System.getProperty(SYS_PROP_NAME);\n        if (minLevelSysProp != null) {\n            try {\n                minLevel = Level.parse(minLevelSysProp);\n            } catch (IllegalArgumentException ignored) {\n                throw new IllegalArgumentException(\n                        String.format(\"Unable to convert %s (obtained from the %s system property) into a known logging level.\",\n                                minLevelSysProp, SYS_PROP_NAME));\n            }\n        }\n        MIN_LEVEL = minLevel;\n    }\n\n    @Override\n    public Level getMinimumLevel(final String loggerName) {\n        return MIN_LEVEL;\n    }\n\n    @Override\n    public Level getInitialLevel(final String loggerName) {\n        return loggerName.isEmpty() ? Level.ALL : null;\n    }\n\n    @Override","sourceCodeStart":11,"sourceCodeEnd":47,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/independent-projects/bootstrap/runner/src/main/java/io/quarkus/bootstrap/logging/InitialConfigurator.java#L11-L47","documentation":"InitialConfigurator initializes the bootstrap logging layer and reads the minimum log level from a system property (quarkus.log.min-level style SYS_PROP_NAME). If the property value cannot be parsed as a java.util.logging Level name, it throws an IllegalArgumentException naming both the bad value and the property. This happens in the static/instance initializer, so it fails fast at logging setup.","triggerScenarios":"Starting an application (or bootstrap runner) with the min-level system property set to an unknown level string, e.g. -Dquarkus.log.min-level=VERBOSE or 'warn ' with trailing whitespace or wrong case-sensitive name.","commonSituations":"Typo in a launch script or IDE run configuration; copying level names from a different logging framework (e.g. 'WARN' is fine but 'verbose'/'trace2' is not); Docker/K8s env passed via -D with quoting issues.","solutions":["Set the property to a valid Level name: FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, ALL, or OFF","Check the exact value with: printenv / java -XshowSettings:properties and correct typos or stray whitespace","Use a supported alias accepted by Level.parse (e.g. 'WARN' and 'warning' map to WARNING)","Remove the system property to fall back to the default Level.ALL"],"exampleFix":"// before\njava -Dquarkus.log.min-level=VERBOSE -jar app.jar\n// after\njava -Dquarkus.log.min-level=INFO -jar app.jar","handlingStrategy":"validation","validationCode":"String v = System.getProperty(\"quarkus.log.min-level\");\nif (v != null) {\n    try { java.util.logging.Level.parse(v); }\n    catch (IllegalArgumentException e) { throw new IllegalStateException(\"Invalid min-level: \" + v); }\n}","typeGuard":null,"tryCatchPattern":"try {\n    new InitialConfigurator();\n} catch (IllegalArgumentException e) {\n    log.error(\"Set a valid java.util.logging Level name for the min-level property\");\n}","preventionTips":["Use only standard Level names: SEVERE/WARNING/INFO/CONFIG/FINE/FINER/FINEST/ALL/OFF","Check launch scripts and IDE run configs for typos","Trim whitespace from values set via env/CLI","Test JVM startup flags in CI"],"tags":["logging","configuration","system-properties"],"backgroundTag":"invalid-log-level-config","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-12T22:17:10.623Z"}