Skip to content

Commit

Permalink
minor copy edits
Browse files Browse the repository at this point in the history
  • Loading branch information
markdboyd committed Mar 25, 2024
1 parent 3bb89f5 commit db8ce6f
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions _kbarticles/2024-03-25-monitoring-app-metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ excerpt: How to monitor the CPU and memory metrics for your application on cloud

---

Like any hosting environment, cloud.gov offers [performance metrics that are incredibly useful for
One of the benefits of hosting your applications on cloud.gov is that it offers [performance metrics for
monitoring the health of your application](https://docs.cloudfoundry.org/loggregator/container-metrics.html).

The most important metrics for monitoring your application's health are the memory and CPU metrics, which can help you identify:
Expand All @@ -19,15 +19,15 @@ The most important metrics for monitoring your application's health are the memo

CPUs are virtualized and shared across application containers on a Diego cell virtual machine (VM).

[The CPU usage figure reported as part of the application metrics represents the CPU usage of an applicaiton instance as a percentage of a single CPU core][container metrics]. Thus, **it is possible for the CPU usage to exceed 100%**, which means your application is more than the compute power of more than a single CPU core.
[The CPU usage figure reported as part of the application metrics represents the CPU usage of an applicaiton instance as a percentage of a single CPU core][container metrics]. Since there are usually multiple CPU cores per VM, **it is possible for the CPU usage to exceed 100%**, which means your application is using the equivalent compute power of more than a single CPU core.

A CPU usage figure above 100% is not necessarily problematic. The more important metric for identifying scaling issues is CPU entitlement, which is [a formula Cloud Foundry uses to determine how much CPU your application **is allowed to use** from the host VM based on its memory capacity][container metrics].

If the CPU entitlement figure exceeds 100% for any application instance, then the instance is effectively borrowing spare CPU resources from the host VM. Since applications are regularly redistributed across the available host VMs, the amount of spare CPU capacity available on the VM can change, so any instances of CPU entitlement above 100% should be treated as an indication of insufficient scaling and addressed appropriately.

[Cloud Foundry provides a `cf` CLI plugin for determining if any of your applicaiton instances are exceeding their CPU entitlement](https://docs.cloudfoundry.org/loggregator/container-metrics.html#cpu-entitlement).

While the CPU usage figure does not independently reveal scaling issues, it is still worth monitoring as a relative value, since sudden spikes in the value can still indicate abnormal performance of your application.
While the CPU usage figure itself does not independently reveal scaling issues, it is still worth monitoring as a relative value, since sudden spikes in the value can still indicate abnormal performance of your application.

## Retrieving current memory and CPU metrics

Expand All @@ -54,7 +54,7 @@ they correlate to observed performance issues for your application.

Logs containining these application metrics are already ingested into the [Elasticsearch/Kibana instance for customer logs][kibana prod]. Furthermore, there are already built-in visualizations and dashboards for viewing these metrics for your applications.

To view the dashboard for application metrics, follow these steps:
To view the dashboards for application metrics, follow these steps:

1. Log in to [Kibana][kibana prod].
1. Click `Dashboard` in the bookmark links at the top of the page.
Expand Down

0 comments on commit db8ce6f

Please sign in to comment.