Add pseudo monitoring option 'none' to disable all monitoring options

core/deployment/src/main/java/io/quarkus/deployment/pkg/NativeConfig.java

@@ -334,6 +334,7 @@ default String getEffectiveImage() {
      * <li><code>jmxserver</code> for JMX server support (experimental)</li>
      * <li><code>nmt</code> for native memory tracking support</li>
      * <li><code>all</code> for all monitoring features</li>
+     * <li><code>none</code> for explicitly turning off all monitoring features</li>
      * </ul>
      */
     Optional<List<MonitoringOption>> monitoring();
@@ -590,7 +591,8 @@ enum MonitoringOption {
         JMXSERVER,
         JMXCLIENT,
         NMT,
-        ALL
+        ALL,
+        NONE
     }
 
     enum ImagePullStrategy {

core/deployment/src/main/java/io/quarkus/deployment/pkg/steps/NativeImageBuildStep.java

@@ -951,11 +951,6 @@ public NativeImageInvokerInfo build() {
                 }
 
                 Set<NativeConfig.MonitoringOption> monitoringOptions = new LinkedHashSet<>();
-                if (!OS.WINDOWS.isCurrent() || containerBuild) {
-                    // --enable-monitoring=heapdump is not supported on Windows
-                    monitoringOptions.add(NativeConfig.MonitoringOption.HEAPDUMP);
-                }
-
                 if (nativeMonitoringItems != null && !nativeMonitoringItems.isEmpty()) {
                     monitoringOptions.addAll(nativeMonitoringItems.stream()
                             .map(NativeMonitoringBuildItem::getOption)
@@ -965,6 +960,30 @@ public NativeImageInvokerInfo build() {
                 if (nativeConfig.monitoring().isPresent()) {
                     monitoringOptions.addAll(nativeConfig.monitoring().get());
                 }
+
+                if (monitoringOptions.remove(NativeConfig.MonitoringOption.NONE)) {
+                    // Don't add any monitoring options since 'none' was present.
+                    // Only log a warning when additional options were present as well
+                    if (!monitoringOptions.isEmpty()) {
+                        String otherOpts = monitoringOptions.stream()
+                                .map(o -> o.name().toLowerCase(Locale.ROOT))
+                                .collect(Collectors.joining(","));
+                        log.warn(
+                                "Your application is setting monitoring option 'quarkus.native.monitoring' to 'none' AND '"
+                                        + otherOpts + "'"
+                                        + " Please consider removing options '" + otherOpts + "' as they will be ignored."
+                                        + " Monitoring option 'none' disables all monitoring options regardless of other settings.");
+                        // Explicitly clear all monitoring options otherwise specified
+                        monitoringOptions.clear();
+                    }
+                } else {
+                    // Add heapdump monitoring option if and only if 'none' wasn't included
+                    if (!OS.WINDOWS.isCurrent() || containerBuild) {
+                        // --enable-monitoring=heapdump is not supported on Windows
+                        monitoringOptions.add(NativeConfig.MonitoringOption.HEAPDUMP);
+                    }
+                }
+
                 if (!monitoringOptions.isEmpty()) {
                     nativeImageArgs.add("--enable-monitoring=" + monitoringOptions.stream()
                             .map(o -> o.name().toLowerCase(Locale.ROOT)).collect(Collectors.joining(",")));

docs/src/main/asciidoc/building-native-image.adoc

@@ -957,6 +957,10 @@ include at build time.
 |Adds support for native memory tracking.
 |GraalVM for JDK 23 Mandrel 24.1
 
+|none
+|Disables support for all monitoring options that would be enabled by default in Quarkus
+|Pseudo option used by Quarkus
+
 |all
 |Adds all monitoring options.
 |GraalVM 22.3, GraalVM CE 17.0.7 Mandrel 22.3 Mandrel 23.0 (17.0.7)