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 prodivdes log collection, prometheus metric collection, and network and security collection capabilities based on eBPF.
- LoongSuite Java Agent: a process agent providing instrumentaion for java applications.
- LoongSuite Python Agent: a process agent providing instrumentaion 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.
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.
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
- DemoPropagator - Custom context propagation implementation
- DemoServlet3InstrumentationModule - Additional instrumentation for specific framework
These examples serve as templates for creating your own custom extensions.
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.
We are looking forward to your feedback and suggestions. You can join our DingTalk user group and DingTalk developer group to engage with us.
User Group | Developer Group |
---|---|
![]() |
![]() |
- AgentScope: https://github.com/modelscope/agentscope
- Observability Community: https://observability.cn