{"record":{"id":"7ab9212f57872b15","repo":"pinpoint-apm/pinpoint","slug":"unsupported-operating-system","errorCode":null,"errorMessage":"Unsupported operating system {}/{}/{}","messagePattern":"Unsupported operating system (.+?)/(.+?)/(.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"agent-module/profiler/src/main/java/com/navercorp/pinpoint/profiler/context/provider/stat/filedescriptor/FileDescriptorMetricProvider.java","lineNumber":77,"sourceCode":"\n    @Override\n    public FileDescriptorMetric get() {\n\n        final JvmVersion jvmVersion = JvmUtils.getVersion();\n        final JvmType jvmType = getJvmType();\n        final OsType osType = getOsType();\n\n        final String classToLoad = getMetricClassName(osType, jvmVersion, jvmType);\n\n        FileDescriptorMetric fileDescriptorMetric = createFileDescriptorMetric(classToLoad);\n        logger.info(\"loaded : {}\", fileDescriptorMetric);\n        return fileDescriptorMetric;\n    }\n\n    @VisibleForTesting\n    String getMetricClassName(OsType osType, JvmVersion jvmVersion, JvmType jvmType) {\n        if (!isSupportedOS(osType)) {\n            logger.warn(\"Unsupported operating system {}/{}/{}\", osType, jvmVersion, jvmType);\n            return UNSUPPORTED_METRIC;\n        }\n        if (isOracleJdk(jvmType)) {\n            if (jvmVersion.onOrAfter(JvmVersion.JAVA_5)) {\n                return ORACLE_FILE_DESCRIPTOR_METRIC;\n            }\n        }\n\n        if (jvmType == JvmType.IBM) {\n            if (jvmVersion.onOrAfter(JvmVersion.JAVA_8)) {\n                return IBM_FILE_DESCRIPTOR_METRIC;\n            }\n        }\n\n        return UNSUPPORTED_METRIC;\n    }\n\n    private boolean isOracleJdk(JvmType jvmType) {","sourceCodeStart":59,"sourceCodeEnd":95,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/agent-module/profiler/src/main/java/com/navercorp/pinpoint/profiler/context/provider/stat/filedescriptor/FileDescriptorMetricProvider.java#L59-L95","documentation":"FileDescriptorMetricProvider.getMetricClassName logs this warning when the detected operating system is not in the provider's supported-OS list, before it even attempts to load a metric class. It returns the UNSUPPORTED_METRIC class name, so file-descriptor metrics are not collected on that platform. The message includes the OS type, JVM version, and JVM type for diagnosis.","triggerScenarios":"Agent started on an OS not covered by isSupportedOS (non-Linux/Unix variants like Windows or exotic platforms), regardless of JVM version.","commonSituations":"Running the Pinpoint agent on Windows developers machines; container images on unusual base OSes; BSD or other non-supported Unix flavors.","solutions":["Verify the OS is one the provider supports; on Windows this warning is expected and file-descriptor metrics are unavailable","If on a supported OS that is still flagged, check the OS-detection logic (os.name system property may be non-standard in your container)","Run the agent on a supported Linux distribution to obtain file-descriptor metrics","Accept UNSUPPORTED_METRIC if the platform genuinely cannot expose fd counts"],"exampleFix":"// before (unusual container)\nENV spark.executor.opts -Dos.name=AlpineEmbedded\n// after\n# do not override os.name; let detection report the real supported OS\nENV spark.executor.opts \"\"","handlingStrategy":"validation","validationCode":"String os = System.getProperty(\"os.name\"); if (os.toLowerCase().startsWith(\"windows\")) { /* fd metrics unsupported — don't expect them */ }","typeGuard":"function isFdMetricSupported(osType) { return osType === 'LINUX' || osType === 'UNIX'; }","tryCatchPattern":null,"preventionTips":["Run the agent on a supported Linux/Unix OS if file-descriptor metrics are required","Do not override the os.name system property in launch scripts or containers","Check the Pinpoint docs/platform matrix before deploying to exotic OSes","Expect and ignore this warning on Windows — it is by design"],"tags":["platform","metrics","operating-system","file-descriptors"],"backgroundTag":"unsupported-platform","analyzedSha":"744c3d3075e595656abb1ae331ad2c0e4c9eb996","analyzedAt":"2026-09-07T18:48:45.289Z","contentChangedAt":"2026-09-07T18:48:45.289Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}