Search documentation
Dashboard
Release Notes

Linux

​
2.37.0
November 14, 2023
new
Attacks can sometimes fail to notify the Gremlin Control Plane when its connection is impacted by the attack itself. The Gremlin agent now tolerates these failures more often and attempts to resend failed notifications. This fixes attacks that end up in the HaltFaled stage that would otherwise finish in the Successful stage.
​
2.36.2
November 9, 2023
fix
Fixed an issue Certificate Expiry attacks against containers would fail when Gremlin was configured with SSL_CERT_FILE
​
2.36.1
November 7, 2023
fix
Fixed an issue where important errors from container attacks were not properly forwarded to the Gremlin control plane, leaving execution outputs from failed attacks without helpful troubleshooting information.
new
Improved the output of the Gremlin Agent validation routine that happens on startup. When validation fails, details about the failure are written to daemon.log
info
Updated dependencies
​
2.36.0
October 20, 2023
fix
Fixed an issue where attacks were incorrectly labeled HaltFailed when Gremlin fails to notify api.gremlin.com during teardown of the network impact.
fix
Fixed a class of issues where Gremlin would not retry requests that failed with transient network errors. This sometimes lead to failing container attacks that should otherwise succeed.
new
For users running Gremlin in the Docker container runtime, rollbacks against container targets no longer require provisioning a second container instance, which results in faster rollbacks.
new
Gremlin provides more context to errors stemming from failed http requests to api.gremlin.com.
new
For users running Gremlin on AWS, more error information is printed to the log file when AWS metadata cannot be retrieved.
info
Updated dependencies
​
2.35.1
October 16, 2023
fix
Fixed an issue where the Gremlin agent would ignore changes to the identifier field in config.yaml if a valid session has already been generated and is not yet expired. On startup, the Gremlin agent will now correctly regenerate a session using the intended identifier value if it detects that its existing session belongs to a different value for identifier.
​
2.35.0
October 12, 2023
fix
Fixed an issue with Certificate Expiry experiments against container targets, where the attack process would not have sufficient Linux capabilities (missing DAC_READ_SEARCH). This fix requires helm chart release 0.11.0 (See #86), however all other attacks will continue to work correctly without this chart update.
fix
Updated Certificate Expiry experiments to discover IPv4-mapped IPv6 addresses (e.g., ::FFFF:192.168.1.1) when a CIDR is specified.
fix
Fixed a regression introduced in 2.22.1 where the Process Killer experiment would incorrectly interpret the interval argument as milliseconds, instead of seconds as intended.
info
Updated dependencies
​
2.34.0
September 18, 2023
new
Running Certificate Expiry experiments against CIDR values (e.g., 10.0.0.0/24) will make several attempts to find an active IP address in use by the target system for evaluating certificate expiration characteristics within the duration specified by the argument --length.
​
2.33.0
September 8, 2023
new
When installed directly on the host and launched with SystemD, Gremlin agent now runs with ambient capabilities (capabilities(7)). File capabilities are no longer set on /usr/bin/gremlin or /usr/sbin/gremlind.
new
When installed directly on the host, the suid bit is no longer set for installed binaries /usr/bin/gremlin and /usr/sbin/gremlind. Additionally, these binaries are no longer owned by the gremlin linux user, but owned by root instead.
info
To install Gremlin with file capabilities and gremlin Linux user ownership in accordance with previous Gremlin versions, set the appropriate GREMLIN_INSTALL_ configuration variables at install time: GREMLIN_INSTALL_USER=gremlin GREMLIN_INSTALL_GROUP=gremlin GREMLIN_INSTALL_BIN_MODE=6111 GREMLIN_INSTALL_BIN_CAPABILITIES=1 sudo -E yum install gremlin gremlind. See Customize Gremlin's Linux User and Group
​
2.32.0
August 18, 2023
new
Previously, gremlind would emit snapshots of process and socket data to Gremlin's control plane over 2 minute intervals. This release significantly reduces network overhead for this data as gremlind now batches up process data over 15 minute intervals, deduplicating all network and process data detected over this interval.
​
2.31.14
August 3, 2023
new
Gremlin now uploads discovered process data at a slower rate, reducing network overhead.
​
2.31.13
July 12, 2023
fix
Fixed a regression released in 2.31.0 where the gremlin agent would set the Host header to an incorrect value for outgoing requests to the Gremlin control plane. This can lead to authentication failures for some intermediate web proxies that use this host header for authorizing requests.
​
2.31.12
July 7, 2023
fix
Errors related to spawning subprocesses now have more detailed information useful for troubleshooting.
fix
IO Errors related to Gremlin container attacks now have more detailed information useful for troubleshooting.
fix
Gremlin provisions fewer file resources for its attack sidecar processes, reducing the time it takes to launch container attacks.
​
2.31.11
June 29, 2023
fix
For hostnames supplied to network attacks, Gremlin delegates DNS queries to the operating system. When this query fails, Gremlin now attemps to resolve the name completely within the running process in an attempt to overcome operating system failures. This allows Gremlin network attacks to continue in the face of failed DNS processing.
fix
Fixed a comment in Gremlin's config.yaml which incorrectly stated that collect_processes was disabled by default.
​
2.31.10
June 27, 2023
fix
Fixed an out-of-memory error caused by a 3rd party library during process collection.
​
2.31.9
June 9, 2023
fix
Fixed a regression instoduced in 2.29.0 where containers for each attack execution incorrectly bind-mounted the file system of every other attack container running on the host. Given enough attack executions running at the same time, a new attack execution container receives a no space left on device error when attempting such mounts, despite space available. Gremlin no longer makes such mounts.
fix
When running the gremlin/gremlin container image, attack containers no longer run in the hostPath mount /var/lib/gremlin. This would produce permission denied errors on systems where this file system is mounted with the noexec flag, such as GKE COS
​
2.31.8
June 6, 2023
new
The Certificate Expiry attack's ipaddress argument now correctly processes CIDR values (e.g. 10.0.0.0/24). When passed, Gremlin will attempt to find an active IP Address in use by the target system and use it for evaluating certificate expiration characteristics.
new
The gremlin/gremlin Dockerhub image now contains the strace utility as a convenience for operators that cannot install this utility from the internet.
​
2.31.7
May 23, 2023
new
The Blackhole attack skips impact on ingress traffic when it detects third-party ingress traffic manipulation rules, such as those installed by a CNI like cilium. This allows egress impact to be applied without failing the attack with errors like Exclusivity flag on, cannot modify.
info
Updated dependencies.
​
2.31.6
May 18, 2023
fix
Gremlin's calls to getaddrinfo now fallback to TCP when a nameserver replies with a truncated answer. For more info, see musl libc 1.2.4.
info
Updated dependencies.
​
2.31.5
May 10, 2023
fix
Gremlin now tears down the TCP connection pool with api.gremlin.com after successive timeout failures.
fix
Gremlin includes the name of the targeted network interface in execution log events related to applying network impact.
info
Updated dependencies.
​
2.31.4
May 1, 2023
fix
Fixed an issue where Gremlin would not report back to the control plane the detailed error that occurred during a failed attack. Users encountering this bug may see http: 415: 415 in their execution log.
fix
Fixed an issue where gremlin check api would incorrectly report connection failures, including an error message of http 403.
fix
Fixed several instances where errors were suppressed from http interactions made by the Gremlin agent. All failed http interactions now show the method and path of the attempted call, along with descriptive error messages.
​
2.31.3
April 27, 2023
fix
Fixed an issue where Gremlin would run requested attack executions in a way that was detached from the original attack request. This leads to the original attack request ending in a LostCommunication stage, while the detached attacks continue to run.
​
2.31.2
April 25, 2023
fix
Corrected the ExecStartPre option in the gremlind.service file which resulted in nuisance errors.
info
Updated dependencies.
​
2.31.1
March 29, 2023
fix
Fixed a bug introduced in 2.31.0 where gremlin init would fail unless the environment variable GREMLIN_TRANSPORT=direct was set.
info
Added support for tag values to be any simple YAML datatype (boolean, integer, float, string). Previously only strings were supported.
info
Updated dependencies.
​
2.31.0
March 24, 2023
new
Gremlin can now target container and Kubernetes targets, even when those targets lack network access to api.gremlin.com.
new
All network traffic from Gremlin attack processes are now routed through /var/lib/gremlin/gremlin.sock. To disable this behavior, provide the following environment variable to the Gremlin agent: GREMLIN_TRANSPORT=direct
​
2.30.5
March 23, 2023
fix
Fixed an issue that prevented Gremlin from ingesting Azure Tags.
fix
Fixed an issue that made Gremlin validation unreliable.
info
Updated dependencies.
​
2.30.4
March 15, 2023
fix
Addressed an issue where Gremlin agents enabled with GREMLIN_TEAM_SECRET would fail to start when also configured with GREMLIN_TRANSPORT=domain-socket
new
Gremlin's version command now prints more build information.
​
2.30.3
March 8, 2023
new
Gremlin can now target container and Kubernetes targets, even when those targets lack network access to api.gremlin.com. See more information at Preview: Gremlin in Kubernetes Restricted Networks
​
2.30.2
March 6, 2023
fix
Addressed performance issues that were seen with gremlind when collect_processes=true which would lead to high CPU usage and agents becoming IDLE. Symptoms occurred on systems running many processes and active network connections (over 1K of each).
new
Various metrics around data collection have beed added to the output of gremlin check daemon for benchmarking purposes.
new
A warning is now supplied in execution logs when the device argument specifies a device that does not exist.
​
2.30.1
February 16, 2023
fix
Fixed a regression in 2.30.0 in which network attacks running in a container without targeting a specific network interface failed to have any impact.
new
Improved the strategy for selecting the target network interfaces.
​
2.30.0
February 10, 2023
new
Multiple network interface attacks are now supported. Details are available in Network device selection.
new
IP address and network interface data is collected to improve distributed network attacks.
info
Updated dependencies.
​
2.29.0
February 8, 2023
new
Gremlin Container attacks no longer create a new Linux mount namespace for the attack. Instead, gremlin attack processes now run in the namespace of the gremlind agent. For Kubernetes environments running AppArmor, this release requires a helm chart update.
info
Updated dependencies.
​
2.28.5
January 5, 2023
fix
Fix a bug in collect_certs when the target dropped the network connection before completing the TLS setup.
info
Updated help URLs.
info
Updated dependencies.
​
2.28.4
December 8, 2022
new
Add support for containerd builds that do not provide versioning metadata.
info
Updated dependencies.
​
2.28.3
November 22, 2022
fix
Fix a bug that prevented collect_certs from working when run against a container.
info
Updated dependencies.
​
2.28.2
November 21, 2022
new
Add a short argument (-n) for the not_less_than option.
info
Updated dependencies.
​
2.28.1
November 18, 2022
fix
Fixed an issue affecting Docker CRI on cgroupv2; Gremlin previously failed to roll back network attacks if the target container was killed during the attack.
​
2.28.0
November 17, 2022
new
Gremlin now supports OpenShift 4.9+ and CRI-O 1.22+
fix
Fixed an issue affecting containerd and CRI-O on cgroupv2; Gremlin previously failed to roll back network attacks if the target container was killed during the attack.
fix
Fixed an issue where Gremlin was not resolving internal hostnames in some instances.
​
2.27.0
November 16, 2022
new
Introduce Certificate Expiry test for Reliability Management.
info
Updated dependencies.
​
2.26.1
October 28, 2022
new
Agent interactions with AWS APIs now use IMDSv2.
fix
Fixed a bug where Gremlin would not properly launch attacks that resolve to a large amount of IP addresses / blocks.
​
2.26.0
October 27, 2022
info
All Gremlin container drivers now work with cgroup2-enabled kernels.
info
Updated dependencies.
​
2.25.1
October 6, 2022
info
Updated dependencies.
​
2.25.0
September 16, 2022
info
Process Collection is now automatically enabled. Process Collection gathers information about the processes running on Linux machines where the Gremlin Agent is installed to detect system dependencies. To disable Process Collection, see Disable Process Collection.
​
2.24.5
September 13, 2022
info
Updated dependencies.
​
2.24.4
August 31, 2022
fix
Fixed a bug where Gremlin's dependency discovery features would not work when IPv6 was disabled.
fix
Fixed a bug where Gremlin would not properly include swap in free memory calculations, leading to incorrect attack results.
​
2.24.3
August 26, 2022
info
Updated dependencies.
​
2.24.2
August 16, 2022
fix
Fixed a bug where Gremlin hides informative warnings about its failure to capture dependency discovery data. Now, gremlind logs WARN messages when it fails to find socket data for any given process. Logs are written only once upon first occurrence.
​
2.24.1
July 29, 2022
fix
Fixed a bug where Gremlin would attempt to allocate more memory than was available when the cgroup attribute memory.limit_in_bytes was higher than available system memory.
info
Updated dependencies.
​
2.24.0
July 26, 2022
new
Gremlin's Memory attack now has a new argument: --allocation-strategy (-s), which informs Gremlin on how to interpret other memory consumption arguments: --percent, --mb, and --gb. See more at Memory: Options
info
Updated dependencies.
​
2.23.2
May 26, 2022
info
Updated dependencies.
​
2.23.1
May 23, 2022
fix
Correctly handle proxy usernames and passwords that contain special characters. Special characters must be percent-escaped. For example, %5C is used in place of a backslash. Details are available here.
info
Updated dependencies.
​
2.23.0
May 9, 2022
new
Disk attack improvements. The Disk attack is much faster, more accurate, and safer.
info
Updated dependencies.
​
2.22.10
April 27, 2022
info
Updated dependencies
​
2.22.9
April 8, 2022
fix
Fixed a bug where Gremlin would fail validation if the DNS lookup of api.gremlin.com failed. This is likely to be a problem in high security environments.
​
2.22.8
April 4, 2022
fix
Fixed a bug where Gremlin network attacks would fail with an Illegal match error when supplied with either an IP address argument with an IPv6 address, or a hostname argument that resolved to an IPv6 address, and one of the following:
  • a protocol (e.g. TCP), or
  • a remote or local port.
​
2.22.7
March 29, 2022
fix
Fixed an issue on some operating systems where process collection would fail to parse the target system's kernel version.
info
Updated dependencies
​
2.22.6
March 23, 2022
info
Removed NTP timestamp from gremlin check os
info
Updated dependencies
​
2.22.5
February 7, 2022
fix
Fixed a bug where Gremlin would crash on some operating systems when process collection was enabled. Gremlin avoids crashing and disables process collection when errors are detected.
fix
Fixed a bug where Gremlin used to skip tag configuration even when it had a valid session. Gremlin now always configures tags on startup as long as it can communicate with the Gremlin control plane.
fix
Some automatic Azure tags were not being correctly read. The azEnvironment, location, name, osType, privateIpAddress, publicIpAddress, sku, vmId, vmSetScaleName, and and zone tags are all automatically read and available for targetting.
new
Gremlin now reads custom Azure tags associated with the machine and makes those tags available for targeting.
​
2.22.4
January 27, 2022
fix
On containerd and cri-o, Gremlin now detects when the process gets killed by the OOMKiller during an attack.
new
The attack Insight I1000 is now detectable on all container drivers when previously it was only detectable on docker-runc.
​
2.22.3
January 21, 2022
info
Updated Rust version used to build agent in response to CVE-2022-21658
​
2.22.2
January 18, 2022
new
Gremlin now sends I1000 event code for the docker-runc container driver when an attack is interrupted by the Out Of Memory (OOM) manager.
fix
Fixed parsing of Docker container API model when oom_kill_disable is null and log Docker container API model when Gremlin fails to parse it correctly.
info
Updated dependencies
​
2.22.1
December 8, 2021
new
Introduce IPv6 support (i.e. fe90::60:ff:fe00:1,::1) for network attacks.
​
2.22.0
December 3, 2021
new
On startup, the Gremlin agent now performs some validation on its ability to run a CPU and Latency attack. Validation results are accessible through the Clients API.
info
The Gremlin agent now outputs more information when Gremlin is killed during container attacks.
info
Updated dependencies
​
2.21.2
November 16, 2021
fix
Fixed a bug present in RPM and DEB packaging where the gremlind service startup script changed ownership of /var/log to gremlin:gremlin on SysvInit enabled systems.
info
Updated dependencies
​
2.21.1
November 9, 2021
fix
Fix a bug where Gremlin would ignore GREMLIN_TEAM_ID and other relevant configuration if a valid session was found at /var/lib/gremlin/.credentials. Now, if the configured teamId value differs from that of the .credentials file, Gremlin re-initiates registration to the control plane.
new
Gremlin now chooses an appropriate container driver more intelligently. When Gremlin detects more than one container runtime running, it chooses the container driver with the most running containers.
info
Updated dependencies
​
2.21.0
October 25, 2021
new
The Disk attack has been significantly improved. In most cases it is much faster, more accurate, and safer. It also uses significantly less CPU and RAM when filling disk volumes. The improved version is used when the environment variable GREMLIN_DEUCHAINN_EN1023 is set to true; all other values are treated as false. This environment variable may be ignored or removed in a future version without notice.
​
2.20.1
October 20, 2021
fix
Fixed AWS tag ingestion when running Gremlin in a container.
fix
Fixed bug with Gremlin's IO attack cleanup when --mode r or --mode w was used. Previously, Gremlin would try to tear down files that did not exist, leading to attack failures.
info
Improve messages reported by the Gremlin IO attack, when file-creation errors occur.
info
Updated dependencies
​
2.20.0
October 8, 2021
info
Changed the way PUSH_METRICS and GREMLIN_COLLECT_PROCESSES boolean configuration variables are evaluated. Previously, any non-empty value other than "0" would evaluate to true (e.g. GREMLIN_COLLECT_PROCESSES=false would evaluate to true). This has been changed to provide expected outcomes: the only values that evaluate true are now "1", "true", and "TRUE", leaving all other values to evaluate to false.
info
Updated dependencies
​
2.19.5
September 27, 2021
fix
Fixed a bug where the Gremlin agent does not properly roll back time travel attacks with an offset of 5 seconds or less.
​
2.19.4
September 16, 2021
fix
Fixed a bug where the Gremlin agent does not initialize the containerd-runc container driver when running on a system using the systemd cgroup driver.
​
2.19.3
September 10, 2021
new
The percent argument for Disk attacks now accepts real numbers. For example, --percent 27.5 was previously unsupported.
new
Gremlin no longer relies on the hostname executable to derive the host's hostname. This is replaced by the gethostname(2) system call.
fix
API interactions made by the Gremlin agent now always send the appropriate Content-Type header value.
info
Updated dependencies
​
2.19.2
August 19, 2021
info
Updated dependencies
​
2.19.1
August 2, 2021
fix
Fixed a bug where child processes beyond immediate children of a container's root process were ignored from the process collection mechanisms that inform service discovery.
info
Updated dependencies
​
2.19.0
July 15, 2021
fix
This update fixes Memory attack bugs. Previously, the amount of memory consumed could deviate significantly from what was requested especially when an attack is run just after I/O operations.
new
The Memory attack is more "aggressive" in the sense that the memory allocated by Gremlin during the attack is more difficult to swap to disk.
​
2.18.5
July 6, 2021
fix
Fixed a bug among all container drivers that use runc, introduced in 2.18.4, where attacks against container and Kubernetes object targets would fail if the targets had memory limit values that exceeded 4 GiB.
​
2.18.4
July 2, 2021
fix
Fixed a bug among all container drivers that use runc, where the Memory Gremlin's `Percent` argument would calculate incorrect target memory allocation. Instead of using the container's available/total memory statistics, Gremlin would use the host's, causing Gremlin to try (and fail) to allocate more than is allowed by the target's memory limits.
​
2.18.3
June 29, 2021
fix
Fixed a bug that prevented the use of comma-separated values as the input for port arguments to the packet_loss Gremlin.
info
Updated dependencies.
​
2.18.2
June 15, 2021
fix
Gremlin container drivers crio-runc, containerd-runc, and docker-runc requested more Linux capabilities than were actually needed by Gremlin: SETFCAP, AUDIT_WRITE, MKNOD, NET_RAW. Gremlin no longer requests these capabilities when running container attacks.
fix
Gremlin no longer fails to make outgoing HTTP calls to api.gremlin.com if there happens to be directives in /etc/resolv.conf that Gremlin does not understand. Gremlin will now log a message when encountering unknown directives and ignore them.
new
The Gremlin CLI now has a gremlin check daemon subcommand which reports on the status of any running Gremlin agent, as well whether process collection is enabled.
info
Gremlin now logs errors encountered when collecting process information. Gremlin logs these errors only the first time they are encountered to reduce log noise.
info
Updated dependencies.
​
2.18.1
April 29, 2021
fix
RPM and DEB package installers for gremlind did not properly honor values for GREMLIN_COLLECT_PROCESSES in /etc/default/gremlind.
info
Updated dependencies.
​
2.18.0
April 26, 2021
new
Gremlin announces Services Discovery for tracking and improving the reliability of distributed services! This update includes support for Services Discovery for Linux.
info
RPM and DEB packages have been updated to set the following capabilities on /usr/sbin/gremlind: CAP_SYS_PTRACE and CAP_DAC_READ_SEARCH. The two capabilities are necessary for the daemon to collect process information for Services Discovery. While the capabilities are set at installation time, Gremlin process collection features are disabled by default and can be enabled by changing the agent configuration. Visit Process Collection for more information.
info
Updated dependencies.
​
2.17.10
April 14, 2021
fix
While very rare, getting the current username can fail. When that happens the Gremlin Client would fail to run an attack. Instead, this version resorts to using "unknown" when the username cannot be determined.
​
2.17.9
April 5, 2021
fix
Upgrade our Docker image to mitigate a security vulnerability in OpenSSL.
new
Daemon log file management improvements. Previously, the log file was truncated at midnight. That made troubleshooting difficult. The log file is now rolled when it reaches approximately 1 MiB. Ten compressed log files are kept. With this update the current log file typically captures several days and the compressed log files typically capture a few weeks at a modest cost of approximately 2 MiB of disk space.
​
2.17.8
March 17, 2021
fix
Fix a bug in Gremlin's argument parsing for the hostnames and ipaddresses arguments for network attacks.
​
2.17.7
March 12, 2021
fix
Improve command-line argument parsing by providing better error messages and catching more edge cases related to illegal inputs.
new
When enabled, Gremlin process collection now correctly labels child processes of containers as container processes, where they previously were labeled as host processes.
new
When enabled, Gremlin process collection now records process's active Ipv6 sockets if they can be translated to Ipv4. This is most commonly seen among container processes that are running in their host's network namespace.
​
2.17.6
March 4, 2021
fix
Patch a vulnerability in a 3rd party library that posed a variety of memory corruption scenarios, most likely use-after-free.
info
Improve error messages among network attacks when an invalid network device is supplied. Error message now includes all valid devices.
info
Drop invalid targeting tags with a warning.
​
2.17.5
February 18, 2021
new
The daemon version is included in the gremlin check report.
fix
Occasionally the Docker version was incorrectly parsed which would result in the classic driver being used for container attacks.
​
2.17.4
February 8, 2021
new
Some agent API traffic is now consolidated into fewer requests.
​
2.17.3
January 27, 2021
new
Some agent API traffic is now gzip-compressed, reducing network overhead on machines where Gremlin is installed.
​
2.17.2
January 12, 2021
fix
Patch a vulnerability in a 3rd party library that posed a potential buffer overflow scenario
fix
Patch a vulnerability in a 3rd party library that posed a potential scenario to operate on dangling memory references
​
2.17.1
December 11, 2020
new
You can now specify the SSL_CERT_FILE variable via the config.yml file. See the advanced configuration page for details on how to use it.
​
2.17.0
December 7, 2020
fix
Gremlin now properly interprets escaped newline characters \n for values of the GREMLIN_SSL_CERT environment variable.
info
Gremlin now reports container and process data at a slower rate, down from every 5 seconds during active attacks (and every 10 seconds otherwise) to every 30 seconds. We've found that this data changes much less frequently than is justified for a 5-10 second interval. This should result in significantly reduced network overhead required to run Gremlin.
info
Updated dependencies
​
2.16.4
November 24, 2020
fix
Remove minor bugs from preview-only features
​
2.16.3
November 20, 2020
fix
The Gremlin agent now writes a message to daemon.log when attacks finish. This provides observers of this log with an approximation on when attacks have ended.
info
Updated dependencies
​
2.16.2
November 13, 2020
info
Updated dependencies
​
2.16.1
November 6, 2020
new
Gremlin will now log more information when it receives signals such as TERM. Details include the user and process that sent the signal.
info
Updated dependencies
​
2.16.0
October 14, 2020
new
Introduced 3 new container drivers: docker-runc, crio-runc, and containerd-runc. With this comes support for new container runtimes: Cri-O and Containerd.
new
Gremlin's container image now runs solely on Alpine Linux, reducing image size and complexity.
fix
Gremlin now provides full support for the systemd cgroup driver when running any of the new container drivers.
​
2.15.11
October 13, 2020
fix
Provide operating system tags for Alpine Linux
info
Update the expiration date for code signing keys
info
Updated dependencies
​
2.15.10
October 8, 2020
fix
Fixed a bug that omitted previous Gremlin versions from showing up at rpm.gremlin.com
fix
Improved Gremlin's ability to discover Linux distributions that would otherwise yield a tag of os-type: Unknown. Among the previously unknown distributions are Alpine, Amazon, Fedora, and Red Hat Enterprise. These distributions will now properly yield an os-type: Linux tag as well as an os-name tag that appropriately describes the Linux distribution.
info
Updated dependencies
​
2.15.9
September 28, 2020
new
AWS Availability Zone ID (azid) is available for targeting.
new
AWS tags are now available for targeting.
​
2.15.8
September 21, 2020
fix
Error messages from attack executions resulting in InitializationFailed were missing their error output in the UI. Gremlin now properly reports the error that occurs during initialization
fix
Fix a regression introduced in 2.15.0 which removed Gremlin's Systemd service configuration during re-installs and upgrades. Now, Gremlin properly configures Systemd (or SysvInit) on every installation, re-installation, or upgrade.
​
2.15.7
September 17, 2020
new
Output detailed messages when an attack results in a terminated process.
fix
Filter out clearly invalid data when collecting cloud metadata.
​
2.15.6
September 15, 2020
new
Improve output for gremlin check auth
​
2.15.5
August 27, 2020
fix
Fixed a bug introduced in 2.12.25 where Gremlin did not accurately determine when SELinux was enabled for Docker users. This produced incorrect behavior for Gremlin's container attacks, as Gremlin failed to mount /var/lib/gremlin with the Docker volume options :z, resulting in permissions errors.
new
Gremlin now reports Available Memory for gremlin measure memory
new
When Gremlin runs in a container, it can now be run under custom SELinux process labels. This allows the privileges that Gremlin requires to run correctly to be granted only to Gremlin and not the rest of a host containers running under the default process label: container_t. Learn more about this on our documentation page, or our Github repo
​
2.15.4
July 30, 2020
info
Miscellaneous work, no functional changes.
​
2.15.3
July 15, 2020
fix
Improve error messaging when Gremlin fails to find an IP address for a hostname supplied with the --hostname argument, which can be passed to any network attack. Error message now mentions failures due to specifying a hostname that maps to an invalid DNS record type, such as NS.
fix
Gremlin was not correctly using the SSL_CERT_FILE environment variable when running attacks against containers. As a result, Gremlin would only properly trust intermediate SSL proxies if the file referenced in SSL_CERT_FILE had a path within /var/lib/gremlin. Now, this file can live anywhere on the file system, so long as Gremlin has access to it.
​
2.15.2
July 1, 2020
fix
Patch a vulnerability in a 3rd party library that posed a potential denial of service to Gremlin's outbound https connections. In practice this is 100% mitigated unless connecting Gremlin through a malicious SSL proxy
info
Updated dependencies
​
2.15.1
June 30, 2020
fix
Gremlin was not using the custom TLS trust store (specified by the SSL_CERT_FILE environment variable) when carrying out attacks against containers. This resulted in a failure to launch container attacks for users that rely on this configuration.
fix
Improve accuracy of latency measurement when checking Gremlin's connectivity to the control plane using gremlin check api. This measurement now omits the time it takes to initialize the HTTP client used to test connectivity.
​
2.15.0
June 10, 2020
new
Gremlin can be installed with a custom group, user, and/or binary mode. The three optional environment variables GREMLIN_INSTALL_GROUP, GREMLIN_INSTALL_USER, GREMLIN_INSTALL_BIN_MODE are set before running the install to establish the security context. The defaults are unchanged: gremlin, gremlin, 6111.
​
2.14.16
June 2, 2020
fix
Added more detail to error messages that occur when Gremlin fails to do a DNS lookup of a hostname. Previously the error message did not include the reason for the lookup failure. An example of the new detail we've added is: failed to lookup address information: Name does not resolve.
​
2.14.15
May 27, 2020
fix
Fixed a bug where Time travel attacks were not blocking the NTP port of the target, even when told to do so. Now, specifying --ntp, or checking the Block NTP box in the UI, correctly blocks all traffic to outbound NTP servers. Omitting this option still correctly allows NTP traffic on the target.
​
2.14.14
May 20, 2020
fix
Fixed a bug where container attacks (including Kubernetes) were not properly setting attacks to ClientAborted when Gremlin's target is killed. This fix includes displaying more information about Gremlin's status after the target is killed.
​
2.14.13
May 19, 2020
fix
Fixed a bug in how the Gremlin Agent reports attack status when Gremlin attacks exit abnormally. In many instances, attacks were incorrectly labeled as LostCommunication when they instead failed to start (Failed), or were killed mid-attack (ClientAborted).
fix
Fixed a bug where the Gremlin Disk attack would not clean up the impact files it created if it was halted from the UI.
fix
Changed the way Debian and RPM installation scripts handle failures when adding Gremlin to the Docker Linux group. Previously, Gremlin would fail and terminate the installation if a docker Linux group was found, but could not add Gremlin to it. Now, a warning is printed instead.
​
2.14.12
May 11, 2020
fix
Improved the safety guarantees of the Gremlin Agent when loading attacks from the filesystem. Now, if the Gremlin Agent fails to load any attack state due to IO errors, all attacks will be halted immediately to prevent any unexpected behavior.
​
2.14.11
May 6, 2020
info
We now collect an approximate host boot time, this will aid Gremlin to better recognize unique hosts on your team.
fix
Select a default network interface in more cases (also used when Gremlin identifier isn't specified).
​
2.14.10
April 30, 2020
fix
Fix bug that prevented the Gremlin agent from reading attack state for attacks created via the CLI. This was preventing users from halting such attacks from the UI, as well as reading logs from the attack details page.
fix
Remove attack.log files associated with attacks that get rolled back from the CLI through gremlin rollback as well as signals, such as from a Ctrl-C.
​
2.14.9
April 29, 2020
fix
Immediately halt and mark the attack as "Initialization Failed" if a Disk Gremlin encounters an IO error while writing the desired amount of bytes.
​
2.14.8
April 27, 2020
info
Updated dependencies
​
2.14.7
April 14, 2020
fix
Integrate more thoroughly with the cgroups managed by Kubernetes and Docker. Gremlin container attacks now properly report usage metrics to cAdvisor which is used in Kubernetes monitoring and autoscaling triggers. NOTE: Gremlin currently only supports the cgroupfs cgroup driver. View more information
​
2.14.6
April 8, 2020
fix
Cap the --workers (-w) argument for Disk and IO attacks to a maximum value equal to the number of CPUs available to Gremlin. This ensures Gremlin is always busy, and not generating more threads than can be fully utilized by the machine on which Gremlin runs. This also eliminates the possibility that Gremlin will exhaust all threads available to Gremlin, which was observed with very large values supplied to --workers (1024 or higher)
info
Updated dependencies
​
2.14.5
March 27, 2020
fix
Improved handling of invalid auth when running gremlin attack-container
new
Better organization of output of gremlin check auth, including more information in both the success/error cases
​
2.14.4
March 26, 2020
fix
The daemon was not properly halting attacks when it did not have access to it's library directory: /var/lib/gremlin, even though it would allow attacks to run. Attacks are now properly halted.
fix
Users can now supply push_metrics inside config.yaml. This attribute is a boolean value that defaults to true, and is equivalent to the environment variable PUSH_METRICS=1
​
2.14.3
March 20, 2020
fix
The daemon was not correctly handling the case when it started up in an un-authed state and relied on gremlin init being run to provide the .credentials file. In particular, it was missing some critical metadata which charting relied upon.
fix
Added subheaders to gremlin check auth to better categorize the output
fix
Read tags supplied in config.yaml
new
Ship example config.yaml to RPM/DEB packages
new
Auto-initialize daemon if secret is present and credentials are not present
​
2.14.1
March 11, 2020
fix
gremlin measure $TYPE now accepts TYPE in uppercase or lowercase (e.g. gremlin measure cpu). It previously only accepted uppercase.
​
2.14.0
March 6, 2020
fix
Kubernetes Pod eviction events triggered by Gremlin resource attacks no longer produce Failed attack states. There is now additional information when Gremlin is killed, and the steps it took to clean up.
fix
Gremlin agents installed into Azure now properly set the publicIpAddress metadata tag (erroneously named publicpAddress in prior versions).
new
Gremlin now pushes CPU metrics for active attacks. These metrics will be used in charting features that allow you to see Gremlin's effect on your machines in real time. To disable this functionality, add PUSH_METRICS=0 to the configuration for gremlind. No data is collected when attacks aren't running, and only data relevant to the attack is collected.
​
2.13.0
February 28, 2020
fix
Gremlin can now compete with the resources dedicated to a container, instead of taking free resources from the host. See more about Gremlin and Cgroups
fix
Running attacks are now halted when the gremlind service is told to shut down from process managers
fix
Memory Gremlin more aggressively touches memory it consumes to better ensure that operating systems don't try to reuse some of it
new
os-name tag added to clients by default; this value, in combination with os-type, now make up the full os description of the machine (i.e. os-type=Linux + os-name=Ubuntu)
​
2.12.27
February 26, 2020
fix
Memory leak collecting measurement data
fix
Ensure capabilities are correctly applied during a rollback
new
Improvements to I/O and Disk attack targeting and capabilities handling
new
Better local IP address determination when automatically setting GREMLIN_IDENTIFIER
new
Improved shutdown handling (SIGINT, SIGTERM, and attack halt)
info
Updated dependencies
​
2.12.26
February 17, 2020
fix
There was a regression in 2.12.25 where host attacks that required capabilities did not properly rollback. This release fixes that.
fix
There was a regression in 2.12.23 where the value of SSL_CERT_FILE was not added to the trust store. That is properly wired into the trust store again
fix
/var/log/gremlin/executions/{guid} was not being cleared on halts - now it is
fix
Shutdown container attack showed an error in the logs, now this case is handled more gracefully
fix
gremlin status was displaying UnknownVariantError in some cases
info
Updated dependencies
​
2.12.25
February 4, 2020
info
Updated dependencies
info
Gremlin now interfaces with version 1.24 of Docker's REST API over Unix socket /var/run/docker.sock, instead of indirectly through docker shell commands.
​
2.12.23
January 9, 2020
fix
Address startup errors referencing number too large to fit in target type, which happens under certain configurations of the target machine's CPU.
fix
Signal handling and process killer improvements
​
2.12.24
January 9, 2020
fix
Better handling for the case when a stateful attack doesn't get a chance to clean up properly within a container
​
2.12.22
January 2, 2020
fix
Make file management for Gremlin logs more operating system agnostic
fix
Improve capabilities checking
info
Updated dependencies
​
2.12.21
December 2, 2019
fix
Prevent non-privileged users from acquiring Gremlin secrets if they have command-line access to linux hosts while a container attack is running
fix
Supply the correct DOCKER_API_VERSION to container attacks
info
Updated dependencies
new
New `os_type tag added to all new Gremlin clients (e.g. os_type:Linux)
​
2.12.20
November 21, 2019
fix
Fixed bug that caused Network Gremlins to fail when attacking two or more processes (including containers) when they shared a network interface.
​
2.12.19
November 12, 2019
new
Improved memory attack performance by as much as four times while limiting the CPU impact.
fix
Recover gracefully from operating system out-of-memory errors.
fix
Minor status message improvements for the memory attack.
​
2.12.17
October 29, 2019
fix
Fixed a bug where launching a container attack was not respecting the GREMLIN_BYPASS_USERNS_REMAP environment variable. This should get set only when the Docker namespace remapping feature is being used.
​
2.12.16
October 23, 2019
fix
Fixed a bug where Memory Gremlin puts unnecessary strain on getrandom and therefore system entropy.
​
2.12.15
October 21, 2019
info
Updated dependencies
​
2.12.14
October 17, 2019
fix
Fixed bug where Gremlin (in Docker only) would log errors about missing directories until it received an attack to run
​
2.12.13
October 14, 2019
fix
Fixed a bug where the Gremlin CPU attack would leave too much CPU in the idle and sy states. The CPU attack will now consume the requested amount, using us instead.
​
2.12.12
October 9, 2019
new
Minor improvements to gremlin check functionality
​
2.12.11
October 1, 2019
fix
Fixed bug where Gremlin would fail attacks due to a closed HTTP stream
fix
Fixed bug where Gremlin would fail to load attacks under certain circumstances
​
2.12.10
September 27, 2019
fix
Improved error messaging around loading authentication configuration
new
New command gremlin check for diagnostics, check out the docs
​
2.12.9
September 16, 2019
info
Updated dependencies
​
2.12.8
September 9, 2019
fix
Improve help text for Blackhole Gremlin arguments about ports
info
Updated dependencies
​
2.12.7
September 5, 2019
fix
Fix bug where Gremlin would create /var/lib/gremlin/.credentials with permissions from the OS umask. Gremlin would then change the mode of the created file before writing to it. Now, Gremlin creates the file with proper permissions, without having to change mode later.
fix
Remove world-readable bit from the /var/log/gremlin directory
​
2.12.6
September 4, 2019
info
Updated dependencies
​
2.12.5
August 28, 2019
fix
Fix to Memory Gremlin running in containers - we were allowing the Gremlin to allocate more memory than was given to the target container
​
2.12.4
August 23, 2019
fix
Bugfix to Memory Gremlin - we were letting the --percentage option consume more memory than was available
​
2.12.2
August 21, 2019
info
Updated dependencies
​
2.12.3
August 21, 2019
fix
Fewer writes by the client to the filesystem, reducing the chance that a Disk Gremlin fails
​
2.12.1
August 5, 2019
fix
Explicitly track tearing down successful attacks, so we don't halt attacks too early in the case teardown takes a material amount of time.
​
2.11.17
July 31, 2019
fix
Ensure Gremlin sidecars launched in a container have the same GREMLIN_IDENTIFIER as the daemon.
info
Updated dependencies
​
2.11.16
July 26, 2019
fix
Make the Memory attack track its allocation time in the Initializing state.
​
2.11.15
July 25, 2019
info
Updated dependencies
​
2.11.14
July 18, 2019
info
Updated dependencies
​
2.11.12
July 11, 2019
info
Updated dependencies
​
2.11.11
July 10, 2019
info
Updated dependencies
​
2.11.10
July 8, 2019
fix
Bugfix for gremlin attack-container CLI command
​
2.11.9
July 2, 2019
fix
Fix handling of GREMLIN_CLIENT_TAGS, which were ignored starting in 2.11.6.
new
Added more trust-store file locations
​
2.11.7
June 27, 2019
info
Updated dependencies
​
2.11.8
June 27, 2019
info
Updated dependencies
​
2.11.6
June 25, 2019
new
Automatically populate client tags when running in Microsoft Azure or Google Cloud
​
2.11.4
June 21, 2019
fix
Bugfix for halted attacks which ended in a Lost Communication state (introduced in 2.11.2)
​
2.11.3
June 18, 2019
info
Updated dependencies
​
2.11.2
June 12, 2019
info
Updated dependencies
​
2.11.1
June 10, 2019
new
Automatically populate client tags with instance-id when running on AWS EC2.
info
Updated dependencies
​
2.11.0
May 29, 2019
new
Resource CPU Attacks can now impact All cores and can consume a percentage of CPU capacity
new
Network DNS attacks now cache the IP address of the Gremlin Control Plane to avoid the attack from halting prematurely
fix
Proxy details are now hidden in the attack logs on successful calls