add udf-trace snippet (#58)

This snippet demonstrates how to implement telemetry logging in Power
Apps using User Defined Functions (UDFs) and Azure Application Insights.
It showcases the definition and application of UDFs to efficiently
manage and send telemetry data.

Author: Laskewitz

power-apps/udf-trace/README.md

@@ -0,0 +1,65 @@
+# Send telemetry logs with User Defined Functions to Azure Application Insights
+
+This snippet demonstrates how to implement telemetry logging in Power Apps using User Defined Functions (UDFs) and Azure Application Insights. It showcases the definition and application of UDFs to efficiently manage and send telemetry data.
+
+![preview](./assets/udf-trace.png)
+
+## Problem statement
+
+Telemetry collection is crucial for developing and enhancing apps. In Power Apps, developers use the `Trace()` function to send telemetry logs to Azure Application Insights.
+
+However, using this function independently often results in inconsistencies in trace parameters, message formats, and severity levels. These variations can lead to errors and lack a standardized approach, affecting the reliability and usefulness of the data collected. Additionally, without properly preparing the data for logging, it could also cause redundant nests, making the logs harder to parse and analyze effectively.
+
+## Solution
+
+By implementing a standardized `User Defined Function (UDF)` for telemetry, it's possible to ensure consistent data collection, minimize errors, and improve the analysis and utility of application insights.
+
+## Authors
+
+Author|Socials
+--------|---------
+Katerina Chernevskaya | [GitHub](https://github.com/Katerina-Chernevskaya/) - [LinkedIn](https://www.linkedin.com/in/katerinachernevskaya/)
+
+## Prerequisites
+
+1. Existing Azure Application Insights resource. Learn more how to create Azure Application Insights resource [here](https://learn.microsoft.com/en-us/azure/azure-monitor/app/create-workspace-resource?tabs=portal).
+
+2. Connect your Power Apps Canvas app to Application Insights. You can follow the [official guide](https://learn.microsoft.com/en-us/power-apps/maker/canvas-apps/application-insights#connect-your-app-to-application-insights) or use the steps below:
+   - Go to your Application Insights resource in Azure. On the **Overview** page, locate and copy the **Connection String**:
+   ![Connection String - Copy](./assets/key.png)
+   - In Power Apps Studio, select the **App** level, then navigate to the **Connection string** property on the right-hand pane and paste the copied value:
+   ![Connection String - Paste](./assets/key-paste.png)
+
+3. Make sure that experimental features are enabled: 
+   - User-defined functions
+   - User-defined types
+   ![experimental-features](./assets/experimental-features.png)
+
+4. Power Apps Canvas app with the following controls (name the controls the same as in the list below). You can use the [sample screen snippet](./source/screen.pa.yaml) to quickly add a preconfigured screen with all necessary controls.
+   - DatePicker
+   - Slider
+   - Gallery
+   - RadioGroup
+   - Dropdown
+   - Toggle
+   - Rating
+   - Combobox
+   - Checkbox
+   - Button
+
+## Minimal path to awesome
+
+1. Open your Power App in edit mode
+2. Copy the contents of the **[udf.fx](./source/udf.fx)**
+3. Add the copied code into `Formula` property on the `App` level
+4. *(Optional: if you didn't create the screen with the [sample screen snippet](./source/screen.pa.yaml))* Copy the contents of the **[onselect.fx](./source/onselect.fx)** and insert the copied code into the `OnSelect` property of the Button
+5. Make sure the screen with controls is easily accessible - either move it to a higher position in the screen list or add a navigation control to reach it. Save the app and publish it
+6. Play the app, test the button to send telemetry to Azure Application Insights
+7. Navigate to the Azure Application Insights resource. Open the `Logs` under `Monitoring`. Select `trace` table. You will see the collected telemetry under the `customDimensions`
+![Azure Application Insights](./assets/aap.png)
+
+## Disclaimer
+
+**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
+
+<img src="https://m365-visitor-stats.azurewebsites.net/powerplatform-snippets/power-apps/udf-trace" aria-hidden="true" />

power-apps/udf-trace/assets/aap.png

@@ -0,0 +1,50 @@
+[
+  {
+    "$schema": "https://developer.microsoft.com/en-us/json-schemas/pnp/samples/v1.0/metadata-schema.json",
+    "name": "pnp-powerplatform-snippets-udf-trace",
+    "version": "1.0.0.0",
+    "source": "pnp",
+    "creationDateTime": "2025-04-02T00:00:00.000Z",
+    "updateDateTime": "2025-04-02T00:00:00.000Z",
+    "title": "Send telemetry logs with User Defined Functions to Azure Application Insights",
+    "shortDescription": "This snippet demonstrates how to implement telemetry logging in Power Apps using User Defined Functions (UDFs) and Azure Application Insights. It showcases the definition and application of UDFs to efficiently manage and send telemetry data.",
+    "longDescription": [
+      "This sample demonstrates a structured approach to telemetry logging in Power Apps using the Trace() function with Azure Application Insights. It addresses common issues that arise when Trace() is used inconsistently - such as mismatched parameters, varying message formats, and unstandardized severity levels. These inconsistencies can lead to unreliable telemetry data and complicate analysis. The sample also highlights the importance of preparing data properly before logging to avoid redundant nesting, which can make logs more difficult to parse and interpret."
+    ],
+    "url": "https://github.com/pnp/powerplatform-snippets/tree/main/power-apps/udf-trace/",
+    "products": [
+      "Power Platform",
+      "Power Apps",
+      "powerplatform-snippets",
+      "power-apps-snippets",
+      "formula-snippets"
+    ],
+    "tags": [ ],
+    "categories": [ ],
+    "metadata": [
+      {
+        "key": "Product",
+        "value": "Power Apps"
+      },
+      {
+        "key": "Type",
+        "value": "Formula"
+      }
+    ],
+    "thumbnails": [
+      {
+        "type": "image",
+        "order": 100,
+        "url": "https://raw.githubusercontent.com/Katerina-Chernevskaya/powerplatform-snippets/dc573cf7bc535f6072dcaa5abf2d91ebb270f53d/power-apps/udf-trace/assets/udf-trace.png",
+        "alt": "Preview PNG"
+      }
+    ],
+    "authors": [
+      {
+        "gitHubAccount": "Katerina-Chernevskaya",
+        "name": "Katerina Chernevskaya",
+        "pictureUrl": "https://github.com/Katerina-Chernevskaya.png"
+      }
+    ]
+  }
+]

power-apps/udf-trace/assets/experimental-features.png

@@ -0,0 +1,17 @@
+udfTrace(
+    DatePicker.SelectedDate,
+    Slider.Value,
+    ShowColumns(
+        Filter(
+            Gallery.AllItems,
+            status = "Yes" // Replace status with your gallery property name
+        ),
+        title // Replace title with your gallery property name
+    ),
+    RadioGroup.SelectedItems,
+    Dropdown.SelectedItems,
+    Toggle.Checked,
+    Rating.Value,
+    Combobox.SelectedItems,
+    Checkbox.Checked  
+)