Repository navigation
Releases
v1.1.0
1.1.0 (2026-11-12)
Features
- ✨ Group profile SQL steps by hash (b1dd2fa)
- ✨ List objects by Collector storage date (8a25b30)
- ✨ Resolve XLog dictionary text on request (08a59fd)
- ✨ Show approved Agent configuration values (a7af022)
- ✨ Show timing and network outcomes in live profiles (672dacf)
- 🔀 Promote Collector diagnostics and capture improvements (#87) (30d6106)
Bug Fixes
- 🐛 Avoid duplicate profile capture resume scans (defecb2), closes #74
- 🐛 Clarify sensitive values in profile error text (2ad5f49)
- 🐛 Diagnose Windows file ancestors before missing paths (df26cd3), closes #75
- 🐛 Explain invalid capture directory paths (53d4c1b), closes #75
- 🐛 Improve command help and option diagnostics (22c81fa), closes #65
- 🐛 Report unverified XLog storage dates (8d0cbf5)
- 🐛 Retry denied Windows file replacements (da33d93), refs #58
- 🐛 Validate reported Collector time zones (10c2019), refs #57
Compatibility and remaining limitations
- Persisted capture formats remain unchanged. Individual profile steps remain the default; live JSON includes additive diagnostics and step fields, so strict consumers need unknown-key tolerance.
- Time-zone checks use the reported Collector JVM property and client rules; they do not verify storage calendars. #57 remains open.
- Windows retries handle bounded access denial; the original intermittent deployment failure has not been reproduced and its cause remains unconfirmed. #58 remains open.
- Resume validation avoids duplicate page reads but retains cumulative scaling limits across repeated resumes.
v1.0.0
scouterctl 1.0.0
The first stable release of scouterctl.
scouterctl brings Scouter diagnostics and data extraction to a shared command interface for people, scripts and other tools.
Included
- Collector/Agent status, settings inspection and real-time counters.
- Stored counter history as JSONL, with units and missing-value metadata.
- Multi-day counter export with checkpointed resume and file integrity checks.
- Transaction, SQL and error profiles; saved captures for offline search, summary and comparison.
- Named connections, explicit terminal password input and noninteractive JSON/JSONL with stable error codes.
- Linux x64 and native Windows x64 command packages: run
scouterctl <command>with an installed JDK 21.
The explicit 18-release Collector list is validated separately from JVM/Agent/framework combinations. Collector processes can run Java 8 independently of the CLI. See supported versions.
Install and upgrade
Download the platform ZIP and SHA256SUMS from this release, verify it, extract into a versioned directory and add bin to PATH. Keep configuration and captures outside installations. Upgrade by switching PATH; switch back to roll back. See installation.
Published 0.x POC JAR assets are replaced by command ZIPs for end users. Scripts that downloaded *-poc.zip should select the matching *-linux-x64.zip or *-windows-x64.zip. JDK 21 remains external; Node is not required. Existing XLog capture formats retain their documented read/resume rules, and counter captures use a separate schema.
Boundaries
Initial platform support is Linux x64 and Windows x64. Active-request snapshots, thread dumps, configuration changes and Agent control remain later work. Keep emoji out of Windows installation paths; Unicode arguments and saved-data paths are supported.
Capture completion means extraction completed, not that telemetry was lossless. Units describe current Collector definitions; missing samples are not zero-filled. Counter export buffers each response, retains completed windows without refreshing late arrivals, and has the limits described in counter export. Collector TCP requires a trusted network or a separately secured tunnel.
v0.3.0
What changes
Adds offline comparison of two v2 captures with inspect compare --before DIR --after DIR. Compare captured request/error counts and total, average and maximum request duration by service. Error-rate differences use percentage points, and every delta is after minus before.
The result retains each capture's source, object, time window, sampling, completeness and missing-profile context. One-sided observations and known service-name conflicts do not receive fabricated deltas. Each input supports up to 1,000 services; an oversized or damaged input is rejected rather than silently truncated.
Upgrade and compatibility
Use JDK 21 and extract the new package into a separate directory. Keep capture directories separate from the installation. Existing v2 captures need no migration. Older transaction-only v1 captures are not accepted by offline inspection. Online commands remain limited to Collector 2.21.3.
Comparison requires no Collector or credentials. Text stays omitted unless --include-text is requested and both captures contain it. Successful comparison does not establish identical workloads or complete traffic coverage. Windows installation paths and command arguments retain the documented ASCII limitation; capture text and JSON output remain UTF-8.
Validation
The same ZIP passed 122 Kotest tests on each of Linux, Windows, and macOS. Its extracted JAR passed actual Spring/Collector/Agent checks on Linux, existing v0.1.0/v0.2.1 capture compatibility, and native Windows/Linux output comparisons. Earlier 100,000-record scale results apply to identical class bytes and remain bounded synthetic-file evidence, not production throughput guarantees.
Evaluation prerelease. Download the ZIP and SHA256SUMS below; verify the checksum before extracting.
v0.2.1
v0.2.0
0.2.0 (2026-11-03)
Features
- ✨ Add offline service error and latency summaries (#16) (e7c771f)
- ✨ Add saved connections and hidden terminal password input (#15) (c6bc266)
Bug Fixes
- 🐛 Improve initial Collector connection diagnostics (#14) (1f7f6c1)
- 🐛 Preserve UTF-8 JSON output on Windows (2a74318)
This PR was generated with Release Please. See documentation.
v0.1.0
scouterctl 0.0.0 POC
Initial 0.0.0 POC for read-only access to Scouter Collector 2.21.3.
Included
- Collector connectivity, authentication, and version checks.
- Object discovery, paginated XLog queries, and structured transaction profiles with SQL execution metadata.
- JSON/JSONL output, string-encoded 64-bit identifiers, and explicit exit codes.
- Resumable capture with a manifest and SHA-256 integrity checks.
Download and run
Download scouterctl-0.0.0-poc.zip and SHA256SUMS, then verify the archive with sha256sum -c SHA256SUMS. Extract the ZIP and follow its English README. JDK 21 is required; the Java runtime, Collector, and Agent are installed separately.
Validation
- Six CLI contract tests.
- Real Collector ingestion and queries checked against an independent Java reference probe.
- Instrumented HTTP service: 36 requests, 36 XLogs, six errors, and capture resume across eight pages.
- Spring Boot Servlet instrumentation: 12 API requests, 18 profiles including error dispatches, and nine SQL profiles; application exceptions and duplicate-key SQL errors distinguished.
Validated on Linux/WSL with Collector 2.21.3. Commands and output formats may change. TCP has no built-in TLS; use a trusted network or SSH/VPN tunnel. SQL and exception text, bind values, and name resolution are not included. This POC does not promise production readiness or complete traffic coverage.