pinpoint-apm/pinpoint · info

AgentOption

Error message

AgentOption : {}

What it means

Not an exception: this is a WARN-level log line emitted by DefaultAgent.dumpAgentOption when the Pinpoint agent starts. It prints the simple class name of the agent's JMX ObjectName (e.g. ObjectNameV4) as a header for the agent option dump. Seeing it simply means the agent booted and logged its configuration for diagnostics.

Solutions

1. No fix required; this line is informational.
2. If the class name printed is unexpected, check pinpoint.config for v3/v4 ObjectName settings (service name / apikey fields).
3. Adjust log level (log4j2) for com.navercorp.pinpoint.profiler if you want to suppress startup dumps.

When it happens

Trigger: Every agent startup that reaches dumpAgentOption(AgentContextOption) — DefaultAgent constructor/start path calls it unconditionally to log the resolved ObjectName.

Common situations: Appears in startup logs during normal Pinpoint agent boot; frequently pasted into issue reports while debugging misconfigured agentId/applicationName.

Related errors

• - agentId
• - agentName
• - applicationName
• - serviceName
• - apikey

AI-assisted analysis of pinpoint-apm/pinpoint@744c3d3075 (2026-09-07). Data as JSON: /api/errors/fb94aaf925c30c8e. Report an issue: GitHub.

Appendix: source

Thrown at agent-module/profiler/src/main/java/com/navercorp/pinpoint/profiler/DefaultAgent.java:136

        } catch (ObjectNameValidationFailedException e) {
            System.err.printf("ObjectName validation failed %s %s", e.getAgentIdType(), e.getMessage());
            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");

View on GitHub (pinned to 744c3d3075)