To install this package, run in Emacs:
M-x package-install RET emacs-gc-stats RET
This package collects Emacs garbage collection (GC) statistics over time and saves it in the format that can be shared with Emacs maintainers.
Context:
See the source code for information how to contact the author.
Add
(require 'emacs-gc-stats) ;; Optionally reset Emacs GC settings to default values (recommended) (setq emacs-gc-stats-gc-defaults 'emacs-defaults) ;; Optionally set reminder to upload the stats after 3 weeks. (setq emacs-gc-stats-remind t) ; can also be a number of days ;; Optionally disable logging the command names ;; (setq emacs-gc-stats-inhibit-command-name-logging t) (emacs-gc-stats-mode +1)
to your init file to enable the statistics acquiring.
When you are ready to share the results, run M-x emacs-gc-stats-save-session
and then share the saved emacs-gc-stats-file
(defaults to
~/.emacs.d/emacs-gc-stats.eld
) by sending an email attachment to
mailto:emacs-gc-stats@gnu.org. You can review the file before
sharing–it is a text file.
Configure emacs-gc-stats-remind
to make Emacs display a reminder about
sharing the results.
This package does not upload anything automatically. You will need to
upload the data manually, by sending email attachment. If necessary,
you can review emacs-gc-stats-file
(defaults to
~/.emacs.d/emacs-gc-stats.eld
) before uploading–it is just a text
file.
The following data is being collected after every command:
gc-cons-threshold
and gc-cons-percentage
gcmh-mode
is usedmemory-info
)
Logging the command names can be disabled by setting
emacs-gc-stats-inhibit-command-name-logging
customization.
What exactly is being logger is controlled by
emacs-gc-stats-setting-vars
, emacs-gc-stats-command-vars
, and
emacs-gc-stats-summary-vars
.
You can use M-x emacs-gc-stats-clear
to clear the currently collected
session data.
You can pause the logging any time by disabling emacs-gc-stats-mode
(M-x emacs-gc-stats-mode
).
memory-info
trying to retrieve memory information from remote
system over TRAMP.emacs-gc-stats-file
is now compressed, when possible.emacs-gc-stats-inhibit-command-name-logging
to
disable logging current command name. Logging is enabled by default.emacs-gc-stats-remind
to set a reminder to share
the data. Reminder is disabled by default.emacs-gc-stats-setting-vars
, emacs-gc-stats-command-vars
, and
emacs-gc-stats-summary-vars
.emacs-gc-stats-1.4.tar.lz | 2023-Jul-07 | 5.15 KiB |
emacs-gc-stats-1.3.tar.lz | 2023-Jun-20 | 4.89 KiB |
emacs-gc-stats-1.2.3.tar.lz | 2023-Jun-18 | 3.55 KiB |
emacs-gc-stats-1.2.1.tar.lz | 2023-Jun-16 | 3.22 KiB |
emacs-gc-stats-1.2.tar.lz | 2023-Jun-15 | 3.00 KiB |
emacs-gc-stats-1.1.tar.lz | 2023-Jun-11 | 2.74 KiB |