Access logs and diagnostics data in Sitecore XP on Azure Web Apps

There are several options to collect Sitecore XP logs from Azure Application Insights (AI):

• Using Azure Application Insights REST API

  To utilize this approach, use the latest version of the AzureTools.aspx page with the following two Azure AI parameters:

  • Application ID
  • API key

  To retrieve these parameters:

  1. Locate the following tab in the related resource group: Azure Portal -> Resource Group -> Application Insights -> Configure section -> API Access.
  2. Retrieve the Application ID from this tab.
  3. On the same tab, create an API key (Read telemetry) and save its value. Note: When the key creation dialog is closed, you cannot access the key value.

  To collect logs using this page:

  1. Open the page using one of the following approaches:
     • Sitecore XP (website/sitecore/admin/AzureTools.aspx)
     • http://localhost/AzureTools.aspx (C:\inetpub\wwwroot\AzureTools.aspx, only with IIS configured to use ASP.NET)
  2. Select the Logs tab and enter Application ID and API key values.
  3. Click Find existing roles to look for roles (CM, CD, and so on) in the environment.
  4. Select the roles you need and logs recency.
  5. Optionally, you can select the Extended checkbox to see more options.
  6. Click Download logs to download related logs, which are compatible with the Sitecore Log Analyzer.

  For logs analysis, you can use Azure AI parameters to download the required logs, or you can provide these parameters to Sitecore Support.

  If access to Azure AI logs is no longer needed, the API key can be deleted (Azure Portal -> Right-click on the API key -> Delete).

• Using Application Insights Analytics Portal

  To access enhanced logging data of a Sitecore XP instance deployed to Azure Web Apps, we recommend you browse preconfigured Application Insights records using the Application Insights Analytics page:

  1. Go to the Azure Portal (https://portal.azure.com).
  2. Open related resource group and select Application Insights.
  3. In the Overview section, click the Analytics button at the top of the page.
  4. On the opened page, paste and run the needed query to retrieve logs. In this following example, logs for last 14 days from a Single Sitecore XP role are retrieved.

     traces
     | where tostring(customDimensions.Role) == "Single"
     | where timestamp > now(-14d)
     | project timestamp, message
     | sort by timestamp desc

  5. The following roles can be used for the above query: Single, CM, CD, Processing, Reporting, DDS.
  6. To see all available fields for logs filtering (like customDimensions.InstanceName or severityLevel), the following simple query can be executed:

     traces

  After the logs are retrieved, they can be exported to a CSV file.

  For more details about writing custom queries, consider reading the azure log analytics articles.