Follow

Version 4.2.3 - December 16, 2015

Version 4.2.3

The final Meter 4.2.3 build is available as of December 16th, 2015.

Build number 4.2.3-639.

Support for Debian 8 (Jessie)

Meter support for Debian 8 (Jessie) is now included.

Docker Support

The meter now supports execution inside a Docker container.  Docker images and information can be found on https://hub.docker.com/r/bmctruesightpulse/meter.

First-Class Support for Key/Value Pair Properties

Alongside usual tag values that are essentially a label (e.g. webserver), the meter now fully supports a new "properties" object containing key/value pairs (e.g. nginx_ver=1.9).  Properties can be added when installing a meter via setup_meter.sh (e.g. setup_meter -p k=v[,k=v...]) or installing the meter package directly (e.g. PROVISIONPROPERTIES="k=v" dpkg -i boundary-meter4.2.3-639~trusty_amd64.deb).

AWS EC2 Automatic Tag Detection via Temporary Credentials

The new meter will detect, when provisioned on your server, if it is running inside an AWS EC2 instance.  If so, and if the AWS CLI tools are present, the meter will attempt to request temporary credentials via an IAM role assigned to the EC2 instance.  On successful retrieval of credentials, the meter will go locate any tags assigned to the EC2 instance and apply those tags as tags (labels) and properties (key/value pairs) to the meter.  If the meter fails to secure temporary credentials, it will look for environment variables containing the AWS KEY info and, if found, attempt to use those to retrieve the EC2 tags.

Stability Fixes and Improvements

This meter release contains numerous stability fixes and performance improvements to the 4.2.2 meter.  Users are encouraged to upgrade to this new release.

 

The meter configuration file has changed slightly to allow more tuning of premium behaviors.  Below is the full list of all configuration fields.

 

debug
Enables extra debugging (values 1-4, 0 disables). The default value is 0.

http_max_log_kb
Max file size in KB when logging http debug data. The default value is 1024.

enterprise_api.enable
Enables or disables access to the Enterprise API. The default value is false.

enterprise_api.api_key
The API key for accessing the Enterprise API.

enterprise_api.org_id
The Organization ID for accessing the Enterprise API.

enterprise_api.host
The hostname of the Enterprise API endpoint. The default value is api.boundary.com.

enterprise_api.plaintext
Determines whether to access the Enterprise API HTTP (true) or HTTPS (false). The default value is false.

enterprise_api.compress
Determines whether to enable HTTP compression accessing the Enterprise API. The default value is true.

enterprise_api.port
Override the default port for accessing the Enterprise API. The default value is 443.

premium_api.enable
Enables or disables access to the Premium API. The default value is true.

premium_api.remote_plugins_enabled
Enables or disables remote plugin support. If disabled, plugins can only be local, and are disabled in the UI. The default value is true.

premium_api.token
The API token for accessing the Premium API. The default value is api.43b65b8ffd-2026.

premium_api.poll_interval_ms
The amount of time between walking the metrics hash. This should be < 1000 ms. The default value is 500.

premium_api.measurements_interval_ms
The amount of time to batch metrics before forwarding to the API. The default value is 4000.

premium_api.events_enable
Enabled sending events to the backend api. If this is disabled, the events will be logged as an info level debug message.. The default value is true.

premium_api.events_interval_ms
The amount of time to batch events before forwarding to the API. The default value is 4000.

premium_api.log_interval_ms
The amount of time between sending log data to console output API.. The default value is 4000.

premium_api.heartbeat_interval_ms
The amount of time between heartbeat API calls for time synchronization. The default value is 1800000.

premium_api.max_backlog
The maximum number of metrics that will be queued between send intervals. The default value is 1000.

premium_api.timeout_ms
The maximum time to wait for an API transaction to succeed. The default value is 15000.

premium_api.config_interval_ms
Interval between polling for config updates. The default value is 20000.

premium_api.backoff_s
The amount of time to backoff if there is an error pushing metrics to the API. The default value is 120.

premium_api.plaintext
Determines whether to access the Premium API HTTP (true) or HTTPS (false). The default value is false.

premium_api.compress
Determines whether to enable HTTP compression accessing the Enterprise API. The default value is true.

premium_api.host
The hostname of the Premium API endpoint. The default value is premium-api.boundary.com.

premium_api.metadata_interval_ms
The amount of time between checking for metadata updates. The default value is 30000.

premium_api.port
Override the default port for accessing the Premium API. The default value is 443.

premium_api.metrics_prefixes
Forwards all local metrics with given prefix. For example, specifying "statsd" will forward all statsd metrics. Specifying 'system.os.loadavg' will forward all system load average metrics.

premium_api.metrics_map
Maps local metrics to different premium metric names. Metrics are specified with a source, followed by the metric name. For example, if you expect a metric from the statsd sink called "my.metric", the source name would be "statsd.my.metric". The entry "statsd.my.metric": { "name": "MY_METRIC" } would remap a local statsd metric to a premium metric called MY_METRIC. Supported sources are 'system' for internal metrics, 'statsd', 'graphite' and 'collectd'.

premium_api.system_metrics_intervals
These values are in milliseconds and determine the collection interval for each metrics area.

premium_api.tags
A list of tags (labels) to be sent as metadata.

premium_api.properties
A collection of properties (key/value pairs) to be sent as metadata.

premium_api.validate_plugins
Enables or disables plugin validation. The default value is true.

premium_api.local_plugins_check_s
The amount of time between checks for local plugin changes. The default value is 15.

collectd_sink.enable
Enables or disables listening for collectd metrics. Collectd metrics are prefixed with 'collectd.'. The default value is false.

collectd_sink.port
Override the default port for listening for collectd metrics. The default value is 25826.

collector.enable
Enables or disables sending IPFIX flow data to Boundary Enterprise. The default value is false.

collector.collectors
List of collectors to try for sending IPFIX flow data.

collector.mode
IPFIX data format (biflow is currently the only supported mode). The default value is biflow.

collector.msg_burst_ms
Minimum interval between sending IPFIX messages. The default value is 100.

collector.msg_timeout_s
Amount of IPFIX messages to queue before discarding if the IPFIX collector is down. The default value is 15.

collector.certfile
SSL Certificate file to use for authenticating with the IPFIX collector. The default value is cert.pem.

collector.cafile
SSL CA Certificate file to use for authenticating with the IPFIX collector. The default value is ca.pem.

collector.keyfile
SSL Key file to use for authenticating with the IPFIX collector. The default value is key.pem.

graphite_sink.enable
Enables or disables listening for graphite metrics. Graphite metrics are prefixed with 'graphite.'. The default value is false.

graphite_sink.port
Override the default port for listening for graphite metrics. The default value is 2003.

packet_capture.log_stats
Periodically log low-level capture statistics. The default value is false.

packet_capture.disable_acceleration
Disable packet capture acceleration. Leave this disabled for the best performance. The default value is false.

packet_capture.promiscuous_mode
Enable capturing all packets, even those not directed at a local network interface. The default value is false.

packet_capture.account_l2_overhead
Add Ethernet Layer-2 packet overhead into network flow bandwidth statistics. The default value is false.

http_proxy.enable
Enables or disables use of an HTTP proxy server. The default value is false.

http_proxy.hostname
The name or web address of a proxy server if one is to be used.

http_proxy.port
The port of the proxy server. The default value is 8080.

http_proxy.type
Can be either 'http' or 'socks5'. The default value is http.

http_proxy.user
User name if required for proxy login.

http_proxy.password
Password if required for proxy login.

http_proxy.auth
Can be either 'basic', 'digest', or 'ntlm'. The default value is basic.

ipfix_sink.enable
Enables or disables listening for IPFIX flow metrics. The default value is false.

sdk.count_per_route
Enable (true) or disable (false) sending per route request count measures. The default value is true.

sdk.cpu_time_per_route
Enable (true) or disable (false) sending per route cpu time measures. The default value is false.

sdk.resp_time_per_route
Enable (true) or disable (false) sending per route response time measures. The default value is false.

sdk.resp_time_threshold
The lower limit of response time in milliseconds for sending route level data - responses which take more time than this setting can be sent to the backend. Note: there is a server side threshold also for this value, setting the client side threshold lower than the server side threshold will have no effect as the data will be thrown away on the server side. The server threshold is 100 ms. The default value is 10.

sdk.max_reported_routes
The maximum number of reported routes by the meter. Only the top N response times will be reported. The default value is 10.

sdk.route_response_time_sort_by
The aggregate criteria by which the meter will sort the top routes. Valid aggregation functions are max, mean and count. The default value is max.

sdk.file
The Unix domain socket path for the SDK ingress on Linux/Unix. The default value is /tmp/gd.agent.sock.

sdk.port
The UDP socket port for the SDK ingress on Windows. The default value is 26873.

statsd_sink.enable
Enables or disables listening for statsd metrics. Statsd metric names are prefixed with 'statsd.'. The default value is false.

statsd_sink.port
Override the default port for listening for statsd metrics. The default value is 8125.

boundaryd_sink.enable
Enables or disables listening for boundary events. The default value is true.

boundaryd_sink.port
Override the default port for listening for boundary events. The default value is 8130.

tls.skip_validation
Enables or disables validating server-side TLS certificates. This is useful for debugging on-premise installations. The default value is false.

meter_command.enable
Enables or disables the meter command channel. The default value is true.

meter_command.port
Override the default port for meter commands. The default value is 9192.

privileges.user
Sets the user to run the meter and child processes as. The default value is boundary.

container.mode
Sets the mode for flagging if the meter is in a container (ie: docker). 'auto' = Meter decides container mode (default), 'off' = Turns container mode off, 'on' = Turns container mode on. The default value is auto.

container.send_core_metrics
Determine whether the meter sends core metric data - cpu, disk, memory, and net I/O - when running inside a container. The default value is false.

Have more questions? Submit a request