/SLAB_AppInsights

Main-development-repository-for-Application-Insights-integration-with-Semantic-logging

Primary LanguageC#MIT LicenseMIT

Application Insights for Semantic Logging.

Send data from Semantic Logging to Application Insights for display, analysis and diagnostics.

With semantic logging, you call trace methods named for the event - for example, log.GameWon(score) instead of log.InfoFormat("won a game, score {0}", score). The Semantic Logging Application Block (SLAB) provides a useful framework on which you can create custom log methods and couple them to one or more sinks, leveraging the highly performant Event Tracing for Windows (ETW).

The purpose of this project is to integrate Semantic Logging with Application Insights. Log messages are sent to the Application Insights portal. Application Insights provides a powerful diagnostic search tool, which allows you to search and correlate associated events, including data from client, server and other components of your application. It also shows you charts of trends in performance and usage over time. By using SLAB to send the logs, you introduce an additional level of clarity to your trace code.

Contributors

Special Thanks to Andrew Oakley for all his help with this project.

Tags: App-Insights Application-Insights Semantic-Logging Nuget SLAB Event-Tracing-for-Windows ETW

Requires:

  • Newtonsoft.Json
  • EnterpriseLibrary.SemanticLogging
  • Microsoft.ApplicationInsights

Tested on:

  • Newtonsoft.Json (≥ 7.0.1)
  • EnterpriseLibrary.SemanticLogging (≥ 2.0.1406.1)
  • Microsoft.ApplicationInsights (≥ 0.17.1-beta)

License: GNU GPL 3.0

License URI: http://opensource.org/licenses/GPL-3.0

Copyright 2015 The SL Integration with Application Insights Project Developers.

Description

This packages is intended for users of Semantic Logging that want to seamlessly convert logs captured by SL and send them to Application Insights service on Azure. More information about Application Insights can be found here. The active Semantic Logging repository by Microsoft Microsoft patterns & practices can be found here.

The current version of the nuget package can be found here.

Installation

Using package manager console:

PM> Install-Package SLAB_AI -Pre

Or using Visual Studio:

  • Go to: Tools -> NuGet Package Manager -> Manage NuGet Packages
  • Under Online select nuget.org
  • Select Include Prerelease in the dropdown menu
  • Search for: SLAB_AI
  • Click Install

Contributing

All kinds of contributions are welcomed, from posting issues to fixes and enhacements. Just fork it, make some changes and make a pull request. We won't take long to review your changes and merge it to master branch. Just keep in mind that generating the package and updating it on nuget.org migth take us a few days. Also feel free to add yourself to contributor list in this file when you make a pull request.

Changelog

1.0.0 = Initial Version

1.0.1 = Minor fixes

1.0.2 = Performance improvements

1.0.3 = Bug fixes

1.0.4 = Fix an issue when the payload value is null