331c3182fd | ||
---|---|---|
HelloWorldTest | ||
SDL | ||
src | ||
test | ||
.gitattributes | ||
.gitignore | ||
35MSSharedLib1024.snk | ||
AddXmlLanguage.targets | ||
ApplicationInsightsSDKRules.ruleset | ||
CHANGELOG.md | ||
CodeCov.ps1 | ||
Common.props | ||
Common.targets | ||
Directory.Build.props | ||
EnlistmentRoot.marker | ||
GenerateReleaseMetadata.ps1 | ||
GlobalStaticVersion.props | ||
LICENSE | ||
Logging.sln | ||
Microsoft-Security-Recommended.ruleset | ||
NuGet.Config | ||
NuGet.exe | ||
NugetAudit.ps1 | ||
PushNugetPackages.cmd | ||
README.md | ||
Signing.targets | ||
Test.props | ||
ThirdPartyNotices.txt | ||
VSOPushNugetPackages.cmd | ||
buildDebug.cmd | ||
buildRelease.cmd | ||
clean.cmd | ||
dirs.proj | ||
disablestrongnamevalidation.ps1 | ||
enablestrongnamevalidation.ps1 |
README.md
Nuget packages
- For NLog: Microsoft.ApplicationInsights.NLogTarget
- For Log4Net: Microsoft.ApplicationInsights.Log4NetAppender
- For System.Diagnostics: Microsoft.ApplicationInsights.TraceListener
- Microsoft.ApplicationInsights.DiagnosticSourceListener
- Microsoft.ApplicationInsights.EtwCollector
- Microsoft.ApplicationInsights.EventSourceListener
Application Insights logging adapters.
If you use NLog, log4Net or System.Diagnostics.Trace for diagnostic tracing in your application, you can have your logs sent to Application Insights, where you can explore and search them. Your logs will be merged with the other telemetry coming from your application, so that you can identify the traces associated with servicing each user request, and correlate them with other events and exception reports.
Read more:
- Microsoft Docs: "Explore .NET trace logs in Application Insights"
- Microsoft Docs: "Diagnose sudden changes in your app telemetry"
NLog
Application Insights NLog Target nuget package adds ApplicationInsights target in your web.config (If you use application type that does not have web.config you can install the package but you need to configure ApplicationInsights programmatically; see below).
For more information, see NLog Documentation
- If you configure NLog though web config then you just need do the following:
// You need this only if you did not define InstrumentationKey in ApplicationInsights.config
TelemetryConfiguration.Active.InstrumentationKey = "Your_Resource_Key";
Logger logger = LogManager.GetLogger("Example");
logger.Trace("trace log message");
- If you configure NLog programmatically than create Application Insights target in code and add it to your other targets:
var config = new LoggingConfiguration();
ApplicationInsightsTarget target = new ApplicationInsightsTarget();
// You need this only if you did not define InstrumentationKey in ApplicationInsights.config or want to use different instrumentation key
target.InstrumentationKey = "Your_Resource_Key";
LoggingRule rule = new LoggingRule("*", LogLevel.Trace, target);
config.LoggingRules.Add(rule);
LogManager.Configuration = config;
Logger logger = LogManager.GetLogger("Example");
logger.Trace("trace log message");
Log4Net
Application Insights Log4Net adapter nuget modifies web.config and adds Application Insights Appender.
For more information, see Log4Net Configuration
// You do not need this if you have instrumentation key in the ApplicationInsights.config
TelemetryConfiguration.Active.InstrumentationKey = "Your_Resource_Key";
log4net.Config.XmlConfigurator.Configure();
var logger = LogManager.GetLogger(this.GetType());
logger.Info("Message");
logger.Warn("A warning message");
logger.Error("An error message");
System.Diagnostics
Microsoft.ApplicationInsights.TraceListener nuget package modifies web.config and adds application insights listener.
For more information, see "Microsoft Docs: "Tracing and Instrumenting Applications"
<configuration>
<system.diagnostics>
<trace>
<listeners>
<add name="myAppInsightsListener" type="Microsoft.ApplicationInsights.TraceListener.ApplicationInsightsTraceListener, Microsoft.ApplicationInsights.TraceListener" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
If your application type does not have web.config, add listener programmatically or in the configuration file appropriate to your application type
// You do not need this if you have instrumentation key in the ApplicationInsights.config
TelemetryConfiguration.Active.InstrumentationKey = "Your_Resource_Key";
System.Diagnostics.Trace.TraceWarning("Slow response - database01");
EventSource
EventSourceTelemetryModule
allows you to configure EventSource events to be sent to Application Insights as traces.
For more information, see Microsoft Docs: "Using EventSource Events".
ETW
EtwCollectorTelemetryModule
allows you to configure events from ETW providers to be sent to Application Insights as traces.
For more information, see Microsoft Docs: "Using ETW Events".
DiagnosticSource
You can configure System.Diagnostics.DiagnosticSource
events to be sent to Application Insights as traces.
For more information, see CoreFX: "Diagnostic Source Users Guide".
To enable, edit the TelemetryModules
section of the ApplicationInsights.config file:
<Add Type="Microsoft.ApplicationInsights.DiagnsoticSourceListener.DiagnosticSourceTelemetryModule, Microsoft.ApplicationInsights.DiagnosticSourceListener">
<Sources>
<Add Name="MyDiagnosticSourceName" />
</Sources>
</Add>