v0.4.1

v0.4.1 Release

Changes

• [ENHANCEMENT] Upgrade the Go version used in build images and tests to golang 1.14.9 to match upstream Cortex. #104
• [FEATURE] Add chunktool chunk validate-index and chunktool chunk clean-index commands to the chunktool. These commands are used to scan Cortex index backends for invalid index entries and to clean the invalid entries up if there are any. #104

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.4.1/cortextool_0.4.1_linux_x86_64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

chunktool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/chunktool" "https://github.com/grafana/cortex-tools/releases/download/v0.4.1/chunktool_0.4.1_linux_x86_64"

# make it executable
$ chmod a+x "/usr/local/bin/chunktool"

# have fun :)
$ chunktool --help

Docker images

• docker pull grafana/cortex-tools:latest
• docker pull grafana/cortex-tools:v0.4.1

v0.4.0

Changes

• [ENHANCEMENT] Loadgen: Allow users to selectively disable query or write loadgen by leaving their respective URL configs empty. #95
• [FEATURE] Add overrides-exporter to cortextool, which exports Cortex runtime configuration overrides as metrics. #91

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.4.0/cortextool_0.4.0_linux_x86_64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

Docker images

• docker pull grafana/cortex-tools:latest
• docker pull grafana/cortex-tools:v0.4.0

v0.3.2

Changes

• [BUGFIX] Supports rules lint with LogQL: #92.

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.3.2/cortextool_0.3.2_linux_x86_64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

Docker images

• docker pull grafana/cortex-tools:latest
• docker pull grafana/cortex-tools:v0.3.2

v0.3.1

Changes

• [FEATURE] Add support for GME remote-write rule groups. #82
• [BUGFIX] Fix issue where rule comparisons would be affected by the format of the YAML file. #88

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.3.1/cortextool_0.3.1_linux_x86_64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

Docker images

• docker pull grafana/cortex-tools:latest
• docker pull grafana/cortex-tools:v0.3.1

v0.3.0

Changes

• [FEATURE] Added loki backend support for the rules commands, configurable with --backend=loki (defaults to cortex).
• [FEATURE] Introduces a new version command. The command will also let you know if there's a new version available.

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.3.0/cortextool_0.3.0_linux_x86_64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

Docker images

• docker pull grafana/cortex-tools:latest
• docker pull grafana/cortex-tools:v0.3.0

v0.2.4

Changes

• [BUGFIX] Fix alertmanager registration subcommand and path for the configuration API #72

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.4/cortextool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

chunktool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/chunktool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.4/chunktool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/chunktool"

# have fun :)
$ chunktool --help

logtool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/logtool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.4/logtool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/logtool"

# have fun :)
$ logtool --help

v0.2.3

Changes

• [FEATURE] Added alerts verify command, which can be used to compare ALERTS series in Cortex to verify if Prometheus and Cortex Ruler are firing the same alerts
• [BUGFIX] Renamed module from cortextool to cortex-tools to ensure go get works properly.
• [BUGFIX] When using --disable-color for rules get, it now actually prints rules instead of the bytes of the underlying string
• [ENHANCEMENT] Allow mutualTLS for Cortex API client for rules and alertmanager cmds with:
  • --tls-ca-path or CORTEX_TLS_CA_PATH
  • --tls-cert-path or CORTEX_TLS_CERT_PATH
  • --tls-key-path or CORTEX_TLS_KEY_PATH

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.3/cortextool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

chunktool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/chunktool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.3/chunktool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/chunktool"

# have fun :)
$ chunktool --help

logtool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/logtool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.3/logtool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/logtool"

# have fun :)
$ logtool --help

v0.2.2 / 2020-06-09

Changes

• [BUGFIX] Remove usage of alternate PromQL parser in rules prepare lint.
• [BUGFIX] rules check does not require an argument.

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.2/cortextool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

chunktool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/chunktool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.2/chunktool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/chunktool"

# have fun :)
$ chunktool --help

logtool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/logtool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.2/logtool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/logtool"

# have fun :)
$ logtool --help

v0.2.1 / 2020-06-08

Changes

• [FEATURE] Add rules check command. It runs various best practice checks against rules.
• [ENHANCEMENT] Ensure rules prepare takes into account Vector Matching on PromQL Binary Expressions.

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.1/cortextool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

chunktool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/chunktool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.1/chunktool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/chunktool"

# have fun :)
$ chunktool --help

logtool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/logtool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.1/logtool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/logtool"

# have fun :)
$ logtool --help

v0.2.0 / 2020-06-02

Changes

• [FEATURE] Add rules prepare command. It allows you add a label to PromQL aggregations and lint your expressions in rule files.
• [FEATURE] Add logtool tool. It parses Cortex query-frontend logs and formats them for easy analysis.

Installation

cortextool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/cortextool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.0/cortextool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/cortextool"

# have fun :)
$ cortextool --help

chunktool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/chunktool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.0/chunktool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/chunktool"

# have fun :)
$ chunktool --help

logtool

# download the binary (adapt os and arch as needed)
$ curl -fSL -o "/usr/local/bin/logtool" "https://github.com/grafana/cortex-tools/releases/download/v0.2.0/logtool-linux-amd64"

# make it executable
$ chmod a+x "/usr/local/bin/logtool"

# have fun :)
$ logtool --help