Azure-docs: Clarify parameters('settingName')

[plzm]

parameters('settingName') is used throughout this document. However, no examples are provided of what should be passed here. Is it an arbitrary string? Is it an ARM resource type-specific name for a log setting? Please provide explanation and examples for this as debugging this template as is, is very difficult. Even better would be to provide specific examples - including invocation of template with parameters and example values - for Azure resource types like network security group, load balancer, public IP address, etc. as this is not documented anywhere that I've been able to find, and non-trivial ARM template-based deployments MUST include diagnostic settings rather than relying on after-the-fact Powershell or portal.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: b8f43189-3418-fd30-0528-550157d8366d
• Version Independent ID: 049e3b0e-6f10-6985-c719-05fe43fc00b8
• Content: Automatically enable Diagnostic Settings using a Resource Manager template
• Content Source: articles/monitoring-and-diagnostics/monitoring-enable-diagnostic-logs-using-template.md
• Service: monitoring-and-diagnostics
• GitHub Login: @johnkemnetz
• Microsoft Alias: johnkem

[MohitGargMSFT]

@plzm Thanks for your feedback! We will investigate and update as appropriate.

[johnkemnetz]

Fixing in PR https://github.com/MicrosoftDocs/azure-docs-pr/pull/36324

[johnkemnetz]

@plzm the PR has been merged and should go live tomorrow morning.

[johnkemnetz]

@plzm the update is live, thanks!

[johnkemnetz]

please-close

[BryanTrach-MSFT]

@plzm We will now proceed to close this thread. If there are further questions regarding this matter, please reopen it and we will gladly continue the discussion.

[MichaelSmyth184]

Hi, Could you provide a completed template with params? As the documentation is pretty bad when trying to apply the template. What format is the "eventHubAuthorizationRuleId" meant to be as I am getting issues passing the value "RootManageSharedAccessKey" to it, and also around nesting resources as the example given above only caters to dpeloying a webapp, how do hou enable logging for a NSG or a Load balancer?

It is not clear from the documentation. And as raised above, what should be the settingName? Is it something we decide ourselves?

Many thanks.

[MichaelSmyth184]

BTW the link MicrosoftDocs/azure-docs-pr#36324 does not work!

[kvlopez1]

Link does not work!

[femsulu]

@MichaelSmyth184, @kvlopez1 - the PR link is not meant to "work". :) It's simply used to reference the pull request initiated to fix/update the article. The changes you are looking for should be reflected in the doc link : https://docs.microsoft.com/en-us/azure/monitoring-and-diagnostics/monitoring-enable-diagnostic-logs-using-template