DHS.ICE.TechOps.AzureFunction.V8.Common 1.0.3

A set of common utility tools for Azure Function in isolated mode with .Net8

A small program provides a set of utility tools, which makes programming easier for Azure Function with isolated mode.

Blob Storage Logger

This is a logger tool, which extends ILogger and ILoggerProvider and writes log entries into permenant blob storage.
In program.cs, add following codes

builder.Logging.AddProvider(new BlobStorageLoggerProvider());

or

.ConfigureLogging(logging =>
{
    logging.AddProvider(new BlobStorageLoggerProvider());
})

If you do not want to or do not need add "RelevantId" for log entris, you are pretty much done!
In order to trace by "RelevantId", you can adopt one of the two ways below.
For a single log entry, try template method.

logger.LogInformation("Started job abc with {RelevantId}.", new { CaseNumber = caseNumber, RequestGuid = requestGuid });

For a section with multiple log entries, try the using block.

using (logger.BeginScope(new Dictionary<string, object> { ["RelevantId"] = new { CaseNumber = caseNumber, RequestGuid = requestGuid } }));
{
    ...
    logger.LogInformation("Started job abc.");    
    ...
    logger.LogInformation("Finished job abc.");    
}

For more advanced settings and usages, please review the source codes.

Resource Pool for Dyanmics 365 Service Client

This is an auto scaling resource pool for Dynamics 365 "ServiceClient" instances, which can overcome some design imperfectness for MS.
This component will allow you to use short-lived, scoped Dynamics 365 "ServiceClient" instances without worries about the socket depletion issue.
In program.cs, add following codes.

services.AddSingleton<IPooledServiceClientFactory>(new PooledServiceClientFactory(YOUR_CONNECTION_STRING));                

In hosted service for start/stop handler, add following codes.

private readonly IPooledServiceClientFactory _pooledServiceClientFactory;

public HostStartupHandler(IPooledServiceClientFactory pooledServiceClientFactory)
{
    _pooledServiceClientFactory = pooledServiceClientFactory;
}

public Task StartAsync(CancellationToken cancellationToken)
{
    _pooledServiceClientFactory.Initialize();
    return Task.CompletedTask;
}

Use the resource in your codes as following.

ServiceClient client = _pooledServiceClientFactory.Acquire();
try
{
    ...
}
finally
{
    _pooledServiceClientFactory.Release(client);
}

For more advanced settings and usages, please review the source codes.

Blob Storage Factory and Service Bus Factory

MS does not provide an easy way for isolated mode to output multiple blob storage files and / or service bus messages.
Those two tools adopt a factory design pattern, which can minimize the connections to the back services with the same access token and allow you easily output multiple files and / or messages.