ExceptionInsights Class

Definition

Namespace

Cuemon

Assemblies

Cuemon.Core.dll

Source

src/Cuemon.Core/ExceptionInsights.cs

Provides a set of static methods for embedding environment specific insights to an exception.

public static class ExceptionInsights

Inheritance

object

ExceptionInsights

Examples

The following example shows how to enrich an exception with thread and environment information using ExceptionInsights.Embed. It catches an exception, embeds runtime parameters and system snapshots, then checks for the embedded insight data in the exception's Data dictionary.

using System;
using System.Reflection;

namespace Cuemon;

public class ExceptionInsightsExample
{
    public void Demonstrate()
    {
        try
        {
            throw new InvalidOperationException("Something went wrong.");
        }
        catch (InvalidOperationException ex)
        {
            // Enrich the exception with thread and environment information
            ExceptionInsights.Embed(ex,
                runtimeParameters: new object[] { "param1", 42 },
                snapshots: SystemSnapshots.CaptureThreadInfo | SystemSnapshots.CaptureEnvironmentInfo);

            // The enriched exception now has embedded insight data in its Data dictionary
            Console.WriteLine(ex.Data.Contains(ExceptionInsights.Key)
                ? "Insights embedded successfully."
                : "No insights available.");
        }
    }
}

Fields

Name	Description
Key	The Key used when applying insights to the Data dictionary.

Methods

Name	Description
Embed<T>(T, object[], SystemSnapshots)	Enriches and embed insights about an Exception.
Embed<T>(T, MethodBase, object[], SystemSnapshots)	Enriches and embed insights about an Exception.