{"record":{"id":"f3b5884102f7ed6f","repo":"pinpoint-apm/pinpoint","slug":"detailed-agent-info-not-found","errorCode":null,"errorMessage":"detailed agent info not found","messagePattern":"detailed agent info not found","errorType":"http","errorClass":"ResponseStatusException","httpStatus":404,"severity":"info","filePath":"web/src/main/java/com/navercorp/pinpoint/web/authorization/controller/AgentInfoController.java","lineNumber":94,"sourceCode":"    public AgentAndStatus getAgentInfo(\n            @ServiceParam ServiceName serviceName,\n            @RequestParam(\"agentId\") @NotBlank String agentId,\n            @RequestParam(\"timestamp\") Timestamp timestamp) {\n        AgentAndStatus result = this.agentInfoService.findAgentInfoAndStatus(agentId, timestamp.getEpochMillis());\n        if (result == null) {\n            throw new ResponseStatusException(HttpStatus.NOT_FOUND, \"agent info not found\");\n        }\n        return result;\n    }\n\n    @GetMapping(value = \"/getDetailedAgentInfo\")\n    public DetailedAgentAndStatus getDetailedAgentInfo(\n            @ServiceParam ServiceName serviceName,\n            @RequestParam(\"agentId\") @NotBlank String agentId,\n            @RequestParam(\"timestamp\") Timestamp timestamp) {\n        DetailedAgentAndStatus result = this.agentInfoService.findDetailedAgentInfoAndStatus(agentId, timestamp.getEpochMillis());\n        if (result == null) {\n            throw new ResponseStatusException(HttpStatus.NOT_FOUND, \"detailed agent info not found\");\n        }\n        return result;\n    }\n\n    @GetMapping(value = \"/getAgentStatus\")\n    public AgentStatus getAgentStatus(\n            @ServiceParam ServiceName serviceName,\n            @RequestParam(\"agentId\") @NotBlank String agentId,\n            @RequestParam(\"timestamp\") Timestamp timestamp) {\n        AgentStatus result = this.agentInfoService.findAgentStatus(agentId, timestamp.getEpochMillis());\n        if (result == null) {\n            throw new ResponseStatusException(HttpStatus.NOT_FOUND, \"agent status not found\");\n        }\n        return result;\n    }\n\n    @GetMapping(value = \"/getAgentEvent\")\n    public AgentEvent getAgentEvent(","sourceCodeStart":76,"sourceCodeEnd":112,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/web/src/main/java/com/navercorp/pinpoint/web/authorization/controller/AgentInfoController.java#L76-L112","documentation":"ResponseStatusException(NOT_FOUND) in getDetailedAgentInfo: agentInfoService.findDetailedAgentInfoAndStatus returned null, meaning no agent matching the agentId/timestamp pair exists in the collector's stored agent information.","triggerScenarios":"GET /getDetailedAgentInfo?agentId=X&timestamp=Y with an unknown agentId or a timestamp outside the agent's recorded lifespan.","commonSituations":"Stale dashboards pointing at removed agents; clock/timezone mistakes making the timestamp fall outside data retention; data purged before the queried time.","solutions":["Confirm the agentId and pick a timestamp within its active period","Check data retention/TTL settings on the HBase agentinfo table","Fall back to /getAgentInfo to confirm basic data exists"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":"long epochMillis = timestamp.getEpochMillis(); if (epochMillis <= 0) throw new IllegalArgumentException(\"timestamp required\");","typeGuard":null,"tryCatchPattern":"try { return api.getDetailedAgentInfo(id, ts); } catch (ResponseStatusException e) { if (e.getStatus() == HttpStatus.NOT_FOUND) return null; throw e; }","preventionTips":["Verify the agentId and use epoch-millis timestamps within its active period","Check data retention/TTL so queries stay within retained data","Prefer listing agents first, then querying details for known ids"],"tags":["http-404","rest-api","agent-info","not-found"],"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-14T05:17:10.506Z"}