streams-metric-exporter 5.0.1

Streams version 5.x Metric Exporter

This release is for IBM Streams version 5.x (NOT 4.x).
This release is based on the 4.0.0 release and includes additional features below

Docker Container

bmwilli1/streams-metric-exporter:5

New Features

Cloud Pak for Data / OpenShift Template

See the openshift directory for an openshift template that can be used to stand up the streams metric exporter, prometheus, and grafana and point to an IBM Streams instance running in Cloud Pak for Data
See README.md for instructions

Bug Fixes

• Fix environment variables to treat all white space values as null (not set)

streams-metric-exporter 4.0.0

Streams version 4.x Metric Exporter

This release adds new metrics, simplifies the code base by removing most JMX notifications, and fixes multiple bugs/issues

Docker Container

bmwilli1/streams-metric-exporter

New Version Scheme

All new major version numbers will correspond to the major version of IBM Streams they are compatible with. Streams 5.x removes the concept of a Domain, and thus not compatible with the existing code base. Version 5.x of the streams-metric-exporter will be coming soon.

New Features

• Enable /metrics endpoint to meet prometheus standard (Issue #20)

New Metrics (Issue #27)

• streams_domain_status
• streams_domain_startTime
• streams_domain_creationTime
• streams_instance_creationTime
• streams_instance_startTime
• streams_instance_health
• streams_job_health
• streams_job_status
• streams_job_submitTime
• streams_pe_status
• streams_pe_health
• streams_resource_status

New/Enhanced Sample Dashboards

• IBMStreamsDomainDashboard - enhanced
• IBMStreamsInstanceDashboard - enhanced
• IBMStreamsJobDashboard - NEW
• IBMStreamsResourceDashboard - NEW

Enhancements / Refactoring

• Removed need for JMX Notifications in Jobs and Instances - Job list now driven by snapshots and metrics on each refresh

Deprecated Features

• streams_job_healthy has been deprecated (and will be removed in the future), use streams_job_health.

Removed Features

• Removed all of the /jobs REST endpoints. No longer needed and not used

Bug Fixes

#29 Handle PE Move to different resource
#25 Check Instance Status change on refresh

streams-metric-exporter 1.3.2

Bug Fix

Fix Issue: #29

Details

Prior versions did not handle notifications of PE's being relocated to different resources correctly. In some cases there were duplicate metrics and in others, the resource label was not updated for the PE metrics.

streams-jmx-client 1.1.1

#Bug Fix
Use newer Jackson version for Issue #28

streams-metric-exporter 1.3.1

Bug Fix

• Catch IllegalArgumentException when generating prometheus metric without proper labels.

Details

Given the way metrics are generated based on output of Streams JMX Service, there seems to be occasions (rare) that the values we use to generate the labels for certain metrics are not valid. This fix will catch the error and print out log information describing the name of the metric and the set of labels that were trying to be used.

streams-metric-exporter 1.3.0

New Features

• Streams JMX Server Failover Support (Issue #19). Accepts a comm-separated list of JMX URI's
• Add operatorkind label to all metrics at the Operator level and below (Operator, Operator Input Port, Operator Output Port)

Enhancements

• Improved error messages if user does not have permissions to read domain information

streams-jmx-client 1.1.0

New Features

• Add removeproperty command which handles instance properties and application environment variables
• Enhance getproperty and setproperty commands to handle application environment variables

streams-jmx-client 1.0.0

streams-jmx-client-1.0.0

Update README

streams-metric-exporter 1.2.0

Bug Fix

• Sanitize metrics generated for prometheus based on streams metrics

Details

Prometheus does not handle special characters in metric names except for (underscore) and (colon). In Streams 4.3, the ThreadedSplit creates a metric named "streams_operator_nItemsQueued (port x)". This is not a valid prometheus metric and in prior version of streams-metric-exporter will cause a crash.
This fix sanitizes metrics to be valid. See the README.md for more details.

streams-metric-exporter 1.1.0

New Features

• Handle Dynamic UDP Changes which may recreate PE's with new PE IDs
• Add resource label to all metrics at the PE level and below (e.g. PE, Operator, Ports, Connections, etc.)
• Add new REST endpoint "/version"

Bug Fixes

• Handle adding/removing Streams Instances to Domain without requiring restart