dsolovay/Sitecore-Azure-Diagnostics

Appender that logs Sitecore diagnostic information to Microsoft Azure Blob storage service.

Sitecore Azure Diagnostics

The module outputs Sitecore Log statements to Microsoft Azure Storage service using the Append Blobs.

Features

• Append regular, WebDAV, Search, Crawling and Publishing Sitecore diagnostics
• Based on Azure Blob Storage
• Append Blobs are used to store diagnostics as a text data
• Text data is compatible with Sitecore Log Analyzer tool
• Support multiple Web Apps instances
• Clean up out-of-date blobs using Sitecore Agent
• Support Sitecore Log Viewer application to open, download and deleted blobs.

Requirements

Sitecore XP 8.1 rev. 160519 (8.1 Update-3) or newer

License

This patch is licensed under the MIT License.

Download

Downloads are available via GitHub Releases.

Instructions

The recommended approach to install Sitecore Azure Diagnostics extension is as follows:

1. In Visual Studio, create an empty project using the ASP.NET Web Application (.NET Framework) template.

2. Copy the generated files on top of Sitecore 8.1 installation.

   For example:

   • \sc81u3\Sitecore.sln
   • \sc81u3\Website\Properties
   • \sc81u3\Website\packages.config
   • \sc81u3\Website\Sitecore.csproj
   • \sc81u3\Website\Sitecore.csproj.user
   • \sc81u3\Website\Web.Debug.config
   • \sc81u3\Website\Web.Release.config

3. Include all Sitecore's files in the project.

4. Install the NuGet package Sitecore.Azure.Diagnostics:

   Install-Package Sitecore.Azure.Diagnostics

   Note: The Sitecore.Azure.Diagnostics package depends on the Windows Azure Storage package, which will be installed automatically.

5. Modify both files the Web.Debug.config and Web.Release.config. Under the element \configuration\appSettings, replace the {account-name} with the name of your storage account, and the {account-key} with your account access key:

   <configuration>
   ...
     <appSettings>
     ...
       <add key="StorageConnectionString" value="DefaultEndpointsProtocol=https;AccountName={account-name};AccountKey={account-key}" />
     </appSettings>
   ...
   </configuration>

6. Now Sitecore instance is ready to log diagnostics to an Azure Blob Storage.