https://github.com/ealsur/loganalytics-extensions-logging

Azure Log Analytics Logger extension for ASP.NET Core
https://github.com/ealsur/loganalytics-extensions-logging

asp-net-core azure-log-analytics extension logger

Last synced: 3 months ago
JSON representation

Azure Log Analytics Logger extension for ASP.NET Core

• Host: GitHub
• URL: https://github.com/ealsur/loganalytics-extensions-logging
• Owner: ealsur
• License: apache-2.0
• Created: 2016-10-21T13:02:04.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2018-10-03T17:24:41.000Z (over 6 years ago)
• Last Synced: 2024-09-22T09:18:18.481Z (5 months ago)
• Topics: asp-net-core, azure-log-analytics, extension, logger
• Language: C#
• Size: 24.4 KB
• Stars: 7
• Watchers: 5
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Azure Log Analytics ASP.NET Core Logging extension

This package extends the logging options for ASP.NET Core adding the possibility of sending logs directly to [Azure Log Analytics](https://azure.microsoft.com/services/log-analytics/) as JSON payloads.

It uses the [HTTPDataCollectorAPI](https://github.com/ealsur/HTTPDataCollectorAPI) package internally.

## Get it

You can obtain this project as a [Nuget Package](https://www.nuget.org/packages/LogAnalytics.Extensions.Logging). 

    Install-Package LogAnalytics.Extensions.Logging

Or reference it and use it according to the [License](./LICENSE).

## Use it

Using it is simple, just reference the package and add it to the Logging pipeling in your `Startup.cs` file:

```cs

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)

{

			//Add Logger

			loggerFactory.AddLogAnalytics("{Your_Workspace_Id}", "{Your_Key_Id}", "{Your_Namespace}", LogLevel.Critical);

			app.UseMvcWithDefaultRoute();			

}

```

Your **WorkspaceId** and **API Key** are part of your Azure Log Analytics subscription.

The **Namespace** is the name that _identifies your LogType_ in Azure Log Analytics, mostly used to identify your application or source.

## Does it support Azure Gov clouds?

Yes, just add the extra parameter to the registration:

```cs

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)

{

			//Add Logger

			loggerFactory.AddLogAnalytics("{Your_Workspace_Id}", "{Your_Key_Id}", "{Your_Namespace}", LogLevel.Critical, "ods.opinsights.azure.us");

			app.UseMvcWithDefaultRoute();			

}

```

## Issues

Please feel free to [report any issues](https://github.com/ealsur/loganalytics-extensions-logging/issues) you might encounter. Keep in mind that this library won't assure that your JSON payloads are being indexed, it will make sure that the HTTP Data Collection API [responds an Accept](https://azure.microsoft.com/en-us/documentation/articles/log-analytics-data-collector-api/#return-codes) but there is no way (right now) to know when has the payload been indexed completely.