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
- Fidel Esteban Morales Cifuentes.
- Luis Roberto Rosales Enriquez.
- Jose Luis Morales Ruiz.
- Jose Carlos Mendez.
- Jorge Andres Rodriguez Cuevas.
- Herberth Francisco Arriola.
- Ohad Schneider.
- MedAnd.
- Miguel Bernard.
- Alan Cameron Wills.
- Oscar Garcia Colon.
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: MIT
License URI: https://opensource.org/licenses/MIT
Copyright (c) 2016 Fidel Esteban Morales Cifuentes
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
Usage
Service Fabric
Andrej Medic did a great write-up on how to use this library with service fabric, if you are interested click here.
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