Skip to content
Back to search

glowroot

Easy to use, very low overhead, Java APM

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/glowroot/glowroot with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/glowroot/glowroot'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/glowroot--glowroot/badge.svg)](/listings/glowroot--glowroot)

HTML

<a href="/listings/glowroot--glowroot"><img src="/api/listings/glowroot--glowroot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Download and unzip the latest **stable** agent distribution from [GitHub Releases](https://github.com/glowroot/glowroot/releases/latest) (`glowroot-*-dist.zip`) 2. Add `-javaagent:path/to/glowroot.jar` to your application's JVM args — **before** `-jar` if you use an executable JAR ([where are my application server's JVM args?](https://github.com/glowroot/glowroot/wiki/Where-are-my-application-server's-JVM-args%3F)) 3. Ensure the user that runs the JVM can write to the glowroot folder 4. Start your application 5. Open http://localhost:4000 (wait for a **UI listening on …** line in the agent log)

Post-install details: [Agent Installation (Embedded Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(with-Embedded-Collector)).

**Central collector?** Start with [Agent Installation (for Central Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(for-Central-Collector)) (agents on app JVMs, glowroot-central + Cassandra on a monitor host).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 203 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Glowroot
  2. [![Latest release](https://img.shields.io/github/v/release/glowroot/glowroot?display_name=tag)](https://github.com/glowroot/glowroot/releases/latest)
  3. [![Build](https://github.com/glowroot/glowroot/actions/workflows/build.yml/badge.svg)](https://github.com/glowroot/glowroot/actions/workflows/build.yml)
  4. [![License](https://img.shields.io/github/license/glowroot/glowroot)](https://github.com/glowroot/glowroot/blob/main/LICENSE)
  5. [![Java](https://img.shields.io/badge/Java-8%2B%20agent%20%7C%2017%2B%20central-blue)](https://github.com/glowroot/glowroot#requirements)
  6. [![GitHub stars](https://img.shields.io/github/stars/glowroot/glowroot)](https://github.com/glowroot/glowroot/stargazers)
  7. [![GitHub forks](https://img.shields.io/github/forks/glowroot/glowroot)](https://github.com/glowroot/glowroot/network/members)
  8. [![Contributors](https://img.shields.io/github/contributors/glowroot/glowroot)](https://github.com/glowroot/glowroot/graphs/contributors)
  9. [![Discussions](https://img.shields.io/github/discussions/glowroot/glowroot)](https://github.com/glowroot/glowroot/discussions)
  10. **Easy to use, very low overhead, open source Java APM.**
  11. - **(Very) easy to use** — drop in a `-javaagent`, open the UI, see traces and profiles
  12. - **Very (very) low overhead** — tuned with extensive microbenchmarking
  13. - **Embedded or central** — local H2 collector out of the box, or scale out with a central collector
  14. **Website:** [glowroot.org](https://glowroot.org/) ·
  15. **Features:** [glowroot.org/features](https://glowroot.org/features.html) ·
  16. **Releases:** [GitHub Releases](https://github.com/glowroot/glowroot/releases) ·
  17. **UI preview:** [archived demo snapshot](https://web.archive.org/web/20230325052222/https://demo.glowroot.org/)
  18. (the live `demo.glowroot.org` host is currently unreachable — see [#1102](https://github.com/glowroot/glowroot/issues/1102))
  19. ## Features
  20. - Trace capture for slow requests and errors
  21. - Continuous profiling (with filtering) and flame graphs
  22. - Response time breakdown and percentile charts
  23. - SQL and service-call capture with aggregation
  24. - MBean attribute capture and charts
  25. - Configurable alerting and historical rollups
  26. - Full support for async requests that span multiple threads
  27. - Responsive UI (including mobile)
  28. - Optional central collector
  29. See the full list and instrumentation coverage on the [features](https://glowroot.org/features.html) and [instrumentation](https://glowroot.org/instrumentation.html) pages.
  30. ## Requirements
  31. * Java 8+ for the agent
  32. * Java 17+ for glowroot-central
  33. ## Quick start (embedded)
  34. 1. Download and unzip the latest **stable** agent distribution from [GitHub Releases](https://github.com/glowroot/glowroot/releases/latest) (`glowroot-*-dist.zip`)
  35. 2. Add `-javaagent:path/to/glowroot.jar` to your application's JVM args — **before** `-jar` if you use an executable JAR
  36. ([where are my application server's JVM args?](https://github.com/glowroot/glowroot/wiki/Where-are-my-application-server's-JVM-args%3F))
  37. 3. Ensure the user that runs the JVM can write to the glowroot folder
  38. 4. Start your application
  39. 5. Open http://localhost:4000 (wait for a **UI listening on …** line in the agent log)
  40. Post-install details:
  41. [Agent Installation (Embedded Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(with-Embedded-Collector)).
  42. **Central collector?** Start with [Agent Installation (for Central Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(for-Central-Collector)) (agents on app JVMs, glowroot-central + Cassandra on a monitor host).
  43. ## Deployment
  44. | Mode | What you run | Typical use |
  45. |------|----------------|-------------|
  46. | **Embedded** (default) | `-javaagent` + local H2 + UI in the **same JVM** as your app | Single app, dev, small installs |
  47. | **Central** | `-javaagent` on each app JVM → **glowroot-central** (+ Cassandra) on a monitor host | Many agents, shared UI, longer retention |
  48. Central needs its own install — see [Agent Installation (for Central Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(for-Central-Collector)) and [Central Collector with Docker](https://github.com/glowroot/glowroot/wiki/Central-Collector-with-Docker). Embedded JSON/H2 storage is **not** a substitute for Central.
  49. ## Documentation
  50. | Topic | Wiki |
  51. |-------|------|
  52. | Wiki home | [github.com/glowroot/glowroot/wiki](https://github.com/glowroot/glowroot/wiki) |
  53. | Embedded vs Central | [Choosing Embedded vs Central](https://github.com/glowroot/glowroot/wiki/Choosing-Embedded-vs-Central) |
  54. | Embedded install | [Agent Installation (with Embedded Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(with-Embedded-Collector)) |
  55. | Central install | [Agent Installation (for Central Collector)](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(for-Central-Collector)) |
  56. | Central on Docker | [Central Collector with Docker](https://github.com/glowroot/glowroot/wiki/Central-Collector-with-Docker) |
  57. | Troubleshooting | [Troubleshooting Tips](https://github.com/glowroot/glowroot/wiki/Troubleshooting-Tips) |
  58. | JBoss / WildFly `GeneratedMethodMeta` CNFE | See FAQ below (`jboss.modules.system.pkgs`) · [#1112](https://github.com/glowroot/glowroot/issues/1112) |
  59. | Storage (H2 / Cassandra TTL) | [Administration-Storage](https://github.com/glowroot/glowroot/wiki/Administration-Storage) |
  60. | HTTP `/health` vs `/readiness` (0.14.8+) | [docs/health-endpoints.md](docs/health-endpoints.md) · [0.14.8 upgrade notes](docs/0.14.8-upgrade-notes.md) |
  61. | Embedded H2 1.x → 2.x upgrade | [docs/embedded-h2-upgrade.md](docs/embedded-h2-upgrade.md) |
  62. | Plugins / custom Instrumentation | [Plugins](https://github.com/glowroot/glowroot/wiki/Plugins) · [Instrumentation](https://github.com/glowroot/glowroot/wiki/Instrumentation) |
  63. | Empty Queries / Service Calls / Web? | [Plugin coverage gaps](https://github.com/glowroot/glowroot/wiki/Plugin-coverage-gaps) · [What Glowroot does not do](https://github.com/glowroot/glowroot/wiki/What-Glowroot-does-not-do) |
  64. | UI orientation (tabs, alerts, gauges, …) | [Transaction tabs](https://github.com/glowroot/glowroot/wiki/Transaction-tabs) · [wiki UI / configuration](https://github.com/glowroot/glowroot/wiki#ui--configuration) |
  65. | JVM thread “Allocated memory” meaning | [docs/jvm-thread-stats-allocated-memory.md](docs/jvm-thread-stats-allocated-memory.md) (wiki paste: [JVM-thread-stats-allocated-memory](https://github.com/glowroot/glowroot/wiki/JVM-thread-stats-allocated-memory)) · [#630](https://github.com/glowroot/glowroot/issues/630) |
  66. | Contributing (modules / engine map) | [For contributors](https://github.com/glowroot/glowroot/wiki/For-contributors) · [Plugin and Pointcut basics](https://github.com/glowroot/glowroot/wiki/Plugin-and-Pointcut-basics) |
  67. | Community Q&A | [GitHub Discussions](https://github.com/glowroot/glowroot/discussions) |
  68. | AI assistant (`glowroot-ops`) | [skills/glowroot-ops/](skills/glowroot-ops/) |
  69. ## FAQ
  70. **Where should I download Glowroot?**
  71. Use the `glowroot-*-dist.zip` from [GitHub Releases](https://github.com/glowroot/glowroot/releases). Do not point production at random JARs from a partial Maven build (`agent/shaded/*` is not the distribution).
  72. **Which Java versions are supported?**
  73. Java **8+** for the agent. Java **17+** for glowroot-central. There is no maintained agent for Java 6/7.
  74. **Spring Boot 3 / Jakarta EE (`jakarta.servlet`)?**
  75. Use a current **0.14.x** agent from Releases.
  76. **The UI does not open / I never see “UI listening”.**
  77. Confirm `-javaagent` is on the JVM that runs your app, the glowroot directory is writable, and nothing else is bound to port 4000. With embedded mode the UI starts after application startup — if the JVM exits immediately, the UI never binds. Bind/port details: [Administration-Web](https://github.com/glowroot/glowroot/wiki/Administration-Web).
  78. **Several JVMs on one host.**
  79. Embedded: give each JVM its own `data.dir` (or use Central). Central: use a **unique `agent.id` per JVM**; you can group agents in the UI with rollup IDs (for example `App::pod` in Kubernetes). See [Multiple JVMs and agent.id](https://github.com/glowroot/glowroot/wiki/Multiple-JVMs-and-agent.id) and [Agents and rollups](https://github.com/glowroot/glowroot/wiki/Agents-and-rollups).
  80. **Agent cannot connect to Central.**
  81. Set `collector.address` to the Central host and **gRPC port (8181 by default)** — not the UI port (4000). Use `host:port` only (no URL path). Check firewall/`nc` from the agent host. See the [Central install wiki](https://github.com/glowroot/glowroot/wiki/Agent-Installation-(for-Central-Collector)) and [Troubleshooting Tips](https://github.com/glowroot/glowroot/wiki/Troubleshooting-Tips).
  82. **H2 “locked by another process”.**
  83. Only one embedded collector may use a given data directory. Stop the other JVM or point `data.dir` / `multi.dir` at separate folders.
  84. **Few traces / empty Queries tab?**
  85. Aggregates cover all traffic; **Traces** only store requests above the slow threshold ([Transaction configuration](https://github.com/glowroot/glowroot/wiki/Transaction-configuration)). **Queries** come from the JDBC plugin, not custom Instrumentation ([Plugins](https://github.com/glowroot/glowroot/wiki/Plugins) · [Transaction tabs](https://github.com/glowroot/glowroot/wiki/Transaction-tabs)).
  86. **Can I run Glowroot together with another Java APM agent?**
  87. Usually **no** — two bytecode-weaving agents on the same JVM is fragile. Pick one agent per process.
  88. **JBoss / WildFly: `ClassNotFoundException: GeneratedMethodMeta*` (or `NoClassDefFoundError`)?**
  89. JBoss Modules isolation: woven app classes get a `MetaHolder` in the deployment `ModuleClassLoader`, but `GeneratedMethodMeta*` / related weaving classes live in the agent/bootstrap loader. Mark Glowroot as a system package so deployments can see those classes:
  90. ```bash
  91. -Djboss.modules.system.pkgs=org.glowroot
  92. ```
  93. If the property is already set (e.g. for Byteman), **append** `org.glowroot` to the comma-separated list. Keep using only `-javaagent:/path/to/glowroot.jar`. Do **not** ship `glowroot.jar` inside the EAR once `system.pkgs` is set. See [#1112](https://github.com/glowroot/glowroot/issues/1112).
  94. ## Support
  95. Pick the channel that fits — it helps everyone respond faster:
  96. | Need | Where |
  97. |------|--------|
  98. | Questions, how-to, configuration doubts, “is this expected?” | **[GitHub Discussions → Q&A](https://github.com/glowroot/glowroot/discussions/categories/q-a)** |
  99. | Ideas, proposals, “would it make sense to…?” | **[GitHub Discussions → Ideas](https://github.com/glowroot/glowroot/discussions/categories/ideas)** |
  100. | Reproducible bugs (with steps, version, logs) | **[GitHub Issues](https://github.com/glowroot/glowroot/issues)** |
  101. | Release announcements / community | [Google Group](https://groups.google.com/forum/#!forum/glowroot) · [@glowroot](https://twitter.com/glowroot) |
  102. **Discussions** (Q&A or Ideas) are usually the best fit for questions and feature ideas. **Issues** work best when you can share Glowroot version, deployment mode (embedded or central), JDK version, and steps to reproduce — that keeps the tracker useful for real defects.
  103. ## AI assistant (`glowroot-ops`)
  104. Portable skill pack for AI tools (Cursor, Claude Code, Copilot, ChatGPT, and others). It helps with install, UI, traces, and JVM questions by **fetching the [live wiki](https://github.com/glowroot/glowroot/wiki)** instead of guessing from model memory.
  105. | What it does | What it does not do |
  106. |--------------|---------------------|
  107. | Classify your question (how-to, expected behavior, bug, idea) | Open GitHub Issues for you |
  108. | Point to the right wiki page | Change configs or JVM args |
  109. | Suggest Discussion vs Issue when unsure | Replace reading the docs |
  110. ### Install
  111. Paste into any coding agent:
  112. ```text
  113. Install the /glowroot-ops skill globally from https://github.com/glowroot/glowroot/tree/main/skills/glowroot-ops
  114. ```
  115. From a local clone of this repo:
  116. ```sh
  117. npx skills add ./skills/glowroot-ops --skill glowroot-ops --global --yes --copy
  118. ```
  119. Windows: `.\skills\glowroot-ops\install.ps1` · macOS/Linux: `./skills/glowroot-ops/install.sh`
  120. ### Customize
  121. Copy [`skills/glowroot-ops/ORG-CONTEXT.md.template`](skills/glowroot-ops/ORG-CONTEXT.md.template) to `ORG-CONTEXT.md` and fill in your install paths, JDK, and app server. The skill uses that file for org-specific advice; the template ships without any vendor data.
  122. ### Use
  123. | Tool | How |
  124. |------|-----|
  125. | **Cursor** | `/glowroot-ops <your question>` |
  126. | **Claude Code** | invoke skill `glowroot-ops` |
  127. | **Any chat** | paste [`PROMPT.md`](skills/glowroot-ops/PROMPT.md) + your question |
  128. Example: `/glowroot-ops Service Calls empty on @Service — is that normal?`
  129. More detail: [`skills/glowroot-ops/README.md`](skills/glowroot-ops/README.md) · [`INSTALL.md`](skills/glowroot-ops/INSTALL.md)
  130. ## Contributing
  131. Build instructions, UI sandbox, integration tests, and code-quality checks: **[CONTRIBUTING.md](CONTRIBUTING.md)**.
  132. Code orientation (modules, agent data path, embedded vs central in the tree): wiki **[For contributors](https://github.com/glowroot/glowroot/wiki/For-contributors)**.
  133. ## Star History
  134. <a href="https://star-history.dera.page/?type=date&repos=glowroot%2Fglowroot#glowroot/glowroot&legend=bottom-right">
  135. <picture>
  136. <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=glowroot/glowroot&theme=dark&legend=bottom-right" />
  137. <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=glowroot/glowroot&legend=bottom-right" />
  138. <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=glowroot/glowroot&legend=bottom-right" />
  139. </picture>
  140. </a>
  141. Chart served by [star-history.dera.page](https://star-history.dera.page/) — a token-free fork that uses public star snapshots (GitHub restricted the stargazers API in 2026).
  142. ## License
  143. Glowroot source code is licensed under the Apache License, Version 2.0.
  144. See [Third Party Software](https://github.com/glowroot/glowroot/wiki/Third-Party-Software) for license detail of third party software included in the binary distribution.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.