Merge pull request #252726 from AaronMaxwell/aaronmax-custom-measurement-numeric-values-2

Numeric values requirement for custom measurements

Author: prmerger-automator[bot]

articles/azure-monitor/app/data-model-complete.md

@@ -7,7 +7,7 @@ manager: carmonm
 ms.workload: TBD
 ms.tgt_pltfrm: ibiza
 ms.topic: conceptual
-ms.date: 06/23/2023
+ms.date: 09/25/2023
 ms.reviewer: mmcc
 ---
 # Application Insights telemetry data model
@@ -421,6 +421,10 @@ PageView Telemetry includes URL and you could parse the UTM parameter using a re
 
 Occasionally, this data might be missing or inaccurate if the user or enterprise disables sending User Agent in browser settings. The [UA Parser regexes](https://github.com/ua-parser/uap-core/blob/master/regexes.yaml) might not include all device information. Or Application Insights might not have adopted the latest updates.
 
+### Why would a custom measurement succeed without error but the log doesn't show up?
+
+This can occur if you're using string values. Only numeric values work with custom measurements.
+
 ## Next steps
 
 Learn how to use the [Application Insights API for custom events and metrics](./api-custom-events-metrics.md), including:

includes/application-insights-data-model-measurements.md

@@ -1,7 +1,7 @@
 ---
 ms.service: application-insights
 ms.topic: include
-ms.date: 11/09/2018
+ms.date: 09/25/2023
 ---
 **Collection of custom measurements:** Use this collection to report named measurements associated with the telemetry item. Typical use cases are:
 
@@ -18,6 +18,7 @@ customEvents
 ```
 
  > [!NOTE]
- > Custom measurements are associated with the telemetry item they belong to. They're subject to sampling with the telemetry item that contains those measurements. To track a measurement that has a value independent from other telemetry types, use [metric telemetry](../articles/azure-monitor/app/api-custom-events-metrics.md).
+ > - Custom measurements are associated with the telemetry item they belong to. They're subject to sampling with the telemetry item that contains those measurements. To track a measurement that has a value independent from other telemetry types, use [metric telemetry](../articles/azure-monitor/app/api-custom-events-metrics.md).
+ > - Don't use string values for custom measurements. Only numeric values are supported.
 
 **Maximum key length**: 150