Skip to content

Commit b570f06

Browse files
author
ecfan
committed
Clarity edit
1 parent d2e30d6 commit b570f06

File tree

1 file changed

+89
-3
lines changed

1 file changed

+89
-3
lines changed

articles/logic-apps/enable-enhanced-telemetry-standard-workflows.md

Lines changed: 89 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -107,15 +107,99 @@ This guide shows how to turn on enhanced telemetry collection in Application Ins
107107

108108
---
109109

110-
## Set up OpenTelemetry through Visual Studio Code
110+
## Set up OpenTelemetry for performance monitoring
111111

112-
For partially connected and on-premises scenarios, you can configure your Standard logic app project so that the Azure Logic Apps (Standard) runtime emits telemetry in [OpenTelemetry format](https://opentelemetry.io/). However, before you set up OpenTelemetry, consider the following limitations in the current release:
112+
For partially connected and on-premises scenarios, you can configure your Standard logic app to emit telemetry based on the [OpenTelemetry-supported](https://opentelemetry.io/) app settings that you define for the specific environment. However, before you set up OpenTelemetry, consider the following limitations in the current release:
113113

114114
- Only the following triggers currently support OpenTelemetry outputs: HTTP, Service Bus, and Event Hubs
115115

116116
- Metrics export is currently unsupported.
117117

118-
To set up OpenTelemetry capability, follow these steps:
118+
### [Portal](#tab/portal)
119+
120+
To set up OpenTelemetry capability in the Azure portal, follow the steps, based on hosting option for your Standard logic workflow.
121+
122+
##### Workflow Service Plan or App Service Environment V3
123+
124+
Follow these steps to update the **host.json** file in the root directory for your logic app resource:
125+
126+
1. In the [Azure portal](https://portal.azure.com), open your Standard logic app resource.
127+
128+
1. On the resource navigation menu, under **Development Tools**, select **Advanced Tools** > **Go**.
129+
130+
1. In the **Kudu+** console, from the **Debug console** menu, select **CMD**. Go to **site** > **wwwroot**.
131+
132+
1. Edit the **host.json** file. At the root level, add the following **telemetryMode** setting with the **OpenTelemetry** value, and save your changes, for example:
133+
134+
```json
135+
{
136+
"version": "2.0",
137+
"extensionBundle": {
138+
"id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
139+
"version": "[1.*, 2.0.0)"
140+
},
141+
"telemetryMode": "OpenTelemetry"
142+
}
143+
```
144+
145+
1. Save your edits.
146+
147+
1. On the resource navigation menu, under **Settings** > **Environment variables**, select **App settings**.
148+
149+
1. Add the following app settings:
150+
151+
| App setting | Description |
152+
|-------------|-------------|
153+
| **OTEL_EXPORTER_OTLP_ENDPOINT** | The online transaction processing (OTLP) exporter endpoint URL for where to send the telemetry data. |
154+
| **OTEL_EXPORTER_OTLP_HEADERS** (optional) | A list of headers to apply to all outgoing data. Commonly used to pass authentication keys or tokens to your observability backend. |
155+
156+
1. When you're done, select **Apply**.
157+
158+
1. If your OpenTelemetry endpoint requires other OpenTelemetry-related settings, include these settings in the app settings too.
159+
160+
##### Hybrid deployment
161+
162+
Follow these steps to update the **host.json** file in the root directory for an SMB file share in an Azure storage account:
163+
164+
1. In the [Azure portal](https://portal.azure.com), open the Azure storage account with your SMB file share.
165+
166+
1. On the storage account menu, under **Data storage**, select **File shares**, and then select your SMB file share.
167+
168+
1,
169+
open the host.json in the root directory of SMB file share path configured in your logic app
170+
In the host.json file, at the root level, add the following telemetryMode setting with the OpenTelemetry value, for example:
171+
JSONCopy
172+
{
173+
"version": "2.0",
174+
"extensionBundle": {
175+
"id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
176+
"version": "[1.*, 2.0.0)"
177+
},
178+
"telemetryMode": "OpenTelemetry"
179+
}
180+
When you enable OpenTelemetry in the host.json file, your logic app exports telemetry based on the OpenTelemetry-supported app settings that you define in the environment.
181+
Add below app settings from portal by navigating to Containers-->Enviornment variables-->edit and deploy
182+
App setting
183+
184+
Description
185+
186+
187+
| App setting | Description |
188+
|-------------|-------------|
189+
| **OTEL_EXPORTER_OTLP_ENDPOINT** | The online transaction processing (OTLP) exporter endpoint URL for where to send the telemetry data. |
190+
| **OTEL_EXPORTER_OTLP_HEADERS** (optional) | A list of headers to apply to all outgoing data. Commonly used to pass authentication keys or tokens to your observability backend. |
191+
192+
1. If your OpenTelemetry endpoint requires other OpenTelemetry-related settings, include these settings in the app settings too.
193+
194+
For more information, see the following documentation:
195+
196+
- [Edit host and app settings for Standard logic apps](edit-app-settings-host-settings.md)
197+
198+
- [OTLP Exporter Configuration documentation](https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/)
199+
200+
### [Visual Studio Code](#tab/visual-studio-code)
201+
202+
To set up OpenTelemetry capability in Visual Studio Code, follow these steps:
119203

120204
1. In your Standard logic app project, open the **host.json** file at the project root level.
121205

@@ -149,6 +233,8 @@ For more information, see the following documentation:
149233

150234
- [OTLP Exporter Configuration documentation](https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/)
151235

236+
---
237+
152238
<a name="open-application-insights"></a>
153239

154240
## Open Application Insights

0 commit comments

Comments
 (0)