Voice
Loongsuite Js Plugins
By OpenTelemetry instrumentation plugins for JavaScript-based AI coding agents. Collect traces, tool calls, and LLM metrics from Claude Code and OpenClaw — zero code changes required.
Install
npm install
npmREADME
# loongsuite-js-plugins
---
## ✨ Introduction
[](https://github.com/alibaba/loongsuite-js-plugins/actions/workflows/ci.yml)
[](LICENSE)
[](https://nodejs.org)
[](https://opentelemetry.io)
LoongSuite JS Plugins is a key component of LoongSuite, Alibaba's unified observability data collection suite, providing OpenTelemetry instrumentation plugins for JavaScript-based AI coding agents. Collect traces, tool calls, and LLM metrics from [Claude Code](https://www.anthropic.com/claude-code) and [OpenClaw](https://openclaw.ai) — zero code changes required.
LoongSuite includes the following key components:
* [LoongCollector](https://github.com/alibaba/loongcollector): universal node agent, which provides log collection, Prometheus metric collection, and network and security collection capabilities based on eBPF.
* [LoongSuite Python Agent](https://github.com/alibaba/loongsuite-python-agent): a process agent providing instrumentation for Python applications.
* [LoongSuite Go Agent](https://github.com/alibaba/loongsuite-go-agent): a process agent for Golang with compile time instrumentation.
* [LoongSuite Java Agent](https://github.com/alibaba/loongsuite-java-agent): a process agent for Java applications.
* [LoongSuite JS Plugins](https://github.com/alibaba/loongsuite-js-plugins): OpenTelemetry instrumentation plugins for JavaScript-based AI coding agents.
* Other upcoming language agents.
---
## 📦 Plugins
| Plugin | Platform | Description |
|--------|----------|-------------|
| [opentelemetry-instrumentation-claude](./opentelemetry-instrumentation-claude/) | Claude Code | Hook-based session tracing + in-process LLM call capture via `intercept.js` |
| [opentelemetry-instrumentation-openclaw](./opentelemetry-instrumentation-openclaw/) | OpenClaw | Native gateway plugin: Traces + Metrics to any OTLP backend |
Both plugins follow the [OpenTelemetry GenAI semantic conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/) and work with any OTLP-compatible backend (Jaeger, Honeycomb, Alibaba Sunfire, Grafana Tempo, Alibaba Cloud ARMS, etc.).
---
## ⚡ Quick Start
### Claude Code — 5 minutes to first trace
**One-line install (with OTLP backend):**
```bash
curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/agenttrack/remote-install.sh | bash -s -- \
--endpoint "https://your-otlp-endpoint:4318" \
--service-name "my-claude-agent"
```
The script automatically installs hooks, sets up the `claude` alias, and writes the OTLP config to your shell profile. Traces appear in your backend automatically. The Span tree looks like:
```
🤖 Claude Session: "Analyze this codebase..."
├── 👤 Turn 1: Analyze this codebase...
│ ├── 🔧 Read: /src/index.js gen_ai.span.kind=TOOL
│ ├── 🔧 Bash: npm test gen_ai.span.kind=TOOL
│ └── 🧠 LLM call (claude-sonnet-4-5) gen_ai.span.kind=LLM
│ ├── input_tokens: 2048
│ └── output_tokens: 512
└── 👤 Turn 2: ...
```
📖 [Full documentation → opentelemetry-instrumentation-claude](./opentelemetry-instrumentation-claude/README.md)
---
### OpenClaw — one-line install
```bash
curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/opentelemetry-instrumentation-openclaw/install.sh | bash -s -- \
--endpoint "https://your-otlp-endpoint:4318" \
--serviceName "my-openclaw-agent"
```
📖 [Full documentation → opentelemetry-instrumentation-openclaw](./opentelemetry-instrumentation-openclaw/README.md)
---
## 🏗️ Repository Structure
```
loongsuite-js-plugins/
├── opentelemetry-instrumentation-claude/ # Claude Code plugin (JavaScript)
│ ├── src/ # Core source files
│ ├── test/ # Jest test suite (101 tests)
│ ├── scripts/ # Install / uninstall / pack scripts
│ ├── bin/otel-claude-hook # CLI entry point
│ └── README.md
└── opentelemetry-instrumentation-openclaw/ # OpenClaw platform plugin (TypeScript)
├── src/ # TypeScript source files
├── scripts/ # Install / uninstall scripts
└── README.md
```
---
## 🛠️ Development
### Prerequisites
- Node.js >= 18.0.0
- npm >= 8.0.0
### Clone and set up
```bash
git clone https://github.com/alibaba/loongsuite-js-plugins.git
cd loongsuite-js-plugins
# Claude plugin
cd opentelemetry-instrumentation-claude
npm install
npm test
# OpenClaw plugin (TypeScript, requires build)
cd ../opentelemetry-instrumentation-openclaw
npm install
npm run build
```
### Run tests
```bash
cd opentelemetry-instrumentation-claude
npm test # run tests
npm test -- --coverage # with coverage report
```
### Commit style
Follow [Conventional Commits](https://www.conventionalcommits.org/):
```
feat: new feature
fix: bug fix
docs: documentation changes
test: test additions or fixes
refactor: code refactoring
perf: performance improvements
chore: build / toolchain
```
---
## 🔧 Environment Variables
### Common OTel variables
| Variable | Description | Example |
|----------|-------------|---------|
| `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP export endpoint | `https://your-backend:4318` |
| `OTEL_EXPORTER_OTLP_HEADERS` | Request headers (comma-separated) | `x-api-key=your-key` |
| `OTEL_SERVICE_NAME` | Service name for traces | `my-claude-agent` |
| `OTEL_RESOURCE_ATTRIBUTES` | Additional resource attributes | `env=prod,team=infra` |
### Claude plugin specific
| Variable | Description |
|----------|-------------|
| `CLAUDE_TELEMETRY_DEBUG` | Set to `1` for console output (no backend needed) |
| `OTEL_CLAUDE_DEBUG` | Set to `1` for verbose `intercept.js` logging |
| `OTEL_CLAUDE_LANG` | Force language: `zh` or `en` (default: auto-detect) |
| `OTEL_CLAUDE_HOOK_CMD` | Override hook command name |
---
## 🤝 Contributing
Contributions are welcome! Please read the contributing guide for the plugin you're working on:
- [opentelemetry-instrumentation-claude/CONTRIBUTING.md](./opentelemetry-instrumentation-claude/CONTRIBUTING.md)
- [opentelemetry-instrumentation-openclaw/CONTRIBUTING.md](./opentelemetry-instrumentation-openclaw/CONTRIBUTING.md)
**Summary:**
1. Fork the repo and create a feature branch from `main`
2. Make your changes (follow Conventional Commits)
3. Ensure tests pass: `npm test`
4. Open a Pull Request
Please also read our [Code of Conduct](./CODE_OF_CONDUCT.md).
---
## 📄 License
Apache-2.0 — see [LICENSE](./LICENSE) for details.
---
## 🔗 Related
- [OpenTelemetry](https://opentelemetry.io)
- [OpenTelemetry GenAI Semantic Conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
- [Claude Code](https://www.anthropic.com/claude-code)
- [OpenClaw](https://openclaw.ai)
## Community
We are looking forward to your feedback and suggestions. You can join
our [DingTalk group](https://qr.dingtalk.com/action/joingroup?code=v1,k1,66L9GmXJMuW04ueT1Xl52pV43X2cphzO3yiGuLCm3ks=&_dt_no_comment=1&origin=11?) or scan the QR code below to engage with us.
| LoongSuite JS SIG | LoongCollector SIG | LoongSuite Python SIG |
|----|----|----|
| <img src="docs/_assets/img/loongsuite-js-sig-dingtalk.jpg" height="150"> | <img src="docs/_assets/img/loongcollector-sig-dingtalk.jpg" height="150"> | <img src="docs/_assets/img/loongsuite-python-sig-dingtalk.jpg" height="150"> |
| LoongCollector Go SIG | LoongSuite Java SIG |
|----|----|
| <img src="docs/_assets/img/loongsuite-go-sig-dingtalk.png" height="150"> | <img src="docs/_assets/img/loongsuite-java-sig-dingtalk.jpg" height="150"> |
voice
Comments
Sign in to leave a comment