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:

articles/digital-twins/how-to-use-3d-scenes-studio.md

@@ -22,15 +22,21 @@ Azure Digital Twins [3D Scenes Studio (preview)](https://explorer.digitaltwins.a
 
 ## Prerequisites
 
-To use 3D Scenes Studio, you'll need the following resources:
+To use 3D Scenes Studio, you'll need the following resources.
+
 * An Azure Digital Twins instance. For instructions, see [Set up an instance and authentication](how-to-set-up-instance-cli.md).
     * Obtain *Azure Digital Twins Data Owner* or *Azure Digital Twins Data Reader* access to the instance. For instructions, see [Set up user access permissions](how-to-set-up-instance-cli.md#set-up-user-access-permissions).
     * Take note of the *host name* of your instance to use later.
 * An Azure storage account. For instructions, see [Create a storage account](../storage/common/storage-account-create.md?tabs=azure-portal).
     * Take note of the *URL* of your storage account to use later.
 * A private container in the storage account. For instructions, see [Create a container](../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container).
     * Take note of the *name* of your storage container to use later.
-* *Storage Blob Data Owner* or *Storage Blob Data Contributor* access to your storage resources. You can grant required roles at either the storage account level or the container level. For instructions and more information about permissions to Azure storage, see [Assign an Azure role](../storage/blobs/assign-azure-role-data-access.md?tabs=portal#assign-an-azure-role).
+* Permissions for your storage resources, including:
+    * At least *Reader* control plane access
+    * A data access role of *Storage Blob Data Owner* or *Storage Blob Data Contributor*
+
+    You can grant required roles at either the storage account level or the container level. For instructions and more information about permissions to Azure storage, see [Assign an Azure role](../storage/blobs/assign-azure-role-data-access.md?tabs=portal#assign-an-azure-role). 
+
 * Configure CORS for your storage account (see details in the following sub-section).
 
 ### Configure CORS

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