{"record":{"id":"e45c971c05fa4519","repo":"pinpoint-apm/pinpoint","slug":"value-of-disable-property-is-not-false-pinpoint-d","errorCode":null,"errorMessage":"value of disable property is not false, pinpoint.disable=true","messagePattern":"value of disable property is not false, pinpoint\\.disable=true","errorType":"console","errorClass":null,"httpStatus":null,"severity":"info","filePath":"agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/PinpointStarter.java","lineNumber":86,"sourceCode":"        }\n        BootLogger moduleLogger = BootLogger.getLogger(ModuleBootLoader.class);\n        moduleLogger.info(\"java-module detected\");\n        moduleLogger.info(\"ModuleBootLoader start\");\n\n        ModuleBootLoader moduleBootLoader = new ModuleBootLoader(instrumentation, parentClassLoader, moduleLogger::info);\n        moduleBootLoader.loadModuleSupport();\n        return moduleBootLoader;\n    }\n\n\n\n    boolean start() {\n\n        try {\n            final Properties properties = loadProperties();\n\n            if (DisableOptions.isDisabled(properties::getProperty, DisableOptions.CONFIG)) {\n                this.logger.warn(\"value of disable property is not false, pinpoint.disable=true\");\n                return false;\n            }\n\n            // this is the library list that must be loaded\n            URL[] urls = resolveLib(agentDirectory);\n            final ClassLoader agentClassLoader = createClassLoader(\"pinpoint.agent\", urls, parentClassLoader, properties);\n            final ModuleBootLoader moduleBootLoader = loadModuleBootLoader(instrumentation, parentClassLoader);\n            if (moduleBootLoader != null) {\n                this.logger.info(\"defineAgentModule\");\n                moduleBootLoader.defineAgentModule(agentClassLoader, urls);\n            }\n\n            AgentBootLoader agentBootLoader = new AgentBootLoader(agentType.getClassName(), agentClassLoader);\n            logger.info(String.format(\"pinpoint agent [%s] starting...\", agentType));\n\n            final List<Path> pluginJars = agentDirectory.getPlugins();\n            AgentOption option = createAgentOption(\n                    instrumentation,","sourceCodeStart":68,"sourceCodeEnd":104,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/agent-module/bootstraps/bootstrap/src/main/java/com/navercorp/pinpoint/bootstrap/PinpointStarter.java#L68-L104","documentation":"PinpointStarter.start() re-checks the loaded pinpoint.config for the pinpoint.disable property; if it is set to true, it logs this warning and returns false, aborting agent startup. Unlike the premain-level Env check, this one is driven by the config file itself.","triggerScenarios":"pinpoint.config in the agent directory contains pinpoint.disable=true while the agent is otherwise attached and enabled at the bootstrap level.","commonSituations":"Shipped default config with disable=true copied unchanged into production; config templating flipping the flag; leftover setting from a troubleshooting session.","solutions":["Set pinpoint.disable=false in pinpoint.config (or remove the line) and restart the JVM","Verify you are editing the pinpoint.config actually loaded by the agent (log shows the config path)","If disabling is intentional, remove the -javaagent flag instead to avoid partial startup"],"exampleFix":"// pinpoint.config\n// before\npinpoint.disable=true\n// after\npinpoint.disable=false","handlingStrategy":"validation","validationCode":"// shell: before launch\ngrep -E '^\\s*pinpoint.disable\\s*=\\s*true' \"$AGENT_DIR/pinpoint.config\" && echo \"pinpoint disabled in pinpoint.config\"","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Audit pinpoint.config per environment in CI","Set pinpoint.disable=false explicitly rather than relying on defaults","Confirm the loaded config path from agent startup logs before editing"],"tags":["java","configuration","disabled","pinpoint-config"],"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"}