LATEST VERSION: 1.3 - CHANGELOG
PCF Metrics v1.3

PCF Metrics Release Notes and Known Issues

This topic contains release notes for Pivotal Cloud Foundry (PCF) Metrics.

v1.3.0

Release Date: February 23, 2017

Notes

The following list describes what’s new in PCF Metrics v1.3.0:

  • Reduced Log Loss During Upgrades: PCF Metrics uses a temporary datastore during Elasticsearch downtime, including upgrades, to significantly reduce log loss by continuing to store app logs from the Loggregator Firehose. The temporary datastore is a new Redis component deployed with PCF Metrics that operators must size according to the needs of their system. See Configuring the Temporary Datastore for more information.

    Note: PCF Metrics only uses the temporary datastore when upgrading from v1.3 or later.

  • The Trace Explorer: PCF Metrics provides an interactive graph that allows you to trace requests as they flow through your apps and their endpoints, along with the corresponding logs. See the Trace App Requests section of Monitoring and Troubleshooting Apps with PCF Metrics.
  • Improved UI: PCF Metrics v1.3.0 includes several UI enhancements such as a new time selector and an improved UX for collapsing and expanding which views you are interested in. To view the UI and understand the new functionality, see Monitoring and Troubleshooting Apps with PCF Metrics.
  • Events: The Events graph now includes the following events:
    • SSH: This event corresponds to someone successfully using SSH to access a container that runs an instance of the app.
    • STG Fail: This event corresponds to your app failing to stage in PCF.

Known Issues

The following sections describe the known issues in PCF Metrics v1.3.0

Compatibility with Elastic Runtime

PCF Metrics v1.3.x requires Elastic Runtime v1.9.0 or later.

Metrics and Log Loss when Upgrading from v1.2 to v1.3

The upgrade process from v1.2 to v1.3 acts in the following sequence:

  1. Removes the data storage components of v1.2
  2. Deploys v1.3 data storage and ingestion components

The upgrade process does not save any v1.2 data and the new components do not begin ingesting and storing log or metrics data until they successfully deploy.

Smoke Test Failure

The PCF Metrics Smoke Test errand may fail if your deployment authenticates user sign-ons with an external SAML identity provider or an external LDAP server. In some cases, these external user stores have an additional login procedure that prevents the errand from authenticating with the deployment and validating against the Metrics API.

If you experience this issue, disable the Smoke Test errand in the PCF Metrics tile and click Apply Changes to run the install again.

See the Configure Authentication and Enterprise SSO section of the Configuring Elastic Runtime topic for more information on what configurations can lead to this failure.

For Operators who Deploy PCF Metrics using BOSH

If both of the following are true, you may experience issues while using PCF Metrics:

  • You deploy PCF Metrics using BOSH instead of using the PCF Metrics tile in Ops Manager.
  • You use self-signed certificates.

Pivotal recommends using certificates issued by a Certificate Authority for BOSH deployments of this product.

Past Minor v1.2.x

Release Notes for v1.1.x releases can be found here.

Past Minor v1.1.x

Release Notes for v1.1.x releases can be found here.

Past Minor v1.0.x

Release Notes for v1.0.x releases can be found here.

Create a pull request or raise an issue on the source for this page in GitHub