0.22.0

This is an early release for beta testing. See the documentation for more information.

New Features

• New user events list command to query user events with powerful filtering and expression-based column extraction.

Bug Fixes

• Fix catching "IllegalStateException: No credentials available." stack trace into just an error message.

Full Changelog: 0.21.0...0.22.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.22.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.21.0

This is an early release for beta testing. See the documentation for more information.

New Features

• The nodes list command now supports several search criteria, pagination, and sorting options.
• Add --source-id option to the cloud-integrations datum-streams poll-tasks list and cloud-integrations datum-streams rake-tasks list commands to look up poll/rake tasks associated with datum streams configured with a given source ID.
• Create display-mode and zone global configuration settings, to be able to apply those as defaults while still allowing --display-mode and --time-zone options.
• Add --min-offset, --max-offset, and --offset options to the cloud-integrations datum-streams rake-tasks change-state command to narrow the range of tasks updated to specific tasks based on their offset property.
• New datum date-range command to discover the datum time range available on a node.
• New datum imports monitor command to interactively monitor the progress of a datum import.
• New datum delete view command to inspect datum delete job information.
• New datum delete range command to submit datum delete jobs for datum matching a time range.
• New datum delete ids command to delete small batches of datum matching specific identifiers.
• Add --expand-json option to the datum list command to change the JSON display mode to output "general" datum objects instead of "stream" datum arrays.
• Add datum stale-aggregates list command to view stale datum aggregate records.
• Add datum stale-aggregates mark command to create stale datum aggregate records.

Breaking Changes

• The cloud-integrations datum-streams rake-tasks list command, in PRETTY and CSV display mode, swapped the order of the Stream ID and Task ID columns, for a more natural group ordering.
• Change the datum imports confirm-staged, retract, submit, and view commands JSON display mode to output a top-level object, instead of a singleton array.
• The nodes list command now calls the /nodes/find API and the output structure has changed as a result. The JSON output in particular has changed from an array of arrays to an array of objects.

Bug Fixes

• Fix the cloud-integrations datum-streams poll-tasks change-state and rake-tasks change-state commands to show the changed state, not the previous state.

Full Changelog: 0.20.0...0.21.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.21.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.20.0

This is an early release for beta testing. See the documentation for more information.

New Features

• New cloud-integrations datum-streams imports submit command to submit datum import jobs.
• New cloud-integrations datum-streams imports view command to view datum import jobs by their ID.
• New cloud-integrations datum-streams imports list command to list datum import jobs matching search criteria.
• New cloud-integrations datum-streams imports preview-staged command to preview staged datum import jobs.
• New cloud-integrations datum-streams imports retract command to cancel staged datum import jobs.
• New cloud-integrations datum-streams imports update command to update staged datum import job configuration.
• New cloud-integrations datum-streams imports confirm-staged command to confirm staged datum import jobs, so they start getting processed.
• Gobal configuration, initially to support developers working on s10k itself.

Changes

• Show default option values (that have default values) in command help output.

Full Changelog: 0.19.0...0.20.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.20.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.19.0

This is an early release for beta testing. See the documentation for more information.

New Features

• New cloud-integrations datum-streams datum command to query for a cloud provider's data.
• New cloud-integrations datum-streams poll-tasks change-state command to enable/disable poll tasks.
• New cloud-integrations datum-streams rake-tasks change-state command to enable/disable rake tasks.
• New cloud-integrations datum-streams update command to update cloud datum stream entities.

Changes

• Allow omitting the --integration-id option if --stream-id is provided in the cloud-integrations datum-streams data-values command.
• Allow case-insensitive enumeration values, to reduce the level of shouting on the command line. For example you can now specify --display-mode json instead of --display-mode JSON.

Fixes

• Fix a crash in the datum list command when trying to render datum results that included stream metadata with no properties.

Full Changelog: 0.18.0...0.19.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.19.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.18.0

This is an early release for beta testing. See the documentation for more information.

New Features

• Add new search filter options to cloud-integrations datum-streams list and cloud-integrations integrations list commands:
  • --enabled show only enabled
  • --disabled show only disabled
  • --integration-id filter by Cloud Integration (or associated Cloud Integration)
  • --name filter by name using a case-insensitive substring search
  • --mapping-id filter by associated Cloud Datum Stream Mapping
  • --service filter by service identifier

Full Changelog: 0.17.0...0.18.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.18.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.17.0

This is an early release for beta testing. See the documentation for more information.

New Features

• New cloud-integrations datum-streams data-values command to inspect a cloud provider's data value hierarchy.
• New instructions controls orchestrate command to schedule control changes.

Full Changelog: 0.15.0...0.17.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.17.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.15.0

This is an early release for beta testing. See the documentation for more information.

New Features

• Add --stream-type option to the cloud-integrations datum-streams report command to support limiting the report to certain providers.
• Add --node-id and --source-id options to the cloud-integrations datum-streams list command to match on node and source ID configurations.
• Add --node-id and --source-id options to the cloud-integrations datum-streams view command to match on node and source ID configurations.

Full Changelog: 0.14.0...0.15.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.15.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.14.0

This is an early release for beta testing. See the documentation for more information.

Fixes

• The cloud-integrations datum-streams view and cloud-integrations datum-streams rake-tasks create commands now work in JSON output mode.

Changes

• The cloud-integrations datum-streams view command in JSON output mode now generates a single top-level object with a nested properties property that is an array of all mapped property objects.

Full Changelog: 0.13.0...0.14.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.14.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.13.0

This is an early release for beta testing. See the documentation for more information.

New features

• New version command to output the tool version (also available via --version option)

Changes

• The tool is now built using Github Actions, and published to a Homebrew Tap.

Full Changelog: 0.12.0...0.13.0

Install

Homebrew (macOS/Linux)

You can install the s10k native binary using Homebrew by installing the SolarNetwork/tap tap's sn-cli package:

# add the SolarNetwork tap
brew tap solarnetwork/tap

# trust the SolarNetwork tap
brew trust solarnetwork/tap

# install the sn-cli package
brew install sn-cli

Manual

The *.jar file is an executable Java JAR and requires Java 25+ to run. Run with java -jar s10k-0.13.0.jar.

The *.tar.gz archives are native compiled binaries that do not require Java. Download the one appropriate for your system, which will contain the s10k executable.

0.12.6

This release has nothing new from the 0.12.0 release, but it is built as a test, using new automation scripts.