{"record":{"id":"fc93e0771700ff93","repo":"pinpoint-apm/pinpoint","slug":"application-servicetype-not-found-code-name","errorCode":null,"errorMessage":"application serviceType not found. code:, name:","messagePattern":"application serviceType not found\\. code:, name:","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"web/src/main/java/com/navercorp/pinpoint/web/applicationmap/controller/FilteredMapController.java","lineNumber":178,"sourceCode":"\n    private Range toRange(RangeForm rangeForm) {\n        return Range.between(rangeForm.getFrom(), rangeForm.getTo());\n    }\n\n    private ServiceType findServiceType(Integer serviceTypeCode, String serviceTypeName) {\n        if (serviceTypeCode != null) {\n            ServiceType serviceTypeFromCode = serviceTypeRegistryService.findServiceType(serviceTypeCode);\n            if (serviceTypeFromCode != null && !ServiceType.UNDEFINED.equals(serviceTypeFromCode)) {\n                return serviceTypeFromCode;\n            }\n        }\n        if (serviceTypeName != null) {\n            ServiceType serviceTypeFromName = serviceTypeRegistryService.findServiceTypeByName(serviceTypeName);\n            if (serviceTypeFromName != null && !ServiceType.UNDEFINED.equals(serviceTypeFromName)) {\n                return serviceTypeFromName;\n            }\n        }\n        throw new IllegalArgumentException(\"application serviceType not found. code:\" + serviceTypeCode + \", name:\" + serviceTypeName);\n    }\n\n}\n","sourceCodeStart":160,"sourceCodeEnd":182,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/web/src/main/java/com/navercorp/pinpoint/web/applicationmap/controller/FilteredMapController.java#L160-L182","documentation":"FilteredMapController.findServiceType resolves the ServiceType for a filtered map query from the serviceTypeCode and serviceTypeName request parameters. If neither resolves to a known, non-UNDEFINED ServiceType in the registry, it throws IllegalArgumentException. The registry only knows service types declared by loaded plugin descriptor files.","triggerScenarios":"Calling /getFilteredServerMapData with a serviceTypeCode that no plugin declares, a serviceTypeName not in the registry, or values that resolve to ServiceType.UNDEFINED; also empty code+name when parameters are omitted.","commonSituations":"Custom service type plugins not deployed to the Pinpoint web/server classpath, typos in serviceTypeName, agent SDK versions introducing a new service type the web module doesn't know, missing service-type.yml entries.","solutions":["Check the serviceTypeCode/name sent in the request matches a type in the registry (check Pinpoint's service-type descriptor files)","Deploy/register the required service-type plugin descriptor on the web server","Fix the client to send a defined code (e.g. 1010 SPRING_BOOT) and correct name together"],"exampleFix":"// before\nGET /getFilteredServerMapData?serviceTypeName=SrpingBoot&serviceTypeCode=1210\n// after\nGET /getFilteredServerMapData?serviceTypeName=SPRING_BOOT&serviceTypeCode=1210","handlingStrategy":"validation","validationCode":"ServiceType st = serviceTypeRegistryService.findServiceTypeByName(serviceTypeName);\nif (st == null || ServiceType.UNDEFINED.equals(st)) {\n    throw new IllegalArgumentException(\"Unknown serviceType: \" + serviceTypeName);\n}","typeGuard":null,"tryCatchPattern":"try {\n    map = filteredMapService.getServerMap(...);\n} catch (IllegalArgumentException e) {\n    if (e.getMessage().startsWith(\"application serviceType not found\")) {\n        // return 400 to client listing valid service types\n    } else throw e;\n}","preventionTips":["Send both serviceTypeCode and serviceTypeName from the same source (e.g. Pinpoint UI constants)","Verify custom service type plugins are installed on web AND collector","After upgrading agents, confirm the web module's service-type descriptors include any new codes"],"tags":["servicetype","filter","illegal-argument"],"backgroundTag":"resource-not-found","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"}