Merge pull request #115 from loggregator/add-core-counting

add core counting information

Author: fifthposition

core-counting.html.md.erb

@@ -0,0 +1,39 @@
+---
+title: Core Counting
+owner: TAS Observability
+---
+
+
+This topic explains how to configure your tile to take advantage of Ops
+Manager's ability to count physical and virtual cores. This option is available
+starting in Ops Manager versions v3.0.10+LTS-T and v2.10.58.
+
+Warning: In the following paragraph we refer to SKU. This is not technically a
+VMware SKU. We use the concept because some tiles share a license, e.g. TAS, TASW,
+and IST. A core can run all three of these products at the same
+time with a single core license without being double counted.
+
+Tile developers can add monit jobs named `SKU-<SKU_NAME>` to their VMs to let
+Ops Manager know to count all of that VM's cores as part of a SKU. VMs with the
+same SKU will be counted together. If no matching monit jobs are present, no
+cores will be counted for those VMs. For example: if you wanted to create and
+specify a SKU of the name `TEST`, you must define a monit job with the name
+`SKU-TEST`. A simpler way for VMware tile developers to define such a monit job
+for linux and windows VMs is to use the internal count-cores-indicator-release.
+
+When workloads are being run on vSphere, if multiple VMs are being run on the
+same host, the total counted cores of a given SKU will never be more then the
+number of physical cores on that host. On other infrastructures Ops Manager
+uses the values returned by the kernel for number of cores and threads per
+core.
+
+The Bosh Director counts all the relevant cores once per hour and stores up to
+2MB of historic measurements. Click the "Download Core Consumption Data" button on Ops
+Manager, or curl the `/api/v0/download_core_consumption` API endpoint
+to retrieve a CSV of all the measurements. Each row in the CSV is formatted as
+follows:
+
+```
+timestamp, product identifier/SKU, physical core count, virtual core count
+```
+

toc.md.erb

@@ -26,6 +26,7 @@
         *   [Securing service credentials with runtime CredHub](/docs-tiledev/ssi-creds-tiledev.html)
     *   [How to integrate services with Cloud Foundry's logging system](/docs-tiledev/nozzle.html)
     *   [Syslog: migrating existing configuration](/docs-tiledev/migrating-syslog-configuration.html)
+    *   [Core Counting](/docs-tiledev/core-counting.html)
 *   [**Service brokers**](/docs-tiledev/service-broker-index.html)
     *   [Service broker resources](/docs-tiledev/service-brokers.html)
     *   [Example service brokers](/docs-services/examples.html)