Fix deprecation warnings

Fixed

• Fix deprecation warnings for Probes.probes introduced in 3.7.1 for internally registered probes.

See the Ruby gem 3.7.2 changelog for more information.

Probe improvements and small fixes

Changed

• If the gem can't find a valid log path in the app's log/ directory, it will no longer print the warning more than once.
• Stop the minutely probes when Appsignal.stop is called. When Appsignal.stop is called, the probes thread will no longer continue running in the app process.
• Listen to the APPSIGNAL_HTTP_PROXY environment variable in the extension installer. When APPSIGNAL_HTTP_PROXY is set during gem instal appsignal or bundle install, it will use the proxy specified in the APPSIGNAL_HTTP_PROXY environment variable to download the extension and agent.
• Allow unregistering minutely probes. Use Appsignal::Probes.unregister to unregister probes registered with Appsignal::Probes.register if you do not need a certain probe, including default probes.
• Add Appsignal::Probes.register method as the preferred method to register probes. The Appsignal::Probes.probes.register and Appsignal::Minutely.probes.register methods are now deprecated.
• Automatically start new probes registered with Appsignal::Probes.register when the gem has already started the probes thread. Previously, the late registered probes would not be run.
• Rename the Minutely constant to Probes so that the API is the same between AppSignal integrations. If your apps calls Appsignal::Minutely, please update it to Appsignal::Probes. If your app calls Appsignal::Minutely after this upgrade without the name change, the gem will print a deprecation warning for each time the Appsignal::Minutely is called.
• Log debug messages when metrics are received for easier debugging.

Fixed

• Clear the AppSignal in memory logger, used during the gem start, after the file/STDOUT logger is started. This reduces memory usage of the AppSignal Ruby gem by a tiny bit, and prevent stale logs being logged whenever a process gets forked and starts AppSignal.

See the Ruby gem 3.7.1 changelog for more information.

Add heartbeats and `ignore_logs` config option

ignore_logs configuration option

Add the ignore_logs configuration option, which can also be configured as the APPSIGNAL_IGNORE_LOGS environment variable.

The value of ignore_logs is a list (comma-separated, when using the environment variable) of log line messages that should be ignored. For example, the value "start" will cause any message containing the word "start" to be ignored. Any log line message containing a value in ignore_logs will not be reported to AppSignal.

The values can use a small subset of regular expression syntax (specifically, ^, $ and .*) to narrow or expand the scope of lines that should be matched.

For example, the value "^start$" can be used to ignore any message that is exactly the word "start", but not messages that merely contain it, like "Process failed to start". The value "Task .* succeeded" can be used to ignore messages about task success regardless of the specific task name.

Heartbeats

Heartbeats are currently only available to beta testers. If you are interested in trying it out, send an email to support@appsignal.com!

Add heartbeats support. You can send heartbeats directly from your code, to track the execution of certain processes:

def send_invoices()
  # ... your code here ...
  Appsignal.heartbeat("send_invoices")
end

You can pass a block to Appsignal.heartbeat, to report to AppSignal both when the process starts, and when it finishes, allowing you to see the duration of the process:

def send_invoices()
  Appsignal.heartbeat("send_invoices") do
    # ... your code here ...
  end
end

If an exception is raised within the block, the finish event will not be reported to AppSignal, triggering a notification about the missing heartbeat. The exception will bubble outside of the heartbeat block.

See the Ruby gem 3.7.0 changelog for more information.

Fix CPU usage measurements

Fix CPU user/system usage measurements, as to take into account the amount of CPUs available.

Fix instrumentation for older redis-client versions

Fix a bug where performing queries using older versions of redis-client would result in a NoMethodError being raised.

Using redis-client version 0.14.0 or greater is a requirement for AppSignal to instrument Redis queries.

See the Ruby gem 3.6.5 changelog for more information.

Improve Rails error reporter and other improvements

Improve Rails error reporter

Add request parameters, "path" and "method" tags to errors reported in controllers via the Rails error reporter. (Thanks @bdewater-thatch!)

Add CPU count configuration option

Implement CPU count configuration option. Use it to override the auto-detected, cgroups-provided number of CPUs that is used to calculate CPU usage percentages.

To set it, use the the cpu_count configuration option or the APPSIGNAL_CPU_COUNT environment variable.

Active Job error reporting config option

Added

• Add activejob_report_errors config option. When set to "none", ActiveJob jobs will no longer report errors. This can be used in combination with custom exception reporting. By default, the config option has the value "all", which reports all errors.

See the Ruby gem 3.6.1 changelog for more information.

Ruby gem 3.6.0

Added

• Add instrumentation for all Rack responses, including streaming responses. New response_body_each.rack, response_body_call.rack and response_body_to_ary.rack events will be shown in the event timeline. This will show how long it takes to complete responses, depending on the response implementation.

  This Sinatra route with a streaming response will be better instrumented, for example:

  ruby

  get "/stream" do
    stream do |out|
      sleep 1
      out << "1"
      sleep 1
      out << "2"
      sleep 1
      out << "3"
    end
  end

• Add histogram support to the OpenTelemetry HTTP server. This allows OpenTelemetry-based instrumentations to report histogram data to AppSignal as distribution metrics.

Changed

• Breaking change: Normalize CPU metrics for cgroups v1 systems. When we can detect how many CPUs are configured in the container's limits, we will normalize the CPU percentages to a maximum of 100%. This is a breaking change. Triggers for CPU percentages that are configured for a CPU percentage higher than 100% will no longer trigger after this update. Please configure triggers to a percentage with a maximum of 100% CPU percentage.
• Support fractional CPUs for cgroups v2 metrics. Previously a CPU count of 0.5 would be interpreted as 1 CPU. Now it will be correctly seen as half a CPU and calculate CPU percentages accordingly.
• Update bundled trusted root certificates.

Fixed

• Fix (sub)traces not being reported in their entirety when the OpenTelemetry exporter sends one trace in multiple export requests. This would be an issue for long running traces, that are exported in several requests.

See the Ruby gem 3.6.0 changelog for more information.

Default headers don't include `REQUEST_URI` anymore

Changed

• The default headers no longer include REQUEST_URI as query params are not sanitize and might include PII. Now the REQUEST_PATH is used instead.

See the Ruby gem 3.5.6 changelog for more information.

redis-client support and MySQL query sanitization fix

Added

• Add support for the redis-client gem, which is used by the redis gem since version 5.

Changed

• Make the debug log message for OpenTelemetry spans from libraries we don't automatically recognize more clear. Mention the span id and the instrumentation library.
• Fix an issue where queries containing a MySQL leading type indicator would only be partially sanitised.

Fixed

• Add more testing to JRuby extension installation to better report the installation result and any possible failures.

See the Ruby gem 3.5.5 changelog for more information.

Fix Alpine Linux disk usage metrics

Changed

• Fix disk usage returning a Vec with no entries on Alpine Linux when the df --local command fails.

Deprecated

• Deprecate the Appsignal.set_host_gauge and Appsignal.set_process_gauge helper methods in the Ruby gem. These methods would already log deprecation warnings in the appsignal.log file, but now also as a Ruby warning. These methods will be removed in the next major version. These methods already did not report any metrics, and still do not.

Removed

• Remove the appsignal_set_host_gauge and appsignal_set_process_gauge extension functions. These functions were already deprecated and did not report any metrics.

Fixed

• Fix the Makefile log path inclusion in the diagnose report. The diagnose tool didn't look in the correct gem extension directory for this log file.
• Fix reporting of the Ruby syntax version and JRuby version in install report better.

See the Ruby gem 3.5.4 changelog for more information.

Log warning for missing disk mountpoints

Changed

Log a warning when no mountpoints are found to report the disk usage metrics. This scenario shouldn't happen (it should log an error, message about skipping a mountpoint or log the disk usage). Log a warning to detect if this issue really occurs.

See the Ruby gem 3.5.3 changelog for more information.

Ruby 3.3 compatibility

Fixed

• Fixed a bug that prevented apps from starting up when using Ruby 3.3

See the Ruby gem 3.5.1 changelog for more information.

Ruby Logger 1.6 compatibility

Fixed

• Fix Ruby Logger 1.6.0 compatibility.

See the Ruby gem 3.5.2 changelog for more information.

Error causes support

Added support for error causes.

When AppSignal reports an error that was raised during the handling of another error, the original error (the cause) and its error message will be shown alongside the reported error.

See the Ruby gem 3.5.0 changelog for more information.

Disk usage measurement improvements

Changed

• Filter more disk mountpoints for disk usage and disk IO stats. This helps reduce noise in the host metrics by focussing on more important mountpoints. Any mountpoint containing /etc/hostname, /etc/hosts, /etc/resolv.conf, /snap/ or /proc/ is ignored.

Fixed

• Support disk usage reporting (using df) on Alpine Linux. This host metric would report an error on Alpine Linux.
• When a disk mountpoint has no inodes usage percentage, skip the mountpoint, and report the inodes information successfully for the inodes that do have an inodes usage percentage.

See the Ruby gem 3.4.16 changelog for more information.

CPU stats normalization for cgroups v2

Changed

• CPU usage is now normalized to the number of CPUs available to the container. This means that a container with 2 CPUs will have its CPU usage reported as 50% when using 1 CPU instead of 100%. This is a breaking change for anyone using the cpu probe.
  • If you have CPU triggers set up based on the old behaviour, you might need to update those to these new normalized values to get the same behaviour. Note that this is needed only if the AppSignal integration package you're using includes this change.

See the Ruby gem 3.4.15 changelog for more information.

Long query sanitization, debug logging and other improvements

Changed

• Add an exponential backoff to the retry sleep time to bind to the StatsD, NGINX and OpenTelemetry HTTP ports. This gives the agent a longer time to connect to the ports if they become available within a 4 minute window.
• Sanitize SQL queries before truncating them. This fixes an issue where long SQL queries would be truncated at arbitrary points.
• Logs from the agent and extension now use a more consistent format for spans and transactions.
• The "debug" log level should now be enough for debugging most support issues.
• Add memory_in_percentages and swap_in_percentages host metrics that represents metrics in percentages.
• Ignore /snap/ disk mountpoints when measuring disk usage in volumes.
• Fix issue with the open span count in logs being logged as a negative number.
• Fix agent's OpenTelemetry HTTP server getting stuck when two requests are made within the same fraction of a second.

See the Ruby gem 3.4.14 changelog for more information.

Rails 7.1 and dry-monitor support

Added

• Events from dry-monitor are now supported. There's also native support for rom-sql instrumentation events if they're configured.
• Support Rails 7.1 ActiveSupport Notifications handler.

Changed

• Add configuration load modifiers to diagnose report. Track if the APPSIGNAL_INACTIVE_ON_CONFIG_FILE_ERROR environment variable was set.

See the Ruby gem 3.4.13 changelog for more information.

Fix inode usage host metric name format and do not start on config file error (opt-in)

Added

• Add an option to not start AppSignal on config file errors. When the config/appsignal.yml file raises an error (due to ERB syntax issues or ERB errors), it will currently ignore the config file and try to make a configuration work from the other config sources (default, auto detection and system environment variables). This can cause unexpected behavior, because the config from the config file is not part of the loaded config.

  In future versions of the Ruby gem, AppSignal will not start when the config file contains an error. To opt-in to this new behavior, set the APPSIGNAL_INACTIVE_ON_CONFIG_FILE_ERROR system environment variable to either 1 or true.

Changed

• Log an error when sample data is of an invalid type. Accepted types are Array and Hash. If any other types are given, it will log an error to the appsignal.log file.

Fixed

• Bump agent to 6133900.
  • Fix disk_inode_usage metric name format to not be interpreted as a JSON object.

See the Ruby gem 3.4.12 changelog for more information.