Skip to content

Releases

v1.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 07:08
a8deaee

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

Choose a tag to compare

@oxspan oxspan released this 07 Nov 08:36
12ae2d9

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

v0.3.0 Pre-release
Pre-release

Choose a tag to compare

@oxspan oxspan released this 04 Nov 15:30
d96ea7e

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.

Quick start · Changelog

v0.2.1

v0.2.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 04 Nov 07:30
a0828bc

0.2.1 (2026-11-04)

Bug Fixes

  • 🐛 Verify native terminal input and correct Windows cancellation hint (#23) (f0d8edd)

v0.2.0

v0.2.0 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 03 Nov 18:14
769c922

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

v0.1.0 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 02 Nov 06:41
6c9b0b3

0.1.0 (2026-11-02)

Features

  • ✨ Capture profiles and inspect evidence offline (#6) (1be146b)
  • ✨ Search and summarize captured requests offline (#7) (7cc5097)
  • resolve profile service SQL and error text (#5) (53b59fe)

Bug Fixes

  • 🐛 Preserve branches when selecting a PR template (#12) (4e1c481)
  • build: synchronize versions and automate POC releases (a5c32d2)

scouterctl 0.0.0 POC

scouterctl 0.0.0 POC Pre-release
Pre-release

Choose a tag to compare

@oxspan oxspan released this 01 Nov 21:45

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.