AppOptics | Snap Agent release notes

4.5.2 - December 2, 2024

Return to top

Snap Agent 4.5.2 provides security updates and bug fixes to many of its collectors.

SWISnap v4.14.9

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Bug Fixes/Enhancements: Corrected docker embedded log functionality

SWI v1.3.6

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Bridge V2(v26.4.8)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Apache V1(v22.0.3)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Apache V2(v23.0.13)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Docker V1(v47.0.5)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Docker V2(v48.2.10)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Kubernetes V1(v25.0.2)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Kubernetes V2(v26.0.9)

Security Improvements:Addressed multiple security vulnerabilities to enhance system protection

Elasticsearch V1(v18.0.2)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Elasticsearch V2(v19.2.5)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

HaProxy V1(v13.0.3)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

HaProxy V2(v15.0.11)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

OracleDB V1(v4.0.2)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

OracleDB V2(v5.0.8)

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

CRI v1.1.2

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

Maintenance:

Updated Kubernetes versions to the latest ("1.31", "1.30", "1.29")
Removed unsupported dockershim environment

RabbitMq v24.0.3

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

MySQL v26.1.3

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

MongoDB v14.1.3

Security Improvements: Addressed multiple security vulnerabilities to enhance system protection

4.5.1 - December 15, 2022

Return to top

Snap Agent 4.5.1 provides an updated collector-cri plugin.

Plugin updates

cri v1.1.0

The metrics reported by the plugin now pass the container ID to the tags.
The container ID is no longer included in the metric name.

This is a breaking change for your dashboard charts. To display the correct chart data, remove the <container_id> parameter from the underlying metrics. This may include removing a wildcard ( * ) or alphanumeric hash.

4.5.0 - August 22, 2022

Return to top

Snap Agent 4.5.0 provides a major upgrade of several collectors to the v2 plugins framework, as well as general maintenance fixes and improvements.

New v2 plugins: The new v2 plugins are included as part of the snap-plugin-collector-swi binary. The v2 plugins framework provide metrics filtering, multi-task support, and easier autoload out-of-the-box. The plugins are OTEL-ready and the metrics are annotated with human-readable units.

Docker collector v2
Kubernetes collector v2
Elasticsearch collector v2
HAProxy collector v2
Apache collector v2
OracleDB collector v2

Core Snap Agent updates

snap v4.14.8

Maintenance

updated in-process plugins

Breaking changes

removed support for 32-bit systems with ARM architecture

New features and plugins

snap-plugin-collector-swi v1.3.1

apache v23.0.5

Upgraded to the v2 plugin framework
Added Windows support
Fixed an issue with the DurationPerReq metric

docker v48.2.2

Upgraded to the v2 plugin framework
Added Windows support
Added detailed statistics reading mode option, to detect short CPU/memory usage peaks:
- 1s sampling for calculating avg
- added _max and _min metrics
Now allows filtering by image name
General security fixes

kubernetes v26.0.5

Upgraded to the v2 plugin framework
General security fixes

elasticsearch v19.2.1

Upgraded to the v2 plugin framework
Added support for:
- TLS connection to ES cluster
- multi-node environments
- master election
- custom queries

haproxy v15.0.4

Upgraded to the v2 plugin framework
Added support for HAProxy up to version 2.4 (the current latest LTS)
Improved performance by parallelizing endpoints processing

oracledb v5.0.4

Upgraded to the v2 plugin framework
Removed the requirement for Oracle Instant Client

Plugins removed

psm

In-process plugins updated

publisher-appoptics / processes v49.2.2

wait a while when there's no host metadata yet
don’t print own configuration to logs (to avoid tokens printout)

psutil v59.2.0

Added inode metrics
Added metric descriptions and units for all metrics

publisher-file v16.1.1

Added security updates
Added general maintenance updates

publisher uams v1.3.1

OTEL metrics support

Regular plugins updated

All listed plugins received general maintenance updates.

iis-native v1.0.4

Add types of metrics and units

bridge v26.4.7

cri v1.0.6

elasticsearch v18.0.1

logs v16.0.9

Add types of metrics and units
Added security updates

memcache v6.0.0

mesos v14.0.0

mongodb v14.1.0

mysql v26.1.0

rabbitmq v24.0.0

4.4.0 - October 27, 2021

Return to top

Snap Agent 4.4.0 introduces containerd monitoring capabilities and a general Container Runtime Interface (CRI) monitoring support, as well as general maintenance fixes, security improvements, and official support for Debian 11, Linux/ARM (v7 and v8), and Raspbian.

New

containerd + CRI collector (v1.0.3) - a new plugin to monitor containers using CRI standard metrics and extended metrics for containerd environments. See CRI + containerd plugin.
Support for Debian 11
Support for Linux ARM v7 and v8. Currently only in-process, embedded plugins are supported for ARM v7 and v8. These include:
- System metrics + AppOptics measurements publisher
- System processes + AppOptics processes publisher
- Logs collection
  - Log files
  - Docker container logs
  - Kubernetes events
  - Syslog server
- Logs publishing
  - Loggly HTTPs bulk
  - Loggly HTTPs
  - Loggly Syslog
  - Papertrail HTTPs bulk
  - Papertrail HTTPs
  - Papertrail Syslog
Support for Raspbian (the official OS for RasberryPI):
- (7) raspbian/wheezy
- (8) raspbian/jessie
- (9) raspbian/stretch
- (10) raspbian/buster

Fixes

Improved stability of plugins

IIS Native (1.0.2)

Fixes

Fixed IIS plugin crash due to the service name

Bridge (26.4.3)

Maintenance improvements

Kubernetes (1.0.3)

Increased k8s client version to 1.17.11
Maintenance improvements

Docker (47.0.2)

Stability improvements
Supportability changes

Oracle (4.0.1)

Improved error handling

4.3.0 - July 22, 2021

Return to top

SWISnap (4.6.13)

In-process plugins updates

Logs suite updated to 17.2.0

Fixes

Optimize the amount of tags being sent from SNAP

Logs plugins suite (17.2.0)

New feature

Multiline logs aggregation

Processes plugin (12.0.2)

Fixes

Removed incorrect warning log message reported for PID 0

4.2.0 - June 14, 2021

Return to top

Snap Agent 4.2.0 introduces a new IIS-Native integration, as well as general maintenance fixes, security improvements, and added support for Ubuntu 20.10 and 21.04.

SWISnap (4.6.6)

In-process plugins updates

Logs suite updated to 17.1.6
Metrics and processes publisher plugins updated to 49.1.4

Security improvements

Prevent execution plugin binary from outside configured Snap/bin folder
Plugin cannot be started when plugin_name from taskfile mismatches the name returned by the plugin itself

Fixes

Snap no longer logs "deferred closing failed" error on every startup
Fixed goroutines leaks

NEW IIS-Native plugin (v1.0.1, deprecates the existing IIS plugin)

New Plugin

The new IIS-Native plugin replaces the existing IIS plugin. The IIS-Native plugin provides the same set of metrics as it's predecessor without doesn't requiring installation of Microsoft IIS Administration API. This provides a simpler configuration while still gathering information about connections, requests, memory, and network statistics for webservers, application pools, and websites.

Logs plugins suite (17.1.6)

New feature

Added default name selector for Kubernetes Event forwarder

Fixes

Fixed unload for syslog collector

Metrics and processes publisher plugins (49.1.4)

Fixes

Command of process is now properly sent for all processes
Fixed rare possibility of plugin crash when no host metadata was collected
Fixed description attribute while sending metrics

Mysql collector plugin (26.0.0)

Added support for mariaDB >= 10.5.4

Bridge collector (26.4.2)

Fixed configuration on Windows

Snap Chef Recipes - March 11, 2021

Return to top

Introducing the new SolarWinds Snap Agent Chef recipes. For installation instructions, see Installation - Snap Chef. For more information about the Snap Agent Chef recipes, see the swisnap Chef Supermarket page.

The Snap Agent Chef role installs the SolarWinds Snap Agent and allows a variety of customizations. For more detailed information about the role variables see the SolarWinds swisnap-cookbook repository.

4.1.0 - March 11, 2021

Return to top

In addition to performance improvements and bug fixes, the Snap Agent has been updated to include new bridge integrations (Jolokia2, Cassandra ), the ability to set the Elasticsearch client version, new log sources (Kubernetes events and syslog) and new log publisher options (Loggly http and http bulk endpoints, SolarWinds http endpoints, and Papertrail syslog publisher).

SWISnap (version 4.6.3)

Automatic obfuscation of sensitive data from agent logs
Fixed issue with invalid header when using watch task REST API
Improved performance
Fixed issue with crashing due to invalid configuration

System plugin (version 59.0.6)

Plugin is now integrated as a part of swisnapd agent binary and run under the same process
Fixed invalid metric values for per cpu metrics on Windows
Improved load metrics calculation on Windows
Fixed issue with not matching disk with devices for some of devices
Stability improvements
Updated default task file schedule

Processes plugin (version 12.0.0)

Plugin is now integrated as a part of swisnapd agent binary and run under the same process
Stability improvements

Processes publisher (version 49.1.1)

Plugin is now integrated as a part of swisnapd agent binary and run under the same process
Stability improvements

Metrics publisher (version 49.1.1)

Fixed issue with dropping whole metric batch if a single metric was invalid

New logs collectors suite (version 17.1.4)

All suite plugins are now integrated as a part of swisnapd agent binary and run under the same process
Support for custom tagging
Support for local logs caching for http log publishers.
Available plugins
- Syslog collector
- Docker logs collector
- Kubernetes events collector
- File collector
- Windows events collector
- Loggly http publisher
- Loggly http bulk publisher
- Loggly syslog publisher
- SolarWinds http publisher
- Papertrail syslog publisher

HAProxy plugin (version 13.0.0)

Fixed issues with collecting metrics from large number of endpoints

Bridge plugin (version 26.4.1)

Fixed issue with bridge_use_json_fields option, which did not take effect. Introduced bridge_convert_json_fields option.
Added option to specify metric_separator for statsd integration.
Updated example task file for redis integration
Fixed tags sections in example tasks for nagios, influx_listener, graphite_listener and collectd_listener
Fixed issue with not accepting metrics containing “+” character
New Jolokia2 integration
New Cassandra integration

RabbitMQ plugin (version 22.0.0)

Updated example task file with note on permissions

Elasticsearch plugin (version v18.0.0)

New setting allowing to configure Elasticsearch client version used by plugin.

4.0.1 - November 5, 2020

Return to top

OracleDb plugin (version 3):

Fixed issue with libc version incompatibility on CentOS/RHEL 6, preventing plugin from starting.

October 19, 2020

Return to top

A new Snap Agent Development Library is now available, which simplifies the creation of custom plugins for the SolarWinds Snap Agent, written in Go, Python, or C#.

4.0.0 - October 14, 2020

Return to top

SWISnap (version 4.4.5)

To prevent unauthorized access to the snap agent, REST API, swisnap, and swisnapd will use a Unix socket on Linux and a named pipe on Windows by default. These are only accessible by the root/solarwinds user/group on Linux and the system administrator users on Windows. If you were using REST API directly, either use the new defaults or modify the restapi section of the main Configuration (config.yaml) file to use the previous localhost defaults for the addr and port keys.
Plugin GPG checks for swisnapd are enabled by default to prevent running unverified plugins. If you are using unverified custom plugins, either disable GPG checks in the main configuration file (config.yaml) or make sure all of your custom plugins are signed. See Signing plugins to sign your custom plugins.
On Linux, configuration files in /opt/SolarWinds/Snap/etc will be only visible to the root/solarwinds user/group.
The format for tags in version 2 of the task file was changed to reflect a global tagging pattern.

What used to be:
```
tags:
  sometag: “true”
```
Is now:
```
tags:
  /:
    sometag:”true”
  /some/concrete/metric:
    someothertag: “false”
```

Improvements in the task listing using swisnap command

System plugin (version 58.0.8)

Fixes a possible panic on getting memory metrics on Windows
Internal improvements

Processes publisher plugin (version 48.0.2)

Fixes an issue where aggregated metrics weren't sent

Processes plugin (version 11.3.2)

Fixes an issue where system processes on Windows were not aggregating

Docker plugin (version 46)

Fixes issue that caused a high CPU usage of docker daemon

Kubernetes plugin (version 25)

Improved logging
Internal improvements

haproxy plugin (version 12)

Fixes for monitoring multiple endpoints

3.2.2 - August 26, 2020

Return to top

Bug fixes and other improvements:

Fixes issue with Linux installer wrongly updating token on upgrade, when new token was used
Fixes issue with installer script not detecting if agent was previously installed
snap (version 3.1.7)
- stability fixes
log plugin (version 16.0.5)
- Fixed issue with possible deadlock on closing plugin
processes plugin (version 11.3.0)
- Added option to configure worker pool used to fetch processes metrics
bridge plugin (version 26.2.0)
- exec integration is now available also on Windows platform

3.2.1 - July 30, 2020

Return to top

Added support for Oracle Linux versions 6 and 7
Snap (version 3.1.3)
- Fixed an issue with leaking file descriptors
- Fixed an issue with loading twice plugin over REST API
- Fixed an issue with segmentation fault while closing swisnapd
- Added support for communicating with plugins in version 2 over TLS
- Added a TLS section in config.yaml on Windows machines
- Swisnapd will not run binary that is not located in its default bin folder
- Improved logging
iis plugin (version 7)
- Updated the configuration file
System plugin (version 58.0.3)
- Fixed an issue with high CPU usage on large systems
- Fixed logging levels for some messages
Log plugin (version 16.0.3)
- Fixed an issue with spoiling log file after clean installation

3.2.0 build 742 - Jul 02, 2020

Return to top

Updated plugins:
- logs plugin (version 16.0.1):
  - Added docker logs monitoring feature
  - Comes with a couple handy sample task files for various logs sources
  - Switched to v2 plugin API
- bridge and bridge-stream plugins (version 26.1.0):
  - Sample task files for various services now come with an easy way of adding logs monitoring (where applicable)
Initial release of Ansible swisnap role 1.0.0 on Ansible Galaxy For more detailed information about the role variables please check the swisnap role repository

3.1.1 build 717 - Jun 15, 2020

Return to top

Updated plugins:
- processes plugin (version 11.2.0):
  - Fixed issue with high CPU usage / optimized processes data fetching.

3.1.0 build 702 - Jun 02, 2020

Return to top

snap (version 3.1.0):
- Updated default configuraiton file.
- Added possibility to set log output to stdout or specific file.
- Fixed issue with validating GPG signatures for plugins.
- Fixed issues with using semver with some of the swinsap command options.
Updated plugins:
- appoptics and processes publishers (version 48.0.1):
  - Fixed issue with possible panic if /proc is not available.
- bridge and bridge-stream plugins (version 26.0.0):
  - Added integration with NGINX Plus. Refer to NGINX Plus API documentation.
  - More integrations are now also available on Windows platform:
    - Cassandra
    - Consul
    - Fluentd
    - Graphite
    - InfluxDB
    - NGINX
    - NGINX Plus
    - NGINX Plus API
    - PostgreSQL
    - Prometheus
    - StatsD
    - Socket Listener
    - Zookeeper

3.0.1 build 685 - May 25, 2020

Return to top

Fixed issue with after-upgrade Linux script logging, when token was not found
Updated plugins:
- processes plugin (version 11.1.0):
  - Fixed issue with sometimes failing to show CPU for key processes on Windows systems.

3.0.0 build 679 - May 21, 2020

Return to top

This release introduces new version of SWISnap agent that supports new configuration structure for tasks and plugins, introduces new V2 plugin framework, new syntax for filtering metrics, new REST API, and several updated plugins. We have made every effort to keep backward compatibility with version 2 of package and not to require any action from user side, nevertheless please pay special attention while upgrading to new version and read updated documentation.

Updated agent knowledge base.
Previous separate release notes for Linux and Windows are now merged into one.
Added support for Ubuntu 20.04
Fixed issue with not working -allow-unsupported option for Linux installer script.
snap (version 3.0.0):
- Updates configuration file.
- Introduces new plugin framework.
  - New syntax for task files, that allows defining all you need in one place.
  - New syntax for metrics.
- Updates swisnap command line tool.
- Introduces version 3 of REST API with improved capabilities for managing and monitoring plugins and tasks.
Updated plugins:
- system plugin (version 58.0.0):
  - Updated to support new plugin framework. Refer to plugin documentation for more details.
- processes plugin (version 11.0.0):
  - Updated to support new plugin framework. Refer to plugin documentation for more details.
  - Fixed issue with possible panic when deadline collecting metrics was hit.
  - Added new option processes_check_timeout specifying timeout for collecting processes data from OS. Default value is 30s.
- appoptics and processes publishers (version 48.0.0):
  - Updated to support new plugin framework. Refer to plugin documentation for more details.
- bridge plugins (version 25.0.0):
  - Introduced new snap-plugin-collector-bridge supporting new plugin framework. This plugin is depreciating all non streaming bridge plugins providing their functionality. For backwards compatibility, agent package still contains old plugins, but they will not be updated. Supported integrations by new plugin:
    - Consul
    - Exec
    - Fluentd
    - MS SQL Server
    - Nagios
    - NGINX
    - NTPQ
    - PHP-FPM
    - Postgres
    - Prometheus
    - Redis
    - StatsD
    - Tomcat
    - Varnish
    - Zookeeper
  - Introduced new snap-plugin-collector-bridge-stream supporting new plugin framework. This plugin is depreciating all streaming bridge plugins providing their functionality. For backwards compatibility, agent package still contains old plugins, but they will not be updated. Supported integrations by new plugin:
    - Collectd
    - Graphite
    - InfluxDB
    - Socket Listener

2.7.5 build 577 - Apr 15, 2020

Return to top

Disabled downloading of Loggly CA certificate during installation. Loggly does not require to download CA certificate for sending logs over TLS anymore. Refer to Loggly FAQ for more details.

Updated plugins:
- log plugin (version 15):
  - Updated plugin configuration file to use host certificate store for sending logs over TLS to loggly.

2.7.4 build 562 - Apr 02, 2020

Return to top

Updated mode of logrotate configuration file

Updated plugins:
- bridge plugins (version 24):
  - Fixed issue with connecting to postgresql version 12 in postgresql plugin.
  - Updated postgresql plugin configuration file.
  - Updated sqlserver plugin configuration file. This version of plugin adds new metric groups that can be collected.

2.7.3 build 493 - Feb 24, 2020

Return to top

Updated plugins:
- system plugin (version 57):
  - Fixed issue with random spikes for disk capacity metrics.

2.7.2 build 480 - Feb 12, 2020

Return to top

Added downloading of Loggly CA certificate.
snap (version 2.5.4):
- Fixed issue with possible deadlock during snap shutdown.
- Updated main configuration file.
Updated plugins:
- log plugin (version 14):
  - Updated plugin configuration to use TLS by default.
  - Added loggly_ca_certificate_path setting for specifying path to Loggly public CA certificate. Refer to plugin documentation for more details.
- system plugin (version 56):
  - Improved performance.
  - Added system_query_timeout setting for configuring timeout used to fetch system statistics (like i.e. disk metrics).Refer to documentation for more details.
- elasticsearch plugin (version 17):
  - Plugin supports additional formats for connection strings. See plugin documentation for more details.

2.7.1 build 440 - Jan 20, 2020

Return to top

Added support for RHEL/CentOS 8
snap (version 2.5.3):
- Improved errors logging
Updated plugins
- publisher plugin (version 47):
  - New configuration parameter host_check_timeout allows to configure timeout for querying host operating system for identification information.
  - Improvements in reading EC2 metadata.

2.7.0 build 358 - Nov 7, 2019

Return to top

snap (version 2.5.1):
- Fixed issue with not adding tags defined in the task file for some dynamic metrics
- REST API now is listening only on the local interface by default
- Fixed issue with expanding "${}" strings in configuration files to environment variables, preventing of using "${" in i.e. passwords.
New plugins
- oracledb plugin (version 2):
  - Collects metrics from oracle databases. Refer to plugin documentation for instructions.

2.6.5 build 320 - Oct 15, 2019

Return to top

Moved appoptics publisher floor_seconds and period settings to global config.yaml and removed them from plugins tasks files
Restored APPOPTICS_INSTALL_ONLY flag in installer script
Updated plugins
- log plugin (version 12):
  - Updated example configuration and task file
  - Fixed issue with invalid calculation of message when max_line_length is configured
- rabbitmq plugin (version 21):
  - Fixed issue with collecting metrics from older rabbitmq instances
- mysql plugin (version 25):
  - Updated configuration file
  - Fixed memory leak when plugin cannot connect to database
- elasticsearch plugin (version 16):
  - Fixed issue with spamming logs with warning that elasticsearch endpoint is not reachable
- publisher plugin (version 46):
  - Added proxy support for processes publisher

2.6.4 build 217 - Aug 12, 2019

Return to top

Fixed issue with possible crash of swisnapd when streaming plugin restarts due to its errors.
Updated plugins
- processes plugin (version 9):
  - updated configuration of a plugin. Now using only task file. Refer to processes plugin documentation for more details.

2.6.3 build 190 - Jul 31, 2019

Return to top

Sorting output of swisnap plugins/tasks list command
Fixes issue with increasing memory usage by swinsnapd when streaming type plugin restarts due to errors.
Updated plugins
- system plugin (version 53):
  - Improved performance
- mysql plugin (version 22):
  - plugin accepts multiple mysql connection strings and can monitor multiple mysql instances. Refer to mysql plugin documentation for more details.

2.6.2 build 421 - Jul 10, 2019

Return to top

Improvements in logging
Updated plugins
- system plugin (version 52):
  - New configuration parameter exclude_disks. Refer to documentation for more details.
  - Fixes issue with missing metrics for some disk mounts
- bridge plugins (version 22):
  - Fixes memory leak in sqlserver bridge plugin

2.6.1 build 408 - Jun 26, 2019

Return to top

Fixed invalid configuration for logrotate on AmazonLinux
Fixed issue with not setting rest_auth_password in config.yaml when secure installation is chosen
Updated default timeouts for communication between snap and plugins. Now grpc_timeout and deadline options do not have to be specified in each plugin config
Updated plugins
- psm plugin (version 10):
  - Now submits metrics coming from ruby plugins as psm.plugin.<plugin_name>.<plugin_field>
  - No longer handles several system metrics (under psm.system.*) - a possible breaking change
  - Refer to psm plugin documentation for more details.
  - See also PSM migration tool for detailed instructions on how to use this with PSM custom Ruby plugins.
- mongodb plugin (version 12):
  - Added new per database statistic metrics
- processes plugin (version 8):
  - Fixed invalid calucation of processes CPU usage
- publisher plugin (version 44):
  - Fixed issue when plugin was posting empty metrics
- docker plugin (version 44):
  - Improved reconnect mechanism to docker event api

2.6.0 build 398 - Jun 06, 2019

Return to top

Fixed some linux installer issues
Updated plugins
- kubernetes plugin (version 22):
  - Added k8s events collection and filtering feature. Together with logs collector it's possible to forward gathered events to Loggly. Refer to kubernetes plugin documentation for more details.

2.5.2 build 393 - May 30, 2019

Return to top

Fixed some configs updating edge-case issues during package upgrade
Updated plugins
- publisher plugin (version 43):
  - Fixed issue with not sending global tags
- haproxy plugin (version 9):
  - Fixed issue with not handling special characters in password. Refer to haproxy plugin documentation for more details.
- processes plugin (version 4):
  - Fixed default config (no more warnings about it being empty)

2.5.1 build 336 - May 24, 2019

Return to top

Support for APPOPTICS_TOKEN environment variable during installation added back
Updated plugins
- processes plugin (version 3):
  - added tagging processes with command line arguments

2.5.0 build 324 - May 23, 2019

Return to top

Added option for enabling TLS for Agent REST API
Added option for enabling TLS communication between Agent and plugins
Implemented TLS communication for autoloaded plugins
Improved error logging
Added support for Ubuntu 19.04 "disco"
Added support for the new AO token format
New plugins
- processes plugin (collector and publisher):
  - collects metrics for processes running on the host. Refer to plugin processes documentation for more details.
Updated plugins
- system plugin (version 48):
  - added several new default metrics (processes, memory/swap, network). Refer to metrics documentation for more details.
- publisher plugin (version 42):
  - fixed API errors handling (no longer retries sending metrics on HTTP 400)
  - skipping empty tags while publishing metrics
  - improved logging

2.4.2 build 236 - Apr 29, 2019

Return to top

Changed agent log file permissions to only allow read/write for solarwinds user
Agent package contains GPG signature of all binaries shipped with a package. Users are now able to run agent with only trusted (GPG signed) plugins.
swisnapd -v command prints agent package version
Added support for Ubuntu 18.10
Updated plugins
- haproxy plugin (version 8):
  - fixed issue with invalid default task file preventing plugin from start

2.4.1 build 223 - Apr 8, 2019

Return to top

Fixed issue with logrotate on some operating systems.
Updated plugins
- publisher plugin (version 38):
  - fixed issue with sending invalid version of agent package
- mysql plugin (version 20):
  - fixed issue preventing plugin start due to not found metric.
  - added default tags to mysql plugin metrics: address, database, database version
- log plugin (version 5):
  - fixed issue with invalid default value for setting max_line_length

2.4.0 build 215 - Mar 27, 2019

Return to top

Fixed issue with invalid user permissions for logrotate SolarWinds Snap Agent default configuration. It prevented rotating swinsapd.log.
New plugins
- memcached plugin (version 3):
  - New plugin for monitoring Memcached. Refer to plugin memcached documentation for more details.
Updated plugins
- elasticsearch plugin (version 13):
  - Fixed issue with some metrics not updating properly.

2.3.0 build 208 - Mar 7, 2019

Return to top

Renamed package name from appoptics-snaptel to solarwinds-snap-agent. Refer to installation, configuration and upgrade instructions for more details.
Snap (version 2.2.0):
- Fixes issue with not restarting streaming plugins when they stop on error.
- Fixes issue with standard collectors reaching maximum grpc message size. Now standard collectors can send any number of metrics.
- Removed Tribe beta feature support.
New plugins
- log plugin (version 4):
  - New plugin that enables integration of the SolarWinds Snap Agent with Loggly or PaperTrail.. It allows for monitoring and filtering of selected by the user log files and sending them to SolarWinds log management services. Refer to logs plugin documentation for more details.

haproxy plugin (version 7):
- New plugin that enables collecting metrics from haproxy instances. Refer to haproxy plugin documentation for more details.

Updated plugins
- docker plugin (version 43):
  - Limitted number of blkio metrics reported by default. Now only total blkio metrics are reported.
- plugins with minor stability improvements:
  - apache plugin (version 20)
  - bridge plugins (version 18)
  - elasticsearch plugin (version 11)
  - iis plugin (version 4)
  - kubernetes plugin (version 21)
  - mesos plugin (version 11)
  - mongodb plugin (version 11)
  - mysql plugin (Version 19)
  - psm plugin (version 7)
  - system plugin (version 42)
  - rabbitmq plugin (version 17)
  - publisher plugin (version 37)
  - publisher file plugin (version 14)

2.2.1 build 143 - Jan 31, 2019

Return to top

Fixes issue with not setting AppOptics url when AppOptics token is not set while installing with package manager.
Updated plugins
- docker plugin (version 41):
  - Fixes corrupted config file template preventing plugin from start.
- mongoDb plugin (version 10):
  - Renamed plugin config file template.
- rabbitmq plugin (version 16):
  - Client management hosts discovery is now done based on /api/overview

2.2.0 build 124 - Jan 16, 2019

Return to top

Updated plugins
- bridge plugins (version 17):
  - This version introduces many stability improvements for all of bridge plugins.

2.1.0 build 98 - Dec 17, 2018

Return to top

New plugins
- iis plugin (version 3):
  - New plugin for monitoring Microsoft IIS. Refer to plugin IIS documentation for more details.
Updated plugins
- rabbitmq plugin (version 15):
  - This version introduces new implementation of a plugin, which is now streaming type.
  - Fixes issue with grpc message sizes seen in larger rabbitmq environment
  - Refer to plugin documentation for more details.
- elasticsearch plugin (version 10):
  - Stability fixes.
  - Changes in default metric tags. Added elasticsearch version and node name.
  - Updated default set of metrics in task file. Some metrics are no longer handled.
  - Added timeout option for connection elasticsearch API in config file.
- statsd plugin (version 12):
  - Added support for Librato tagging syntax.
- publisher plugin (version 36):
  - Fixed issue when plugin hang if docker was unresponsive.
- mysql plugin (version 18):
  - Update exemplary config file.
- docker plugin (version 40):
  - Fixed issue with sending NaN for docker.memory.usage.usage_percent and docker.cpu.usage.usage_percent metrics on plugin start.

2.0.0 build 1919 - Oct 15, 2018

Return to top

Added support for CloudLinux OS.
Fixes issue with watch_task API method not showing gathered metrics for streaming collectors.
Improved logging.
Fixes issues with collecting metrics when using streaming collectors. Metrics were send with delay.
Fixes issue with installing host agent on CentOS 6.7.
Updated plugins
- publisher plugin (version 35):
  - Fixes issues with collecting EC2 (OpenStack) metadata information causing duplication of hosts in Appoptics. Introduced ec2_check_timeout setting with default value 1s.
- system plugin (version 39):
  - Added disk bytes metrics to default task file.
- kubernetes plugin (version 18):
  - Added automatic conversion of kubernetes labels to metrics tags.
- docker plugin (version 38):
  - Stability fixes.
- apache plugin (version 17):
  - Added support for monitoring multiple webservers. See documentation and example config/task files for more details.
- mysql plugin (version 16):
  - Fixes authentication issue when connecting MySQL 8.
  - InnoDB metrics are now disabled by default.
- mongodb plugin (version 8):
  - New refactored mongodb plugin. Refer to plugin documentation and example config/task files for more details.
- elasticsearch plugin (version 8):
  - New elasticsearch plugin. Refer to plugin documentation and example config/task files for more details.

2.0.0 build 1849 - Aug 16, 2018

Return to top

Added support for RedHat 7.4 and Ubuntu 18.04
Fixes issue with not adding all tags to metrics for streaming collectors
Updated plugins
- publisher plugin (version 33):
  - Fixes various issues causing duplication of hosts in AppOptics
- system plugin (version 36):
  - Fixes issue where reported disk space was different from i.e. df command output
- docker plugin (version 35):
  - Stability improvements
  - Fixes issue with missing tags defined in task file
  - Fixes issue with image_name, which was shown as image hash
- kubernetes plugin (version 16):
  - This version introduces new implementation of kubernetes plugin, which is now streaming type. Comparing to previous version, it introduces better stability and performance.
  - Fixes issue with grpc message sizes too large
- bridge plugins (version 9):
  - Fixes issue with not recognized grpc_timeout configuration parameter

2.0.0 build 1814 - Jul 9, 2018

Return to top

Improved plugin autoload functionality and related issues with upgrading.
Improved last_failure_message shown with snaptel task list. Now it includes name of plugin that reported error.
Updated plugins
- publisher plugin (version 30):
  - Improved EC2 instance check logic.
  - Fixes issue with sending wrong version of agent in metadata
  - Global root tags from config.yml are now send in metadata
- docker plugin (version 32):
  - This version introduces new implementation of docker plugin, which is now streaming type. Comparing to previous version, it introduces better stability and performance.
  - Fixes issue with grpc message sizes seen in larger docker environment
  - Fixes issue with timeouts when gathering CPU statistics in larger docker environment
  - More metrics are now directly gathered from Docker API instead of filesystem.
  - Changes in default docker task file. New version by default sends only total metrics for network interfaces. Refer to task-aodocker.yaml.

2.0.0 build 1736 - Apr 23, 2018

Return to top

Updated plugins:
- publisher plugin (version 25):
  - AO-7276: moved x-host information to JSON body

2.0.0 build 1729 - Apr 11, 2018

Return to top

Reduce package size using xz compression.
Added the grpc_timeout plugin configuration, which can be used along with a task’s deadline configuration to increase the time allowed for collection or publishing.
Installer script (version 1.0.1) comes with --allow-unsupported flag that allows installation of unsupported versions of a supported platform.
Fixes for yum lock issues during installation on CentOS and Amazon Linux platforms.
Updated plugins:
- docker plugin (version 24):
  - Improved performance for collection of metrics.
  - Added deadline of 60s to task file to allow collection of more metrics.
  - Fixes issues with docker mounting points when running on ECS instances.
  - Fixes issues with incorrect memory usage calculations.
- system plugin (version 35):
  - Continue to collect disk usage metrics when some paths are not accessible.
- publisher plugin (version 23):
  - Split large batches into smaller batches when number of metrics is greater than 1000 measurements.
  - Retry 3 times when getting errors from collector endpoint.

2.0.0 build 1639 - Mar 20, 2018

Return to top

Improved shutdown process by terminating unresponsive plugins.
Support for publishing metrics using a HTTP/SOCKS5 proxy.
Reduced noise in the log file at info level.
Allow longer running tasks by increasing the default value of the deadline timeout from 5 seconds to 10 seconds.
Integrated plugins:
- rabbitmq plugin (version 11)
Updated plugins:
- system plugin (version 32) no longer provides CPU total tag
- docker plugin (version 20) report CPU and memory use percentage metrics

2.0.0 build 1475 - Feb 21, 2018

Return to top

Improved plugin unloading process to allow enough time for plugins to cleanup resources when plugin process exits. When plugin fails to exit and cleanup resources in 3 seconds, the plugin process is terminated.
Improved the speed for loading plugins, eliminated issues with user access rights required to load a plugin from a temporary location and with writing to a read only temp partition. New temp_dir_enable configuration variable sets whether the host agent starts plugins from temporary location indicated by temp_dir_path configuration variable. Default value is false, so plugins are not loaded from temp_dir_path directory.
Changed default value for plugin_default_timeout configuration variable from 3 seconds to 5 seconds.
Improved log formatting by setting log_format configuration variable to text.
Increased the number of consecutive health check failures that trigger a plugin failure to 10. A plugin is declared unresponsive and restarted when it fails for more than 10 consecutive times to respond to health checks.
Changed default value for max_plugin_restarts plugin configuration variable to -1. Host agent will not disable a plugin due to failures.
Changed default value for max-failures task configuration variable to -1. Host agent will not disable a task due to failures.

2.0.0 build 1467 - Feb 16, 2018

Return to top

Updated plugins:
- kubernetes plugin (version 10) which fixes loading issue
- system plugin (version 29) with improved reporting for disk IO when device is mounted by UUID

2.0.0 build 1318 - Nov 20, 2017

Return to top

Support Amazon Linux 2017.09, Debian 9 and Ubuntu 17.04
Integrated plugins:
- apache
- docker
- kubernetes
- mesos
- mysql
- nginx
Many additional beta plugins
Better logging

2.0.0 build 1164 - Nov 02, 2017

Return to top

More reliable service managment
Ability to enable/disable plugins via single yaml config file

Search SolarWinds Support

Snap Agent release notes

4.5.2 - December 2, 2024

SWISnap v4.14.9

SWI v1.3.6

Bridge V2(v26.4.8)

Apache V1(v22.0.3)

Apache V2(v23.0.13)

Docker V1(v47.0.5)

Docker V2(v48.2.10)

Kubernetes V1(v25.0.2)

Kubernetes V2(v26.0.9)

Elasticsearch V1(v18.0.2)

Elasticsearch V2(v19.2.5)

HaProxy V1(v13.0.3)

HaProxy V2(v15.0.11)

OracleDB V1(v4.0.2)

OracleDB V2(v5.0.8)

CRI v1.1.2

RabbitMq v24.0.3

MySQL v26.1.3

MongoDB v14.1.3

4.5.1 - December 15, 2022

Plugin updates

4.5.0 - August 22, 2022

Core Snap Agent updates

snap v4.14.8

New features and plugins

snap-plugin-collector-swi v1.3.1

apache v23.0.5

docker v48.2.2

kubernetes v26.0.5

elasticsearch v19.2.1

haproxy v15.0.4

oracledb v5.0.4

Plugins removed

In-process plugins updated

publisher-appoptics / processes v49.2.2

psutil v59.2.0

publisher-file v16.1.1

publisher uams v1.3.1

Regular plugins updated

iis-native v1.0.4

bridge v26.4.7

cri v1.0.6

elasticsearch v18.0.1

logs v16.0.9

memcache v6.0.0

mesos v14.0.0

mongodb v14.1.0

mysql v26.1.0

rabbitmq v24.0.0

4.4.0 - October 27, 2021

IIS Native (1.0.2)

Bridge (26.4.3)

Kubernetes (1.0.3)

Docker (47.0.2)

Oracle (4.0.1)

4.3.0 - July 22, 2021

SWISnap (4.6.13)

Logs plugins suite (17.2.0)

Processes plugin (12.0.2)

4.2.0 - June 14, 2021

SWISnap (4.6.6)

*NEW* IIS-Native plugin (v1.0.1, deprecates the existing IIS plugin)

Logs plugins suite (17.1.6)

Metrics and processes publisher plugins (49.1.4)

Mysql collector plugin (26.0.0)

Bridge collector (26.4.2)

Snap Chef Recipes - March 11, 2021

4.1.0 - March 11, 2021

SWISnap (version 4.6.3)

System plugin (version 59.0.6)

Processes plugin (version 12.0.0)

Processes publisher (version 49.1.1)

Metrics publisher (version 49.1.1)

New logs collectors suite (version 17.1.4)

HAProxy plugin (version 13.0.0)

Bridge plugin (version 26.4.1)

RabbitMQ plugin (version 22.0.0)

NEW IIS-Native plugin (v1.0.1, deprecates the existing IIS plugin)