Azure Web App

Traces	Metrics	App Logs	Custom Logs	Profiling
✅	✅	✖	✅	✖

Installation#

1 Install the Package#

dotnet add package MW.APM

2 Add code configuration to Program.cs (add near the top of the file, before var app = builder.Build();):#

var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddEnvironmentVariables()
    .Build();

builder.Services.ConfigureMWInstrumentation(configuration);

builder.Logging.AddConfiguration(configuration.GetSection("Logging"));
builder.Logging.AddConsole();

3 Add Middleware settings to appsettings.json (placeholders only):#

{
  "MW": {
    "ApiKey": "<MW_API_KEY>",
    "TargetURL": "https://<MW_UID>.middleware.io:443",
    "ServiceName": "<service-name>",
    "ProjectName": "<project-name>",
    "ConsoleExporter": "true",
    "ExcludeLinks": "[\"/health\"]",
    "ApmCollectMetrics": "true",
    "ApmCollectTraces": "true",
    "ApmCollectLogs": "true"
  }
}

Troubleshooting#

No data in Traces/Metrics:
- Verify MW.APM is installed and appears in your project’s Dependencies → Packages.
- Confirm MW:ApiKey, MW:TargetURL, and MW:ServiceName are present (either in appsettings.json or as Azure App Settings overrides).
- Make a few real requests to your Web App URL to generate traffic.
App settings not taking effect: ensure Configuration → Application settings in the Azure portal matches your expected overrides and that you Restart the app after changes.
Too much noise from health checks: add /health (or your health endpoints) to MW:ExcludeLinks (JSON array string).
Only metrics but no logs/traces: check MW:ApmCollectTraces / MW:ApmCollectLogs toggles are set to "true" and that your app restarts after editing appsettings.json.

Environment Variables#

Because Program.cs includes AddEnvironmentVariables(), any appsettings.json key can be overridden by Azure Application settings. Use double underscores __ to denote sections.

appsettings.json path	Env var (Azure App Setting)	Required	Purpose
`MW:ApiKey`	`MW__ApiKey`	Yes	Middleware API key (store securely; avoid committing to code).
`MW:TargetURL`	`MW__TargetURL`	Yes	Middleware ingestion endpoint (`https://<MW_UID>.middleware.io:443`).
`MW:ServiceName`	`MW__ServiceName`	Yes	Logical service label shown in Middleware.
`MW:ProjectName`	`MW__ProjectName`	No	Optional grouping for services.
`MW:ApmCollectMetrics`	`MW__ApmCollectMetrics`	No	Toggle metrics (`true/false`).
`MW:ApmCollectTraces`	`MW__ApmCollectTraces`	No	Toggle traces (`true/false`).
`MW:ApmCollectLogs`	`MW__ApmCollectLogs`	No	Toggle logs (`true/false`).
`MW:ConsoleExporter`	`MW__ConsoleExporter`	No	Local debugging aid (`true/false`).
`MW:ExcludeLinks`	`MW__ExcludeLinks`	No	JSON array string of links to exclude (e.g. `["/health"]`).

Need assistance or want to learn more about Middleware? Contact our support team at [email protected] or join our Slack channel.