Skip to content
This repository has been archived by the owner on Nov 10, 2017. It is now read-only.

Latest commit

 

History

History
71 lines (48 loc) · 2.79 KB

README.md

File metadata and controls

71 lines (48 loc) · 2.79 KB
Raw

Sitecore Azure Diagnostics

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

NuGet version

Build status

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.