pinpoint-apm/pinpoint · info
- agentName: {}
Error message
- agentName: {} What it means
Info log in DefaultAgent.dumpAgentOption: dumps the effective agent configuration at startup, including the configured agentName, so users can verify which options the running agent actually picked up.
Source
Thrown at agent-module/profiler/src/main/java/com/navercorp/pinpoint/profiler/DefaultAgent.java:138
throw e;
}
}
protected AgentContextOption buildContextOption(AgentOption agentOption, ObjectName objectName, ProfilerConfig profilerConfig) {
return AgentContextOptionBuilder.build(agentOption, objectName, profilerConfig);
}
private AgentSystemConfig agentSystemConfig(ObjectName objectName) {
AgentSystemConfig agentSystemConfig = new AgentSystemConfig(objectName.getAgentId(), Version.VERSION);
agentSystemConfig.dump(System.getProperties());
return agentSystemConfig;
}
private void dumpAgentOption(AgentContextOption agentOption) {
final ObjectName objectName = agentOption.getObjectName();
logger.warn("AgentOption : {}", objectName.getClass().getSimpleName());
logger.warn("- agentId: {}", objectName.getAgentId());
logger.warn("- agentName: {}", objectName.getAgentName());
logger.warn("- applicationName: {}", objectName.getApplicationName());
if (objectName instanceof ObjectNameV4) {
ObjectNameV4 v4 = (ObjectNameV4) objectName;
logger.warn("- serviceName: {}", objectName.getServiceName());
logger.warn("- apikey: {}", MaskUtils.masking(v4.getApiKey(), 2));
}
logger.info("- instrumentation: {}", agentOption.getInstrumentation());
}
private LoggingSystem newLoggingSystem(Path agentPath) {
return Log4j2LoggingSystem.searchPath(agentPath);
}
protected ApplicationContext newApplicationContext(AgentContextOption agentOption) {
Objects.requireNonNull(agentOption, "agentOption");
ProfilerConfig profilerConfig = Objects.requireNonNull(agentOption.getProfilerConfig(), "profilerConfig");
View on GitHub (pinned to 744c3d3075)
Solutions
- No action needed.
- Set agentName in pinpoint.config if you want a human-readable display name in the Pinpoint UI.
- Remember agentName is optional; null output is normal.
Defensive patterns
Strategy: validation
Prevention
- Set pinpoint.agentName explicitly if you rely on display names.
- A null agentName in this dump is normal and harmless.
When it happens
Trigger: Agent startup, always emitted as part of the option dump.
Common situations: Verifying that an agentName override (-Dpinpoint.agentName or config) took effect; noticing it is null when a display name was expected.
Related errors
- - agentId: {}
- - applicationName: {}
- Unknown AgentType:
- Failed to detect pinpoint profile. Please add -Dpinpoint.act
- 'log4j2-agent.xml' not found. agentPath:${profilePath}
AI-assisted analysis of pinpoint-apm/pinpoint@744c3d3075 (2026-09-07).
Data as JSON: /api/errors/97c46ec0e84b87f6.
Report an issue: GitHub.