LATEST VERSION: 1.4 - RELEASE NOTES
PCF Metrics v1.2

Using PCF Metrics

This topic describes how to log in to, use, and interpret data from Pivotal Cloud Foundry (PCF) Metrics.

View an App in PCF Metrics

In a browser, navigate to metrics.YOUR-SYSTEM-DOMAIN and log in with your User Account and Authentication (UAA) credentials. Choose an app for which you want to view metrics. You can view any app for which you are a Space Developer.

Search for an app

PCF Metrics provides you with a graphical representation of application data for a given time frame, along with the corresponding application logs. See the sections below to Toggle the Data Views and Change the Time Frame. See the Interpret Metrics section for more information on each data view.

Metrics UI

Toggle the Data Views

There are four data views: Container Metrics, Network Metrics, Logs, and Events. Select which views you want to see using the toggles in the upper left.

Toggle

Change the Time Frame

The data views show time along the horizontal axis. You can change the time frame for all the data views by using the dropdown at the top of the page. Use the refresh button to update all views with the most current data.

time

Zoom: From within any data view, you can also zoom in on areas of interest by clicking and dragging within the graph. This adjusts all of the views, including Logs, to show data from that time period.

Metric zoom

Drag: From underneath the x-axis of any data view, you can drag left or right to view data for an earlier or later time.

Interpret Metrics

PCF Metrics displays the following data. You can hover over each view to see data for a specific time.

Container Metrics

The Container Metrics view displays CPU, Memory, and Disk usage:

Container View

  • A spike in CPU might point to a process that is computationally heavy. Scaling app instances can relieve the immediate pressure, but investigate the app to better understand and fix the root cause.
  • A spike in Memory might mean a resource leak in the code. Scaling app memory can also relieve the immediate pressure, but look for and resolve the underlying issue so that it does not occur again.
  • A spike in Disk might mean the app is writing logs to files instead of STDOUT, caching data to local disk, or serializing huge sessions to disk.

Network Metrics

The Network Metric view displays HTTP Requests & Errors and Latency:

Network View

  • A spike in HTTP Requests means more users are using your app. Scaling app instances can reduce the higher latency that may result.
  • A spike in HTTP Errors means one or more 5xx errors have occurred. Check your app logs for more information.
  • A spike in Latency means your users are waiting longer to use your app. Scaling app instances can spread that workload over more resources and result in faster response times.

Events

The Events view shows the following app events: Create, Update, Start, Stop, and Crash. You can change which events you see using the checkboxes in the upper right.

Events

See the About Starting Applications and Troubleshooting Application Deployment and Health topics for more information about app events.

Logs

Logs displays application log data ingested from the firehose. See the Application Logging in Cloud Foundry topic for more information.

Logs

PCF Metrics lists all logs by default, and the histogram displays log frequency for the current time frame. You can refine the list and histogram with the following:

  • Filter: Perform a keyword search. The histogram updates with blue bars based on the filter. Hover over a histogram bar to view the amount of logs for a specific time based on your filter.
  • Highlight: Enter a term to highlight within your search. The histogram updates with yellow bars based on the results. Hover over a histogram bar to view the amount of logs for a specific time that contain the highlighted term.
  • Sources: Choose which sources to display logs from.
  • Order: Modify the order in which logs appear.

You can also click the Download button to download a file containing logs for the current search.

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