prometheus-client-mmap 0.25.0-aarch64-linux → 0.26.1-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d7c0a0a5c75a6318bd6ac6fae0b4461d8fe0e45a856b8f37632d1bacafd45f0
-  data.tar.gz: 880243eb84781d2e0d29c1bf7b36fedeb9db4052df35a168b7c573c2db34bf41
+  metadata.gz: 84b7874f92659f5e2c57047eacb344b73725357dea757c21f64241237ad569d4
+  data.tar.gz: bf420407ace278c54ad91473ac9782fe9f11a1b51c8cd87737b28aba86459acd
 SHA512:
-  metadata.gz: 1d1755f3011ee4ba069c2c9def057089f200d3de207e49166228d594fc1459cc0f880c87882025542ff13d5bbafaeafc0ee840c4f316c3d34147f21054e4fe02
-  data.tar.gz: 8f2f958e6fd6db7c693084399f879326647f35a3759008b4d4f5e4b63f2f4633c8d8df02749ef93d8de58234b7e686062c98e50f0e5b6c6763d4b45594e0f634
+  metadata.gz: ac1cd37e00930638e1233c77cd0fd90ee964134b845160862815e5ff831c6753cf72fed040e8dd4ada8411c9315f64a9f34861dbea51902585557edb69808cf5
+  data.tar.gz: c97dd0d1abf9de39449fa87fc032237ee3363902443bb0240e77d907ddeb82549d3719da6f91e96ccbd76b49c2ad730b79bf0e5efc959a80be88fd9f2fae5d57

data/README.md

@@ -10,7 +10,24 @@ through a HTTP interface. Intended to be used together with a
 
 [![Gem Version][4]](http://badge.fury.io/rb/prometheus-client-mmap)
 [![Build Status][3]](https://gitlab.com/gitlab-org/prometheus-client-mmap/commits/master)
-[![Dependency Status][5]](https://gemnasium.com/prometheus/prometheus-client-mmap)
+
+## Installation
+
+prometheus-client-mmap ships with [precompiled native gems](https://rubygems.org/gems/prometheus-client-mmap).
+Install the gem via:
+
+```shell
+gem install prometheus-client-mmap
+```
+
+### Requirements for building from source
+
+Building from source requires a number of dependencies:
+
+* Rust v1.65+
+* clang 5.0 or higher for [bindgen](https://rust-lang.github.io/rust-bindgen/requirements.html)
+* `make`
+* A C compiler (for legacy extension, which will be removed soon)
 
 ## Usage
 
@@ -34,9 +51,9 @@ http_requests = prometheus.counter(:http_requests, 'A counter of HTTP requests m
 http_requests.increment
 ```
 
-## Rust extension (experimental)
+## Rust extension
 
-In an effort to improve maintainability, there is now an optional Rust
+In an effort to improve maintainability, there is now a Rust
 implementation that reads the metric files and outputs the multiprocess
 metrics to text. If `rustc` is available, then the Rust extension will
 be built automatically. The `use_rust` keyword argument can be used:
@@ -45,8 +62,10 @@ be built automatically. The `use_rust` keyword argument can be used:
 puts Prometheus::Client::Formats::Text.marshal_multiprocess(use_rust: true)
 ```
 
+Starting with v0.26.0, `use_rust` defaults to `true`.
+
 Note that this parameter will likely be deprecated and removed once the Rust
-extension becomes the default mode.
+extension becomes the only supported mode.
 
 ### Rack middleware
 
@@ -202,14 +221,21 @@ prometheus_multiproc_dir=/tmp
 
 ### Multiprocess metrics via Rust extension
 
-If the environment variable `prometheus_rust_multiprocess_metrics=true` is set or if the `rust_multiprocess_metrics`
-configuration setting is `true` and the `fast_mmaped_file_rs` extension is available, it will be used to generate
-multiprocess metrics. This should be significantly faster than the C extension.
+By default, the Rust extension will be used to read and write multiprocess
+metrics if the `fast_mmaped_file_rs` extension is available. This should
+be significantly faster than the C extension.
+
+If the environment variable `prometheus_rust_multiprocess_metrics=false`
+is set or if the `rust_multiprocess_metrics` configuration setting is
+`false` , the C extension will be used.
 
 ### Read and write metrics via Rust extension
 
-If the environment variable `prometheus_rust_mmaped_file=true` is set then if the `fast_mmaped_file_rs`
-extension is available it will be used to read and write metrics from the mmapped file.
+By default, the Rust extension will be used to read and write metrics
+from the mmaped file if the `fast_mmaped_file_rs` extension is available.
+
+To use the C extension, set the environment variable
+`prometheus_rust_mmaped_file=false`.
 
 ## Pitfalls
 

data/lib/prometheus/client/configuration.rb

@@ -14,7 +14,7 @@ module Prometheus
         @initial_mmap_file_size = ::Prometheus::Client::PageSize.page_size(fallback_page_size: 4096)
         @logger = Logger.new($stdout)
         @pid_provider = Process.method(:pid)
-        @rust_multiprocess_metrics = ENV.fetch('prometheus_rust_multiprocess_metrics', nil) == 'true'
+        @rust_multiprocess_metrics = ENV.fetch('prometheus_rust_multiprocess_metrics', 'true') == 'true'
         @multiprocess_files_dir = ENV.fetch('prometheus_multiproc_dir') do
           Dir.mktmpdir("prometheus-mmap")
         end

data/lib/prometheus/client/formats/text.rb

@@ -27,7 +27,7 @@ module Prometheus
             Helper::MetricsRepresentation.to_text(metrics)
           end
 
-          def marshal_multiprocess(path = Prometheus::Client.configuration.multiprocess_files_dir, use_rust: false)
+          def marshal_multiprocess(path = Prometheus::Client.configuration.multiprocess_files_dir, use_rust: true)
             file_list = Dir.glob(File.join(path, '*.db')).sort
               .map {|f| Helper::PlainFile.new(f) }
               .map {|f| [f.filepath, f.multiprocess_mode.to_sym, f.type.to_sym, f.pid] }

data/lib/prometheus/client/helper/loader.rb

@@ -29,7 +29,11 @@ module Prometheus
               load_rust_extension
               true
             rescue LoadError
-              Prometheus::Client.logger.info('FastMmapedFileRs unavailable')
+              warn <<~WARN
+WARNING: The Rust extension for prometheus-client-mmap is unavailable, falling back to the legacy C extension.
+  The Rust extension will be required in the next version. If you are compiling this gem from source,
+  ensure your build system has a Rust compiler and clang: https://gitlab.com/gitlab-org/ruby/gems/prometheus-client-mmap
+WARN
               false
             end
           end

data/lib/prometheus/client/helper/mmaped_file.rb

@@ -14,7 +14,7 @@ module Prometheus
   module Client
     module Helper
       # We can't check `Prometheus::Client.configuration` as this creates a circular dependency
-      if (ENV.fetch('prometheus_rust_mmaped_file', nil) == "true" &&
+      if (ENV.fetch('prometheus_rust_mmaped_file', 'true') == "true" &&
           Prometheus::Client::Helper::Loader.rust_impl_available?)
         class MmapedFile < FastMmapedFileRs
         end

data/lib/prometheus/client/version.rb

@@ -1,5 +1,5 @@
 module Prometheus
   module Client
-    VERSION = '0.25.0'.freeze
+    VERSION = '0.26.1'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prometheus-client-mmap
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.26.1
 platform: aarch64-linux
 authors:
 - Tobias Schmidt
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-15 00:00:00.000000000 Z
+date: 2023-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb_sys