Logging

Applicable to version 2.4 and above

AppConfig:LoggingConfig:WorkspaceId

Value: Guid

Description:

The WorkspaceID of your Log Analytics Workspace (shown in the Overview of the workspace). This is a required setting if you want to use Azure Monitor, together with SharedKey.

AppConfig:LoggingConfig:SharedKey

Value: String

Description:

Use one of the two keys for the Log Analytics Workspace. They are displayed if you access the Log Analytics Workspace on portal.azure.com and navigate to Settings/Agents, where you can unfold the "Log Analytics agent instructions" section. Use either the Primary or the Secondary key.

This is a required setting if you want to use Azure Monitor, together with WorkspaceId.

SCEPman Certificate Master does not support storing configuration values in Key Vault in the same way that the SCEPman core component does. There is a generic way to store App Service settings in Key Vault, though, which Mika Berglund describes in his blog. In short, you must add Secrets-Get permission to the Certificate Master Managed Identity and, for the SharedKey, you would use @Microsoft.KeyVault(SecretUri=https://YOURKEYVAULTNAMEHERE.vault.azure.net/secrets/appconfig--loggingconfig--sharedkey/) as value for AppConfig:LoggingConfig:SharedKey.

AppConfig:LoggingConfig:AzureOfferingDomain

Value: String

Description:

If the workspace is not in the Global Azure Cloud, you can configure the offering domain here. The default is 'azure.com'.

Changes can harm your service!

AppConfig:LoggingConfig:LogLevel

Value: Trace, Debug, Info, Warn, Error, Fatal

Description:

The minimum log level to be logged. The default is 'Info'. Only log entries with a log level equal or higher than the configured log level will be logged.

Note that if you configure this setting to 'Trace' or 'Debug', log output might contain personal data like UPNs or IP addresses of users. If you want to avoid personal data in the log output, you should configure this setting to 'Info' or higher.

AppConfig:LoggingConfig:AzureEventHubConnectionString

Logging to Azure Event Hub is possible in version 2.7 and above

Value: String

Description:

The connection string to your Azure Event Hub. This is a required setting if you want to use Azure Event Hub.

AppConfig:LoggingConfig:AzureEventHubName

Logging to Azure Event Hub is possible in version 2.7 and above

Value: String

Description:

The name of your Azure Event Hub. This is a required setting if you want to use Azure Event Hub.

AppConfig:LoggingConfig:AzureEventHubPartitionKey

Logging to Azure Event Hub is possible in version 2.7 and above

Value: String

Description:

The partition key of your Azure Event Hub. Setting this is optional. If you don't set this, this defaults to '0'.