Merge pull request #252289 from lzchen/events

Add section for custom events for python

Author: prmerger-automator[bot]

articles/azure-monitor/app/opentelemetry-add-modify.md

@@ -324,6 +324,7 @@ The following table represents the currently supported custom telemetry types:
 | **Python**                                |               |                |              |            |            |          |        |
 |    OpenTelemetry API       |               | Yes            | Yes          | Yes        |            | Yes      |        |
 |    Python Logging Module   |               |                |              |            |            |          | Yes    |
+|    Events Extension        |   Yes         |                |              |            |            |          | Yes    |
 
 > [!NOTE]
 > Application Insights Java 3.x listens for telemetry that's sent to the Application Insights [Classic API](api-custom-events-metrics.md). Similarly, Application Insights Node.js 3.x collects events created with the Application Insights [Classic API](api-custom-events-metrics.md). This makes upgrading easier and fills a gap in our custom telemetry support until all custom telemetry types are supported via the OpenTelemetry API.
@@ -1372,7 +1373,31 @@ Then use the `TelemetryClient` to send custom telemetry:
 
 #### [Python](#tab/python)
 
-It isn't available in Python.
+Unlike the other languages, there does not exist an Application Insights SDK for Python. You will be able to achieve all your monitoring needs with the Azure Monitor OpenTelemetry Distro, except for sending `customEvents`. Until the OpenTelemetry Events API is stable, the [Azure Monitor Events Extension](https://pypi.org/project/azure-monitor-events-extension/0.1.0/) can be used in conjunction with the Azure Monitor OpenTelemetry Distro to send `customEvents` to Application Insights.
+
+Install the distro and the extension:
+
+```console
+pip install azure-monitor-opentelemetry
+pip install azure-monitor-events-extension
+```
+
+Use the `track_event` API offered in the extension to send customEvents.
+
+```python
+...
+from azure.monitor.events.extension import track_event
+from azure.monitor.opentelemetry import configure_azure_monitor
+
+configure_azure_monitor()
+
+# Use the track_event() api to send custom event telemetry
+# Takes event name and custom dimensions
+track_event("Test event", {"key1": "value1", "key2": "value2"})
+
+input()
+...
+```
 
 ---