Skip to content

Commit a83e9de

Browse files
lucaspimentelclaude
andcommitted
Add prerequisites and cross-references to Azure Functions docs
Add Prerequisites section to help users understand requirements before setup. Enhance .NET configuration section with Azure Functions-specific notes. Add Custom Instrumentation section and improve Troubleshooting with cross-references. Key additions: - Prerequisites section with compatibility links for all runtimes - Azure Functions-specific configuration notes for .NET - Custom Instrumentation section with links to .NET API docs - Enhanced Troubleshooting section with diagnostic tool references - Cross-reference to Azure App Service docs This improves navigation between Azure Functions docs and foundational APM documentation, helping users understand platform-specific differences. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent d2293ca commit a83e9de

File tree

1 file changed

+33
-2
lines changed
  • content/en/serverless/azure_functions

1 file changed

+33
-2
lines changed

content/en/serverless/azure_functions/_index.md

Lines changed: 33 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,21 @@ further_reading:
1212
## Overview
1313
This page explains how to collect traces, trace metrics, runtime metrics, and custom metrics from your Azure Functions. To collect additional metrics, install the [Datadog Azure integration][5].
1414

15+
## Prerequisites
16+
17+
1. **Install the Azure integration:** The [Datadog-Azure integration](/integrations/azure/) provides infrastructure metrics. Install it first for full observability.
18+
2. **Review runtime compatibility:** See compatibility requirements for your language:
19+
- [.NET Core](/tracing/trace_collection/compatibility/dotnet-core) (Isolated Worker model)
20+
- [.NET Framework](/tracing/trace_collection/compatibility/dotnet-framework) (In-Process model)
21+
- [Node.js](/tracing/trace_collection/compatibility/nodejs)
22+
- [Python](/tracing/trace_collection/compatibility/python)
23+
- [Java](/tracing/trace_collection/compatibility/java)
24+
3. **Understand Azure Functions-specific approach:** This guide uses runtime-specific packages and the serverless compatibility layer, which differs from standard APM setup.
25+
26+
<div class="alert alert-info">
27+
Deploying to Azure App Service instead? See <a href="/serverless/azure_app_service/">Azure App Service documentation</a>.
28+
</div>
29+
1530
## Setup
1631

1732
If you haven't already, install the [Datadog-Azure integration][5] to collect metrics and logs. Then instrument your application with the following steps:
@@ -163,8 +178,14 @@ If you haven't already, install the [Datadog-Azure integration][5] to collect me
163178

164179
4. **Configure the Datadog .NET tracer**
165180

166-
- [Configuring the .NET Core Tracing Library][1]
167-
- [Configuring the .NET Framework Tracing Library][2]
181+
The `Datadog.AzureFunctions` package includes the Datadog .NET tracer. For configuration options, see:
182+
- [Configuring the .NET Core Tracing Library](/tracing/trace_collection/library_config/dotnet-core)
183+
- [Configuring the .NET Framework Tracing Library](/tracing/trace_collection/library_config/dotnet-framework)
184+
185+
**Azure Functions considerations:**
186+
- Configuration is set via Function App Settings, not local files
187+
- Some configurations may not be supported in the Functions sandbox environment
188+
- The compatibility layer automatically handles some Agent-related settings
168189

169190
[1]:/tracing/trace_collection/library_config/dotnet-core
170191
[2]:/tracing/trace_collection/library_config/dotnet-framework
@@ -189,13 +210,23 @@ If you haven't already, install the [Datadog-Azure integration][5] to collect me
189210
| `DD_SERVICE` | How you want to tag your service for [Unified Service Tagging][7]. |
190211
| `DD_VERSION` | How you want to tag your version for [Unified Service Tagging][7]. |
191212

213+
## Custom Instrumentation
214+
215+
To add custom spans and metrics:
216+
- [.NET Custom Instrumentation with Datadog API](/tracing/trace_collection/custom_instrumentation/dotnet/dd-api/)
217+
- [Submitting Custom Metrics](/serverless/custom_metrics/)
218+
192219
## What's next?
193220

194221
- You can view your Azure Functions traces in [Trace Explorer][3]. Search for the service name you set in the `DD_SERVICE` environment variable to see your traces.
195222
- You can use the [Serverless > Azure Functions][4] page to see your traces enriched with telemetry collected by the [Datadog Azure integration][5].
196223

197224
## Troubleshooting
198225

226+
For common issues and debugging steps, see:
227+
- [Troubleshoot Serverless Monitoring](/serverless/guide/troubleshoot_serverless_monitoring)
228+
- [.NET Diagnostic Tool](/tracing/troubleshooting/dotnet_diagnostic_tool)
229+
199230
### Enable debug logs
200231

201232
You can collect [debug logs][6] for troubleshooting. To configure debug logs, use the following environment variables:

0 commit comments

Comments
 (0)