InnerDrive.Logging 5.2.1247.1

Inner Drive Extensible Architeture

The Inner Drive Extensible Architecture implements common .NET development situations including time zones, money, measurements and conversions, and Microsoft Azure features.

InnerDrive.Logging

Features

• Microsoft Azure-based event and audit logging capabiliites
• Abstraction layers for sending email through Postmark and SendGrid
• NLog targets for SendGrid, Postmark, and Azure tables

Prerequisites

This package runs on .NET 8. It depends on these packages:

• InnerDrive.Azure
• InnerDrive.Core

To use the Azure logging tools, you will need an Azure subscription and connection string to an Azure tables instance. To use Postmark email tools, you will need a Postmark subscription. To use SendGrid, you'll need a Twilio SendGrid subscription, which you can sign up for through the Azure portal.

Usage

To use the ActionLog

Configure the actionLog and Azure Key Vault settings:

{
	"actionLog": {
		"baseTableName": "myAppLog"
	},
	"keyVaultSecretProviderThrowExceptions": true,
	"keyVaultTenantId": "{key vault tenant ID}",
	"keyVaultUrl": "{key vault URL}"
}

The Key Vault Secrets collection should contain the following:

• storageAccountKey
• storageAccountName
• storageTablesUri
• storageConnectionString

Once set up, adding an event is straightforward:

var repository = new AzureLogRepository(_accountName, _accountKey, _tablesUri)
{
	ApplicationName = ApplicationName,
	BaseTableName = BaseTableName,
	Source = "AzureLogRepository.Write example"
};
var eventInfo = new LogEventInfo(LogLevel.Info, GetType().Name, messageBody)
{
	Properties =
	{
		["Computer name"] = Environment.MachineName,
		["OS Version"] = Environment.OSVersion.ToString()
	}
};
var logEntry = AzureLogEntry.Map(eventInfo, ApplicationName);

var result = await repository.WriteAsync(logEntry, CancellationToken.None);
Trace.WriteLine($"Async write result: {result.Status}");

Reading log entries is also easy:

var now = DateTimeOffset.Now;
var range = new DateRange(now.AddHours(-24), now);
var result = await repository.FindAsync(range);
foreach(var item in result)
{
	Trace.WriteLine(item);
}

NLog targets

NLog.config settings:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      autoReload="true"
      internalLogLevel="Info"
      internalLogFile="c:\temp\internal-nlog.txt"
      throwExceptions="true"
      throwConfigExceptions="true">

	<extensions>
		<add assembly="InnerDrive.Logging"/>
	</extensions>
	
	<targets async="false">
		<target name="logconsole" xsi:type="Console" />
		<target name="logfile" xsi:type="File" fileName="c:\Temp\nlog-all-${shortdate}.txt"
		        layout="${longdate}|${event-properties:item=EventId_Id}|${uppercase:${level}}|${logger}|${message} ${exception:format=tostring}"/>
		<target xsi:type="AzureTableTarget"
			name="azureTable"
			applicationName="Logging.Test"
			baseTableName="InnerDriveLogTest"
		/>
		<target xsi:type="PostmarkTarget"
			name="postmark"
			applicationName="Logging.Test via Postmark"
			from="noreply@inner-drive.com"
			subject="NLog Postmark target"
			to="nerdly@contoso.org"
		/>
		<target xsi:type="SendGridTarget"
			name="sendgrid"
			applicationName="Logging.Test via SendGrid"
			from="noreply@inner-drive.com"
			subject="NLog SendGrid target"
			to="nerdly@contoso.org"
		/>
	</targets>
	
	<rules>
		<logger name="*" minlevel="Fatal" writeto="postmark,sendgrid" />
		<logger name="*" minlevel="Warn" writeTo="azureTable" />
		<logger name="*" minlevel="Info" writeTo="logfile" />
		<logger name="*" minlevel="Debug" writeTo="logconsole" />
	</rules>
</nlog>

The Inner Drive Technology website has a full SDK and example code. We also have a demo weather site that uses all the IDEA components.

Feedback

Comments or questions? Send feedback