{"record":{"id":"ab35c10dc8720733","repo":"pinpoint-apm/pinpoint","slug":"pinpoint-is-disabled-via-env-property","errorCode":null,"errorMessage":"PinPoint is disabled via Env/Property.","messagePattern":"PinPoint is disabled via Env/Property\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"info","filePath":"agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/PinpointBootStrap.java","lineNumber":50,"sourceCode":"import java.util.Map;\nimport java.util.Objects;\nimport java.util.jar.JarFile;\n\n/**\n * @author emeroad\n * @author netspider\n */\npublic class PinpointBootStrap {\n\n    private static final BootLogger logger = BootLogger.getLogger(PinpointBootStrap.class);\n\n    private static final LoadState STATE = new LoadState();\n\n    public static void premain(String agentArgs, Instrumentation instrumentation) {\n\n        if (DisableOptions.isBootDisabled()) {\n            if (logger.isWarnEnabled()) {\n                logger.warn(\"PinPoint is disabled via Env/Property.\");\n            }\n            return;\n        }\n\n        final boolean success = STATE.start();\n        if (!success) {\n            logger.warn(\"pinpoint-bootstrap already started. skipping agent loading.\");\n            return;\n        }\n\n        PinpointBootStrap bootStrap = new PinpointBootStrap(agentArgs, instrumentation);\n        bootStrap.start();\n\n    }\n\n    private final String agentArgs;\n    private final Instrumentation instrumentation;\n","sourceCodeStart":32,"sourceCodeEnd":68,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/PinpointBootStrap.java#L32-L68","documentation":"Pinpoint's bootstrap premain logs this warning and exits when the agent is explicitly disabled via the PINPOINT_DISABLE environment variable or the pinpoint.disable system property. It is an intentional shutdown, not a fault.","triggerScenarios":"JVM launched with -Dpinpoint.disable=true (or DisableOptions BOOT env var set) while -javaagent:pinpoint-bootstrap.jar is still on the command line.","commonSituations":"Deliberately disabling Pinpoint in dev/CI while forgetting to remove the -javaagent flag; templated launch scripts toggling the disable flag; copying a JVM command line between environments.","solutions":["Remove the disable flag (env PINPOINT_DISABLE or -Dpinpoint.disable=true) if the agent should run","If disabling is intentional, also remove -javaagent:pinpoint-bootstrap.jar from the JVM args to silence the warning","Confirm the exact DisableOptions key in use (boot env vs config property) matches what your launch script sets"],"exampleFix":"// before\njava -javaagent:pinpoint-bootstrap.jar -Dpinpoint.disable=true -jar app.jar\n// after\njava -javaagent:pinpoint-bootstrap.jar -jar app.jar","handlingStrategy":"validation","validationCode":"// shell: before launching\nif [ -n \"$PINPOINT_DISABLE\" ] || echo \"$JAVA_OPTS\" | grep -q 'pinpoint.disable=true'; then\n  echo \"pinpoint disabled: remove -javaagent flag\"\nfi","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep disable flags and -javaagent flags in sync in launch templates","Use one source of truth for agent enablement per environment","Log effective JVM args at startup for auditability"],"tags":["java","javaagent","configuration","disabled"],"backgroundTag":"feature-not-enabled","analyzedSha":"744c3d3075e595656abb1ae331ad2c0e4c9eb996","analyzedAt":"2026-09-07T18:48:45.289Z","contentChangedAt":"2026-09-07T18:48:45.289Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}