payload: {"action":"created","comment":{"url":"https://api.github.com/repos/DataDog/documentation/pulls/comments/360036887","pull_request_review_id":334873855,"id":360036887,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDM2MDAzNjg4Nw==","diff_hunk":"@@ -7,64 +7,200 @@ aliases:\n \n ## Overview\n \n-In general, [custom metrics][1] refers to any metrics that are not part of the regular integration suite, for example using custom checks or API-level metrics in your application stack.\n+If a metric is not submitted from one of the [350+ Datadog integrations][1] it's considered a [custom metric][2]<sup>[(1)](#standard-integrations)</sup>.\n \n-* Billable count is based on average number of `custom metrics / hour` for the month.\n-* Pro plans include 100 custom metrics per host.\n-* Enterprise plans include 200 custom metrics per host.\n-* The number of metrics is averaged across all paid hosts.\n-* Additional custom metrics packages can be purchased.\n+## Allocation\n \n-Contact [Sales][2] or your [Customer Success][3] Manager to discuss custom metrics for your account.\n+You are allocated a certain number of custom metrics based on your Datadog pricing plan:\n \n-### Standard integrations\n-The following standard integrations can potentially emit custom metrics.\n+* Pro: 100 custom metrics per host.\n+* Enterprise: 200 custom metrics per host.\n+\n+These allocations are counted across your entire infrastructure. For example, if you are on the Pro plan and licensed for three hosts, 300 custom metrics are allocated. The 300 custom metrics can be divided equally across each host, or all 300 metrics can be used by a single host. Using this example, the graphic below shows scenarios that do not exceed the allocated custom metric count:\n+\n+{{< img src=\"account_management/billing/custom_metrics/host_custom_metrics.png\" alt=\"host_custom_metrics\" responsive=\"true\" >}}\n+\n+The billable number of custom metrics is based on the average number of custom metrics (from all paid hosts) per hour over a given month. Contact [Sales][3] or your [Customer Success][4] Manager to discuss custom metrics for your account or to purchase an additional custom metrics package.\n+\n+## Tracking Custom metrics\n+\n+Administrative users (those with [Datadog Admin roles][5]) can see the total custom metrics per hour and the top 500 custom metrics for their account on the [usage details page][6]. See the [Usage Details][7] documentation for more information.\n+\n+For more real-time tracking of the count of custom metrics for a particular metric name, click into the metric name on the [Metrics Summary page][8]; it’s listed as “Currently reporting # distinct metrics…” as shown below:\n+\n+{{< img src=\"account_management/billing/custom_metrics/tracking_metric.mp4\" alt=\"Tracking metric\" video=\"true\" responsive=\"true\">}}\n+\n+## Counting Custom Metrics\n+\n+**A custom metric is uniquely identified by a combination of a metric name and tag values (including the host tag)**:\n+\n+* Reporting the same metric name on multiple hosts results in multiple custom metrics.\n+* Adding tags on a metric can change the number of custom metrics (number of unique tag value combinations) associated with that particular metric. See the [Effect of Adding Tags](#effect-of-adding-tags) section.\n+* Reordering tag values doesn’t add uniqueness. The following combinations are the same custom metric:\n+\n+  *  `metric_name{env:dev, service:foo}`\n+  *  `metric_name{service:foo, env:dev}`\n+\n+Below are examples of how to count your custom metrics. The number of custom metrics associated with a particular metric name depends on its metric [submission type][9]. Suppose you’re submitting a metric, `request.Latency`, from two hosts (`host:A`,`host:B`), which measure the latency of your endpoint requests. You’re submitting this metric with two tag keys:\n+\n+* `endpoint`  that has the value `endpoint:X` or `endpoint:Y`.","path":"content/en/account_management/billing/custom_metrics.md","position":49,"original_position":49,"commit_id":"8f84a4a19ec4863d02e65853110abb4b44d9a8bb","original_commit_id":"8f84a4a19ec4863d02e65853110abb4b44d9a8bb","user":{"login":"cswatt","id":1680226,"node_id":"MDQ6VXNlcjE2ODAyMjY=","avatar_url":"https://avatars2.githubusercontent.com/u/1680226?v=4","gravatar_id":"","url":"https://api.github.com/users/cswatt","html_url":"https://github.com/cswatt","followers_url":"https://api.github.com/users/cswatt/followers","following_url":"https://api.github.com/users/cswatt/following{/other_user}","gists_url":"https://api.github.com/users/cswatt/gists{/gist_id}","starred_url":"https://api.github.com/users/cswatt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cswatt/subscriptions","organizations_url":"https://api.github.com/users/cswatt/orgs","repos_url":"https://api.github.com/users/cswatt/repos","events_url":"https://api.github.com/users/cswatt/events{/privacy}","received_events_url":"https://api.github.com/users/cswatt/received_events","type":"User","site_admin":false},"body":"```suggestion\r\n* `endpoint`, which has the value `endpoint:X` or `endpoint:Y`.\r\n```","created_at":"2019-12-19T19:19:13Z","updated_at":"2019-12-19T19:37:31Z","html_url":"https://github.com/DataDog/documentation/pull/6213#discussion_r360036887","pull_request_url":"https://api.github.com/repos/DataDog/documentation/pulls/6213","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/DataDog/documentation/pulls/comments/360036887"},"html":{"href":"https://github.com/DataDog/documentation/pull/6213#discussion_r360036887"},"pull_request":{"href":"https://api.github.com/repos/DataDog/documentation/pulls/6213"}}},"pull_request":{"url":"https://api.github.com/repos/DataDog/documentation/pulls/6213","id":354039951,"node_id":"MDExOlB1bGxSZXF1ZXN0MzU0MDM5OTUx","html_url":"https://github.com/DataDog/documentation/pull/6213","diff_url":"https://github.com/DataDog/documentation/pull/6213.diff","patch_url":"https://github.com/DataDog/documentation/pull/6213.patch","issue_url":"https://api.github.com/repos/DataDog/documentation/issues/6213","number":6213,"state":"open","locked":false,"title":"Custom metrics","user":{"login":"l0k0ms","id":3624790,"node_id":"MDQ6VXNlcjM2MjQ3OTA=","avatar_url":"https://avatars3.githubusercontent.com/u/3624790?v=4","gravatar_id":"","url":"https://api.github.com/users/l0k0ms","html_url":"https://github.com/l0k0ms","followers_url":"https://api.github.com/users/l0k0ms/followers","following_url":"https://api.github.com/users/l0k0ms/following{/other_user}","gists_url":"https://api.github.com/users/l0k0ms/gists{/gist_id}","starred_url":"https://api.github.com/users/l0k0ms/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/l0k0ms/subscriptions","organizations_url":"https://api.github.com/users/l0k0ms/orgs","repos_url":"https://api.github.com/users/l0k0ms/repos","events_url":"https://api.github.com/users/l0k0ms/events{/privacy}","received_events_url":"https://api.github.com/users/l0k0ms/received_events","type":"User","site_admin":false},"body":"This is a follow up on https://github.com/DataDog/documentation/pull/6080\r\n\r\n### What does this PR do?\r\n\r\nThis PRs removes the current Custom metric doc page and split its content between the main metric page and the custom metric billing page.\r\n\r\nIn the developer section, when we talk about metrics it necessarily a custom metric since those are not submitted through an integration so extra changes are also shipped impact on the page are:\r\n\r\n* Renaming the metric sub-section: Custom metrics\r\n* Adding an overview section to better define right away what is a custom metric\r\n\r\nImpact on the custom metric billing page:\r\n\r\n* Adding info on how to count custom metrics depending of the submission metric type\r\n* Adding info on where to track custom metrics.\r\n\r\n### Motivation\r\n\r\nBetter separate the two concepts that are:\r\n\r\n* What are custom metrics (definition, submission, behaviour).\r\n* How custom metrics are billed.\r\n\r\n### Preview link\r\n\r\n* [Custom metric page](https://docs-staging.datadoghq.com/gus/custom-metrics-2/developers/metrics/?tab=countrategauge)\r\n* [Custom metric billing](https://docs-staging.datadoghq.com/gus/custom-metrics-2/account_management/billing/custom_metrics/)","created_at":"2019-12-17T10:52:27Z","updated_at":"2019-12-19T19:37:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"d3db3f35f655e9cd164e008065c2570a282641a0","assignee":null,"assignees":[],"requested_reviewers":[],"requested_teams":[],"labels":[{"id":794806364,"node_id":"MDU6TGFiZWw3OTQ4MDYzNjQ=","url":"https://api.github.com/repos/DataDog/documentation/labels/App","name":"App","color":"d4c5f9","default":false,"description":"Everything related to Datadog that is related to its UI"},{"id":1643446497,"node_id":"MDU6TGFiZWwxNjQzNDQ2NDk3","url":"https://api.github.com/repos/DataDog/documentation/labels/editorial%20review","name":"editorial review","color":"58ef88","default":false,"description":"Waiting on a more in-depth review"}],"milestone":null,"commits_url":"https://api.github.com/repos/DataDog/documentation/pulls/6213/commits","review_comments_url":"https://api.github.com/repos/DataDog/documentation/pulls/6213/comments","review_comment_url":"https://api.github.com/repos/DataDog/documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/DataDog/documentation/issues/6213/comments","statuses_url":"https://api.github.com/repos/DataDog/documentation/statuses/8f84a4a19ec4863d02e65853110abb4b44d9a8bb","head":{"label":"DataDog:gus/custom-metrics-2","ref":"gus/custom-metrics-2","sha":"8f84a4a19ec4863d02e65853110abb4b44d9a8bb","user":{"login":"DataDog","id":365230,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM2NTIzMA==","avatar_url":"https://avatars1.githubusercontent.com/u/365230?v=4","gravatar_id":"","url":"https://api.github.com/users/DataDog","html_url":"https://github.com/DataDog","followers_url":"https://api.github.com/users/DataDog/followers","following_url":"https://api.github.com/users/DataDog/following{/other_user}","gists_url":"https://api.github.com/users/DataDog/gists{/gist_id}","starred_url":"https://api.github.com/users/DataDog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DataDog/subscriptions","organizations_url":"https://api.github.com/users/DataDog/orgs","repos_url":"https://api.github.com/users/DataDog/repos","events_url":"https://api.github.com/users/DataDog/events{/privacy}","received_events_url":"https://api.github.com/users/DataDog/received_events","type":"Organization","site_admin":false},"repo":{"id":2967233,"node_id":"MDEwOlJlcG9zaXRvcnkyOTY3MjMz","name":"documentation","full_name":"DataDog/documentation","private":false,"owner":{"login":"DataDog","id":365230,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM2NTIzMA==","avatar_url":"https://avatars1.githubusercontent.com/u/365230?v=4","gravatar_id":"","url":"https://api.github.com/users/DataDog","html_url":"https://github.com/DataDog","followers_url":"https://api.github.com/users/DataDog/followers","following_url":"https://api.github.com/users/DataDog/following{/other_user}","gists_url":"https://api.github.com/users/DataDog/gists{/gist_id}","starred_url":"https://api.github.com/users/DataDog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DataDog/subscriptions","organizations_url":"https://api.github.com/users/DataDog/orgs","repos_url":"https://api.github.com/users/DataDog/repos","events_url":"https://api.github.com/users/DataDog/events{/privacy}","received_events_url":"https://api.github.com/users/DataDog/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/DataDog/documentation","description":"The source for Datadog's documentation site.","fork":false,"url":"https://api.github.com/repos/DataDog/documentation","forks_url":"https://api.github.com/repos/DataDog/documentation/forks","keys_url":"https://api.github.com/repos/DataDog/documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/DataDog/documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/DataDog/documentation/teams","hooks_url":"https://api.github.com/repos/DataDog/documentation/hooks","issue_events_url":"https://api.github.com/repos/DataDog/documentation/issues/events{/number}","events_url":"https://api.github.com/repos/DataDog/documentation/events","assignees_url":"https://api.github.com/repos/DataDog/documentation/assignees{/user}","branches_url":"https://api.github.com/repos/DataDog/documentation/branches{/branch}","tags_url":"https://api.github.com/repos/DataDog/documentation/tags","blobs_url":"https://api.github.com/repos/DataDog/documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/DataDog/documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/DataDog/documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/DataDog/documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/DataDog/documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/DataDog/documentation/languages","stargazers_url":"https://api.github.com/repos/DataDog/documentation/stargazers","contributors_url":"https://api.github.com/repos/DataDog/documentation/contributors","subscribers_url":"https://api.github.com/repos/DataDog/documentation/subscribers","subscription_url":"https://api.github.com/repos/DataDog/documentation/subscription","commits_url":"https://api.github.com/repos/DataDog/documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/DataDog/documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/DataDog/documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/DataDog/documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/DataDog/documentation/contents/{+path}","compare_url":"https://api.github.com/repos/DataDog/documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/DataDog/documentation/merges","archive_url":"https://api.github.com/repos/DataDog/documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/DataDog/documentation/downloads","issues_url":"https://api.github.com/repos/DataDog/documentation/issues{/number}","pulls_url":"https://api.github.com/repos/DataDog/documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/DataDog/documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/DataDog/documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/DataDog/documentation/labels{/name}","releases_url":"https://api.github.com/repos/DataDog/documentation/releases{/id}","deployments_url":"https://api.github.com/repos/DataDog/documentation/deployments","created_at":"2011-12-12T20:32:29Z","updated_at":"2019-12-19T19:06:06Z","pushed_at":"2019-12-19T19:17:35Z","git_url":"git://github.com/DataDog/documentation.git","ssh_url":"git@github.com:DataDog/documentation.git","clone_url":"https://github.com/DataDog/documentation.git","svn_url":"https://github.com/DataDog/documentation","homepage":"http://docs.datadoghq.com","size":622704,"stargazers_count":97,"watchers_count":97,"language":"Python","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":152,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":30,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":152,"open_issues":30,"watchers":97,"default_branch":"master"}},"base":{"label":"DataDog:master","ref":"master","sha":"4230293de35ad2cc134c26a1ee40ab6f808d4a15","user":{"login":"DataDog","id":365230,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM2NTIzMA==","avatar_url":"https://avatars1.githubusercontent.com/u/365230?v=4","gravatar_id":"","url":"https://api.github.com/users/DataDog","html_url":"https://github.com/DataDog","followers_url":"https://api.github.com/users/DataDog/followers","following_url":"https://api.github.com/users/DataDog/following{/other_user}","gists_url":"https://api.github.com/users/DataDog/gists{/gist_id}","starred_url":"https://api.github.com/users/DataDog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DataDog/subscriptions","organizations_url":"https://api.github.com/users/DataDog/orgs","repos_url":"https://api.github.com/users/DataDog/repos","events_url":"https://api.github.com/users/DataDog/events{/privacy}","received_events_url":"https://api.github.com/users/DataDog/received_events","type":"Organization","site_admin":false},"repo":{"id":2967233,"node_id":"MDEwOlJlcG9zaXRvcnkyOTY3MjMz","name":"documentation","full_name":"DataDog/documentation","private":false,"owner":{"login":"DataDog","id":365230,"node_id":"MDEyOk9yZ2FuaXphdGlvbjM2NTIzMA==","avatar_url":"https://avatars1.githubusercontent.com/u/365230?v=4","gravatar_id":"","url":"https://api.github.com/users/DataDog","html_url":"https://github.com/DataDog","followers_url":"https://api.github.com/users/DataDog/followers","following_url":"https://api.github.com/users/DataDog/following{/other_user}","gists_url":"https://api.github.com/users/DataDog/gists{/gist_id}","starred_url":"https://api.github.com/users/DataDog/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DataDog/subscriptions","organizations_url":"https://api.github.com/users/DataDog/orgs","repos_url":"https://api.github.com/users/DataDog/repos","events_url":"https://api.github.com/users/DataDog/events{/privacy}","received_events_url":"https://api.github.com/users/DataDog/received_events","type":"Organization","site_admin":false},"html_url":"https://github.com/DataDog/documentation","description":"The source for Datadog's documentation site.","fork":false,"url":"https://api.github.com/repos/DataDog/documentation","forks_url":"https://api.github.com/repos/DataDog/documentation/forks","keys_url":"https://api.github.com/repos/DataDog/documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/DataDog/documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/DataDog/documentation/teams","hooks_url":"https://api.github.com/repos/DataDog/documentation/hooks","issue_events_url":"https://api.github.com/repos/DataDog/documentation/issues/events{/number}","events_url":"https://api.github.com/repos/DataDog/documentation/events","assignees_url":"https://api.github.com/repos/DataDog/documentation/assignees{/user}","branches_url":"https://api.github.com/repos/DataDog/documentation/branches{/branch}","tags_url":"https://api.github.com/repos/DataDog/documentation/tags","blobs_url":"https://api.github.com/repos/DataDog/documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/DataDog/documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/DataDog/documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/DataDog/documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/DataDog/documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/DataDog/documentation/languages","stargazers_url":"https://api.github.com/repos/DataDog/documentation/stargazers","contributors_url":"https://api.github.com/repos/DataDog/documentation/contributors","subscribers_url":"https://api.github.com/repos/DataDog/documentation/subscribers","subscription_url":"https://api.github.com/repos/DataDog/documentation/subscription","commits_url":"https://api.github.com/repos/DataDog/documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/DataDog/documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/DataDog/documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/DataDog/documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/DataDog/documentation/contents/{+path}","compare_url":"https://api.github.com/repos/DataDog/documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/DataDog/documentation/merges","archive_url":"https://api.github.com/repos/DataDog/documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/DataDog/documentation/downloads","issues_url":"https://api.github.com/repos/DataDog/documentation/issues{/number}","pulls_url":"https://api.github.com/repos/DataDog/documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/DataDog/documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/DataDog/documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/DataDog/documentation/labels{/name}","releases_url":"https://api.github.com/repos/DataDog/documentation/releases{/id}","deployments_url":"https://api.github.com/repos/DataDog/documentation/deployments","created_at":"2011-12-12T20:32:29Z","updated_at":"2019-12-19T19:06:06Z","pushed_at":"2019-12-19T19:17:35Z","git_url":"git://github.com/DataDog/documentation.git","ssh_url":"git@github.com:DataDog/documentation.git","clone_url":"https://github.com/DataDog/documentation.git","svn_url":"https://github.com/DataDog/documentation","homepage":"http://docs.datadoghq.com","size":622704,"stargazers_count":97,"watchers_count":97,"language":"Python","has_issues":true,"has_projects":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":152,"mirror_url":null,"archived":false,"disabled":false,"open_issues_count":30,"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION","url":null,"node_id":"MDc6TGljZW5zZTA="},"forks":152,"open_issues":30,"watchers":97,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/DataDog/documentation/pulls/6213"},"html":{"href":"https://github.com/DataDog/documentation/pull/6213"},"issue":{"href":"https://api.github.com/repos/DataDog/documentation/issues/6213"},"comments":{"href":"https://api.github.com/repos/DataDog/documentation/issues/6213/comments"},"review_comments":{"href":"https://api.github.com/repos/DataDog/documentation/pulls/6213/comments"},"review_comment":{"href":"https://api.github.com/repos/DataDog/documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/DataDog/documentation/pulls/6213/commits"},"statuses":{"href":"https://api.github.com/repos/DataDog/documentation/statuses/8f84a4a19ec4863d02e65853110abb4b44d9a8bb"}},"author_association":"CONTRIBUTOR"}}
other: {"actor":{"display_login":"cswatt"}}