LoongSuite Java Agent

Introduction

LoongSuite Java Agent is a key component of LoongSuite, Alibaba's unified observability data collection suite, providing instrumentation for Java applications.

LoongSuite includes the following key components:

• LoongCollector: universal node agent, which provides log collection, prometheus metric collection, and network and security collection capabilities based on eBPF.
• LoongSuite Java Agent: a process agent providing instrumentation for java applications.
• LoongSuite Python Agent: a process agent providing instrumentation for python applications.
• LoongSuite Go Agent: a process agent for golang with compile time instrumentation.
• Other upcoming language agent.

LoongSuite Java Agent is also a customized distribution of upstream OTel Java Agent, with enhanced support for Alibaba extensions and popular AI agent framework.

Supported libraries, frameworks, and application servers

We support an impressively huge number
of libraries and frameworks and
a majority of the most
popular application servers...right out of the
box!
Click here to see the full list and to learn more about
disabled instrumentation
and how to suppress unwanted instrumentation.

Supported extensions

Extensions add new features and capabilities to the agent without
having to create a separate distribution or to fork this repository. For example, you can create
custom samplers or span exporters, set new defaults, and embed it all in the agent to obtain a
single jar file.

• DemoIdGenerator - Custom trace and span ID generation
• DemoPropagator - Custom context propagation across service boundaries
• DemoSampler - Custom sampling strategies for trace collection
• DemoSpanProcessor - Custom span processing and enrichment
• DemoSpanExporter - Custom telemetry export destinations
• DemoAutoConfigurationCustomizerProvider - Custom agent configuration customization
• DemoServlet3InstrumentationModule - Additional instrumentation for specific framework

These examples serve as templates for creating your own custom extensions.

Troubleshooting

To turn on the agent's internal debug logging:

-Dotel.javaagent.debug=true

Note: These logs are extremely verbose. Enable debug logging only when needed.
Debug logging negatively impacts the performance of your application.

Community

We are looking forward to your feedback and suggestions. You can join
our DingTalk user group and DingTalk developer group
to engage with us.

Resources

• AgentScope: https://github.com/modelscope/agentscope
• Observability Community: https://observability.cn