Telemetry Enrichment

We provide a variety of enrichers for Serilog:

• Telemetry Enrichment
  • Installation
  • Application Enricher
    • Custom Serilog property names
  • Correlation Enricher
    • Custom Serilog property names
  • Kubernetes Enricher
    • Custom Serilog property names
  • Version Enricher
    • Custom application version
    • Custom Serilog property names

Installation

This feature requires to install our NuGet package

PM > Install-Package Arcus.Observability.Telemetry.Serilog.Enrichers

Application Enricher

The Arcus.Observability.Telemetry.Serilog.Enrichers library provides a Serilog enricher that adds the application's component name to the log event as a log property with the name ComponentName and gives the opportunity to choose the location from where the application 'instance' should be retrieved.

Example Name: ComponentName Value: My application component

Usage

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithComponentName("My application component")    .CreateLogger();
logger.Information("Some event");// Output: Some event {ComponentName: My application component, MachineName: MyComputer}

Or, alternatively one can choose to use the Kubernetes information which our Application Insights sink will prioritize above the MachineName when determining the telemetry Cloud.RoleInstance.

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithComponentName("My application component")    .Enrich.WithKubernetesInfo()    .CreateLogger();
logger.Information("Some event");// Output: Some event {ComponentName: My application component, MachineName: MachineName: MyComputer, PodName: demo-app}

Custom Serilog property names

The application enricher allows you to specify the name of the log property that will be added to the log event during enrichment. By default this is set to ComponentName.

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithComponentName(        componentName: "My application component",         propertyName: "MyComponentName")    .CreateLogger();
logger.Information("Some event");// Output: Some event {MyComponentName: My application component, MachineName: MyComputer}

Correlation Enricher

The Arcus.ObservabilityTelemetry.Serilog.Enrichers library provides a Serilog enricher that adds the CorrelationInfo information from the current context as log properties with the names OperationId and TransactionId.

You can use your own ICorrelationInfoAccessor implementation to retrieve this CorrelationInfo model, or use the default DefaultCorrelationInfoAccessor implementation that stores this model

Example Name: OperationId Value: 52EE2C00-53EE-476E-9DAB-C1234EB4AD0B

Name: TransactionId Value: 0477E377-414D-47CD-8756-BCBE3DBE3ACB

Usage

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithCorrelationInfo()    .CreateLogger();
logger.Information("This event will be enriched with the correlation information");

Or alternatively, with a custom ICorrelationInfoAccessor:

using Arcus.Observability.Correlation;using Serilog;
ICorrelationInfoAccessor myCustomAccessor = ...
ILogger logger = new LoggerConfiguration()    .Enrich.WithCorrelationInfo(myCustomAccessor)    .CreateLogger();
logger.Information("This event will be enriched with the correlation information");// Output: This event will be enriched with the correlation information {OperationId: 52EE2C00-53EE-476E-9DAB-C1234EB4AD0B, TransactionId: 0477E377-414D-47CD-8756-BCBE3DBE3ACB}

Custom Serilog property names

The correlation information enricher allows you to specify the names of the log properties that will be added to the log event during enrichment. This is available on all extension overloads. By default the operation ID is set to OperationId and the transaction ID to TransactionId.

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithCorrelationInfo(        operationIdPropertyName: "MyOperationId",        transactionIdPropertyName: "MyTransactionId")    .CreateLogger();
logger.Information("Some event");// Output: Some event {MyOperationId: 52EE2C00-53EE-476E-9DAB-C1234EB4AD0B, MyTransactionId: 0477E377-414D-47CD-8756-BCBE3DBE3ACB}

Kubernetes Enricher

The Arcus.Observability.Telemetry.Serilog.Enrichers library provides a Kubernetes Serilog enricher that adds several machine information from the environment (variables).

Example

Environment Variable	Log Property
KUBERNETES_NODE_NAME	NodeName
KUBERNETES_POD_NAME	PodName
KUBERNETES_NAMESPACE	Namespace

Usage

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithKubernetesInfo()    .CreateLogger();
logger.Information("Some event");// Output: Some event {NodeName: demo-cluster, PodName: demo-app, Namespace: demo}

Here is an example of a Kubernetes YAML that provides the required environment variables:

apiVersion: apps/v1kind: Deploymentmetadata:  name: demo-app  labels:    app: demospec:  replicas: 2  selector:    matchLabels:      app.kubernetes.io/name: demo-app      app.kubernetes.io/instance: instance  template:    metadata:      labels:        app.kubernetes.io/name: demo-app        app.kubernetes.io/instance: instance    spec:      containers:      - name: event-proxy        image: arcusazure/arcus-event-grid-proxy        env:        - name: ARCUS_EVENTGRID_TOPICENDPOINT          value: https://arcus.io        - name: ARCUS_EVENTGRID_AUTHKEY          valueFrom:            secretKeyRef:             name: secrets-order-consumer             key: servicebus-connectionstring        - name: KUBERNETES_NODE_NAME          valueFrom:            fieldRef:             fieldPath: spec.nodeName        - name: KUBERNETES_POD_NAME          valueFrom:            fieldRef:             fieldPath: metadata.name        - name: KUBERNETES_NAMESPACE          valueFrom:            fieldRef:             fieldPath: metadata.namespace

Custom Serilog property names

The Kubernetes enricher allows you to specify the names of the log properties that will be added to the log event during enrichment. By default the node name is set to NodeName, the pod name to PodName, and the namespace to Namespace.

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithKubernetesInfo(        nodeNamePropertyName: "MyNodeName",        podNamePropertyName: "MyPodName",        namespacePropertyName: "MyNamespace")    .CreateLogger();
logger.Information("Some event");// Output: Some event {MyNodeName: demo-cluster, MyPodName: demo-app, MyNamespace: demo}

Version Enricher

The Arcus.Observability.Telemetry.Serilog.Enrichers library provides a Serilog enricher that adds (by default) the current runtime assembly version of the product to the log event as a log property with the name version.

Example Name: version Value: 1.0.0-preview

Usage

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithVersion()    .CreateLogger();
logger.Information("Some event");// Output: Some event {version: 1.0.0-preview}

Custom application version

The version enricher allows you to specify an IAppVersion instance that retrieves your custom application version, which will be used during enrichment. By default this is set to the version of the current executing assembly.

using Arcus.Observability.Telemetry.Serilog.Enrichers;using Serilog;
IAppVersion appVersion = new MyCustomAppVersion("v0.1.0");ILogger logger = new LoggerConfiguration()    .Enrich.WithVersion(appVersion)    .CreateLogger();
logger.Information("Some event");// Output: Some event {version: v0.1.0}

Custom Serilog property names

The version enricher allows you to specify the name of the property that will be added to the log event during enrichment. By default this is set to version.

using Serilog;
ILogger logger = new LoggerConfiguration()    .Enrich.WithVersion(propertyName: "MyVersion")    .CreateLogger();
logger.Information("Some event");// Output: Some event {MyVersion: 1.0.0-preview}