Downloads

Grafana Enterprise Metrics Downloads

Releases

v1.2.0 – March 10 2021

  • Binary (Linux AMD64)

    • Download
    • SHA256: 702208cb7b440b44a30a7ba9bbe34e7a1bbd19a632435a92cdd608cb232593c8
  • Deb (Linux AMD64)

    • Download
    • SHA256: a3e5140bf38f6479693608bbaf9bdcb7824795c1a662a70007905310cf35f862
  • RPM (Linux AMD64)

    • Download
    • SHA256: 2de19fd38ed129bc66ee4f76804bd2633c996afaa43900a306cb536d672e8909
  • Docker Image: Run docker pull grafana/metrics-enterprise:v1.2.0

  • License: Grafana Labs license

Changelog

  • [CHANGE] Gateway: Remove purger proxy configuration, which is not a supported target for blocks clusters.
  • [CHANGE] Auth: Override authentication flags have been renamed:
    • The auth.override-admin-token flag has been changed to auth.override.token.
    • The auth.override-admin-token-file flag has been changed to auth.override.token-file.
  • [FEATURE] Gateway: Improve the gateway target to support unique TLS configurations and write timeouts for each backend.
    • New fields have been added to allow for configuration:
      gateway:
        proxy:
          default:
            tls:
              tls_cert_path: <string>
              tls_key_path: <string>
              tls_ca_path: <string>
              tls_insecure_skip_verify: <bool>
          distributor:
            read_timeout: <duration>
            write_timeout: <duration>
            tls:
            ...
      
  • [FEATURE] Compactor: Introduced time-sharding compaction strategy.
  • [ENHANCEMENT] Distributor: Wrap remote writes in distributor to sample and log them as business intelligence events.
  • [ENHANCEMENT] Metrics emitted for TLS certificate expiration now reflect certificates being reloaded.
  • [ENHANCEMENT] Remove the Graphite Auto Complete Index and use Cortex index instead.
  • [ENHANCEMENT] Add Graphite API endpoint /metrics/index.json.
  • [ENHANCEMENT] Distributor: Wrap remote writes in distributor to sample and log them as business intelligence events.
  • [ENHANCEMENT] Call Cortex Distributor over gRPC from Graphite Write Proxy (formerly Graphite Distributor)
  • [ENHANCEMENT] Admin API: Add feature to elect and admin-api leader instance to handle all mutation requests. Requests to non-leader instances are forwarded to the leader instance.
    • New fields have been added to allow for configuration:
    admin_api:
      leader_election:
        enabled: <bool>
        ring:
          kvstore: <kv.Config>
          heartbeat_period: <duration>
          heartbeat_timeout: <duration>
          tokens_observe_period: <duration>
          instance_interface_name: <[]string>
        client_config: <grpcclient.Config>
    
  • [BUGFIX] LBAC: Fix issue where debug logs would not print the selector and instead print selector="unsupported value type".
  • [BUGFIX] Admin-Client: Warning logs are no longer created on resource creation.
  • [BUGFIX] Ruler: Fix issue where invalid remote-write URLs cause a panic.
  • [BUGFIX] Querier: Apply label access filters on multi tenant access policies.

Upstream Cortex details

v1.1.2 – January 20 2021

  • Binary (Linux AMD64)

    • Download
    • SHA256: 9f302326ddbd9d8f12c78c3d7dab87ab7df086c44d09f94d30491cde3197562c
  • Deb (Linux AMD64)

    • Download
    • SHA256: 8888ad1f009c330820b2bb0e4d1095ba00952f17a97db1ac4bbf837ec76b0d7d
  • RPM (Linux AMD64)

    • Download
    • SHA256: 89f343ce021cbaef0a60e630e7d1b946ef4ea6289a288a67e8c6499bdd660c77
  • License: Grafana Labs license

Changelog

  • [BUGFIX] Querier: fix default value incorrectly overriding -querier.frontend-address in single-binary mode.

v1.1.1 – January 14 2021

  • Binary (Linux AMD64)

    • Download
    • SHA256: 966db853452590a6119826093c77f0ece77f0580e08a21dc392c4c293f27633e
  • Deb (Linux AMD64)

    • Download
    • SHA256: 7f8acb6dcd1de588ccc40235f134f6136f1e810458c40010a9df85a710abc299
  • RPM (Linux AMD64)

    • Download
    • SHA256: a1ba89cca4bbcba887f1bb219eef94b40a75883e8e66616734ab5de5991ad28f
  • License: Grafana Labs license

Changelog

  • [BUGFIX] Ruler: Minimize gaps on rule evaluations with stale input and enabled ruler evaluation delay.

v1.1.0 – January 12 2021

  • Binary (Linux AMD64)

    • Download
    • SHA256: 38207110d6d7db54ac34cc3172b83786dcd053214d49bb0522009991ae21e11d
  • Deb (Linux AMD64)

    • Download
    • SHA256: 25c235bf328125ce3b0a7c4cd65999c6031de915d072ccf81d6aa00db477689e
  • RPM (Linux AMD64)

    • Download
    • SHA256: 73e6662a936ba4ad9126e63896c0f11fba003c0af7dfadc1c8964d027de1bc42
  • License: Grafana Labs License

Changelog

  • [CHANGE] Admin-API: Resources must not be both prefixed and suffixed with the __ characters. If any of your existing resources exist with this naming pattern, they must be deleted and recreated with a new name before upgrading.

  • [CHANGE] Graphite: Allow storage schema and storage aggregation configs to be defined per tenant.

  • [CHANGE] Admin-Client: Instance management client calls no longer use object storage Iter calls when retrieving the latest version of a resource.

  • [CHANGE] Graphite: Add API endpoints to explore the available Graphite functions.

  • [CHANGE] Admin: The selectors for label policies are now provided as PromQL label strings instead of typed objects.

    • Deprecated:

      "label_policies": [
        {
          "selector": [
            {
              "name": "env",
              "value": "dev",
              "type": "EQ"
            }
          ]
        }
      ]
      
    • New:

      "label_policies": [
        {
          "selector": "{env=\"dev\"}"
        }
      ]
      
  • [CHANGE] Admin: Operations with an ADMIN scope are no longer restricted to operating on clusters they have as a configured realm.

  • [CHANGE] Deprecate enterprise_features config section in favor of the Cortex config extension.

    • Deprecated:

      enterprise_features:
        ruler_s3_request_headers:
          file: <string>
          poll_interval: <duration>
        ruler_remote_write:
          enabled: <bool>
          wal_dir: <string>
      
    • New:

      ruler:
        storage:
          s3:
            header_map_file_path: <string>
            header_map_poll_interval: <duration>
        remote_write:
          enabled: <bool>
          wal_dir: <string>
      
  • [FEATURE] Ruler: Alerts can now be correctly forwarded to the Alertmanager with enterprise authentication enabled by setting the basic authentication username to __alertmanager__ and the password to a API token with access to every instance.

  • [FEATURE] Queries: LBAC enforcement has been added for queries and label value requests.

    • When GEM is run using the default authentication mode, LBAC policies are specified using the X-Prom-Label-Policy HTTP header in the format: X-Prom-Label-Policy: <tenant-id>:urlEscaped(<prometheus label selector>). For example, a policy that only allows metrics with the label env equal to dev for tenant test-instance could specified with the following header: X-Prom-Label-Policy: test-instance:%7Benv=%22dev%22%7D. To specify multiple policies either set the header multiple times or set the header with a single string of multiple policies separated by an unescaped comma.
  • [FEATURE] Admin API: add label_policies field, which contains an array of label matchers to the access policy realm JSON.

    {
      "realms": [
        {
          "instance": "<string>",
          "cluster": "<string>",
          "label_policies": [
              {
                "selector": [
                  {
                      "type": "<enum: EQ | NEQ | RE | NRE>",
                        "name": "<string>",
                        "value": "<string>"
                  }
                ]
              }
          ]
        } 
      ]
    }
    
  • [FEATURE] Admin: Add target tokengen to generate tokens for the default or a custom access policy.

  • [FEATURE] Admin: Added a default __admin__ access policy that has an ADMIN scope. This policy can be disabled adding the following to the GEM configuration file.

    admin_client: 
      disable_default_admin_policy: true
    
  • [FEATURE] Querier: Queries can be federated across multiple tenants. The tenants IDs involved need to be specified separated by a | character in the X-Scope-OrgID request header.

  • [FEATURE] Add gateway target that can be configured to proxy requests to microservices and can be used to load balance remote_write requests to the distributors.

  • [ENHANCEMENT] AdminAPI: Add scope for read only admin access, admin:read.

  • [ENHANCEMENT] AdminAPI: Add separate set of scopes for alerts and rules.

    • alerts:read
    • alerts:write
    • logs:rules:read
    • logs:rules:write
    • metrics:rules:read
    • metrics:rules:write
  • [ENHANCEMENT] Reduce allocations in Graphite Ingester, when ingesting untagged Graphite metrics.

  • [ENHANCEMENT] Serve Graphite /metrics/find requests by keeping track of all recent metrics in an in-memory index on the Ingesters to reduce latency.

  • [ENHANCEMENT] Add auxiliary Graphite API endpoints to explore tags and obtain auto-complete suggestions for the Grafana query editor.

  • [ENHANCEMENT] Admin API: add ClusterKind support for Logs & Traces.

  • [ENHANCEMENT] Admin API: add scopes for Logs.

  • [ENHANCEMENT] Admin: The bootstrap target no longer needs to be run before being able to start GEM with enterprise features. Every target will now try to perform bootstrapping on startup if it has not already been done. Failure to bootstrap will not prevent GEM running, but enterprise features will not be available.

  • [ENHANCEMENT] Add grafana_labs_license_expiry_timestamp metric to expose GEM license expiration as a UNIX timestamp, in seconds.

  • [BUGFIX] Graphite: Fixing a bug in the request parsing of GET requests on the auto-complete endpoints.

  • [BUGFIX] Graphite: When ingesting datapoints resulting in out-of-order/out-of-bounds/duplicate-sample we need to return status 200 to prevent an indefinite loop.

  • [BUGFIX] Ruler: Fix issue where remote-write rule groups are created then immediately deleted when a rule group name contains the / delimiter character.

Upstream Cortex changes

v1.0.2 – October 16 2020

Changelog

  • [CHANGE] Update vendored Cortex from v1.4.0 to [v1.4.0-21bad5][21bad5]
  • [BUGFIX] Fix potential panic due to writing into a closed chan in the graphite query executor.
  • [ENHANCEMENT] Admin: Access policy create operations now enforce valid instance/cluster names for the realms configured on the access policy.
  • [ENHANCEMENT] Add -version flag to GEM.
  • [FEATURE] Add config options to rate limit the LIST methods of buckets.
  • [FEATURE] Adds the Graphite /render API endpoint, which can be used to query metrics with the Graphite query language.
  • [FEATURE] Add config options to specify and poll files to inject arbitrary HTTP headers in requests to S3 for the admin and blocks client.
      blocks_storage:
        s3:
          header_map_file_path: <path to header file>
          header_map_poll_interval: <duration string>
      admin_client:
        storage:
          s3:
            header_map_file_path: <path to header file>
            header_map_poll_interval: <duration string>
    
  • [FEATURE] Adds the Graphite /metrics/find API endpoint, which can be used to obtain lists of metrics matching a given pattern (Grafana query editor auto-complete, dashboard variable population, etc).
  • [FEATURE] Add a default access policy option for OpenID Connect tokens.

Upstream Cortex details

  • Cortex Hash: [21bad57b346c730d684d6d0205efef133422ab28][21bad5]
  • Cortex CHANGELOG

v1.0.1 – October 06 2020

Upstream Cortex details

  • Cortex Hash: 23554ce028c090a4a3413ac0e35e5e1dc9fa929f
  • Cortex Version: 1.4.0

Changelog

  • [CHANGE] Update vendored Cortex to v1.4.0.

v1.0.0 – September 17 2020

Upstream Cortex details

  • Cortex Hash: bb5fcc929832f7bd2a6c2df348b387abcb8b961e
  • Cortex Version: 1.4.0-rc.0

Changelog

  • [BUGFIX] Make config field names consistent.
  • [CHANGE] Use Go 1.14.9 to build the project and cut build-image@v0.1.3.

v1.0.0-rc.2 – September 15 2020

Upstream Cortex details

  • Cortex Hash: c3a344784a0c8ce70ef2521f543033dee3dce6c6
  • Cortex Version: 1.3.1

Changelog

  • [BUGFIX] Admin API: Fix panic on start up for admin-api target.

v1.0.0-rc.1 – September 04 2020

Upstream Cortex details

  • Cortex Hash: 4f6e1e5c48ccad2c1988cf1d36ca522ae0c805ed
  • Cortex Version: 1.3.1

Changelog

  • [CHANGE] Admin-Client: The storage backend for the admin client no longer defaults to s3. Instead no default is set and the admin client will not start up unless a default is set.
  • [CHANGE] The following features will no longer be active unless GEM is started with access to a valid license.
    • Admin API
    • Ruler S3 auth headers
    • Ruler API to configure remote write rule groups

v0.6.3 – August 20 2020

Upstream Cortex details

  • Cortex Hash: 2bda7b94
  • Cortex Version: 1.2.1

Changelog

  • [CHANGE] Auth: removed auth.enable flag and add auth.type flag with default and enterprise options.
  • [FEATURE] Admin API: Add list endpoint for stored licenses.

v0.6.2 – August 04 2020

Upstream Cortex details

  • Cortex Hash: 6db67a4efbbf62b1133fa037a95382a21f752bbf
  • Cortex Version: 1.2.1

Changelog

  • [CHANGE] Ruler: S3 Headers are no longer protected by a license.