Motadata.CustomInstrumentationTest 1.0.0

Motadata Custom Instrumentation

Custom instrumentation utility for OpenTelemetry spans in .NET applications. Provides easy-to-use APIs for setting custom attributes on spans with automatic validation and type conversion.

🚀 Features

• ✅ Easy-to-use API - Simple static methods for setting span attributes
• ✅ Automatic key prefixing - All keys automatically prefixed with apm.
• ✅ Type safety - Support for bool, int, long, float, double, string, and arrays
• ✅ Validation - Built-in validation for keys and values with descriptive error messages
• ✅ Cross-platform - Works on Windows, Linux, and macOS
• ✅ Multi-framework support - .NET Framework 4.6.2+, .NET Standard 2.0, .NET 8, .NET 9

📦 Installation

NuGet Package Manager

dotnet add package Motadata.CustomInstrumentationTest

Package Manager Console

Install-Package Motadata.CustomInstrumentationTest

🔧 Usage

Basic Examples

using Motadata.Apm;

// Set scalar attributes
CustomInstrumentation.Set("user.id", 12345);
CustomInstrumentation.Set("user.name", "John Doe");
CustomInstrumentation.Set("is.premium", true);
CustomInstrumentation.Set("response.time", 123.45);
CustomInstrumentation.Set("temperature", 98.6f);
CustomInstrumentation.Set("count", 42L);

// Set array attributes
CustomInstrumentation.SetStringList("tags", new[] { "api", "v2", "production" });
CustomInstrumentation.SetLongList("user.ids", new[] { 1L, 2L, 3L });
CustomInstrumentation.SetIntegerList("scores", new[] { 100, 95, 87 });
CustomInstrumentation.SetDoubleList("metrics", new[] { 1.1, 2.2, 3.3 });
CustomInstrumentation.SetFloatList("temperatures", new[] { 98.6f, 99.1f, 97.8f });
CustomInstrumentation.SetBooleanList("flags", new[] { true, false, true });

Automatic Key Prefixing

All attribute keys are automatically prefixed with apm.:

CustomInstrumentation.Set("user.id", 12345);
// Actual key set on span: "apm.user.id"

CustomInstrumentation.Set("apm.user.name", "John");
// Key already has prefix, so it remains: "apm.user.name"

Error Handling

try
{
    CustomInstrumentation.Set("user.id", 12345);
}
catch (InvalidAttributeKeyException ex)
{
    // Invalid key format
    Console.WriteLine($"Invalid key: {ex.Message}");
}
catch (InvalidAttributeValueException ex)
{
    // Invalid value (null, NaN, Infinity, etc.)
    Console.WriteLine($"Invalid value: {ex.Message}");
}
catch (SpanAttributeException ex)
{
    // No active span or span error
    Console.WriteLine($"Span error: {ex.Message}");
}

📋 Supported Types

Scalar Types

• bool - Boolean values
• int - Integer values (converted to long)
• long - Long integer values
• float - Float values (converted to double)
• double - Double precision values
• string - String values (cannot be null)

Array Types

• bool[] - Boolean arrays
• int[] - Integer arrays (converted to long[])
• long[] - Long integer arrays
• float[] - Float arrays (converted to double[])
• double[] - Double precision arrays
• string[] - String arrays (null values filtered out)

⚙️ Validation Rules

Key Validation

• ✅ Cannot be null or empty
• ✅ Only alphanumeric characters and dots allowed
• ✅ Automatically converted to lowercase
• ✅ Automatically prefixed with apm.

Value Validation

• ✅ String values cannot be null
• ✅ Double/Float values cannot be NaN or Infinity
• ✅ Arrays cannot be null or empty
• ✅ Null values in arrays are automatically filtered out
• ✅ Invalid values (NaN, Infinity) in arrays are filtered out

🌍 Platform Support

📖 API Reference

Scalar Methods

• Set(string key, bool value)
• Set(string key, int value)
• Set(string key, long value)
• Set(string key, float value)
• Set(string key, double value)
• Set(string key, string value)

Array Methods

• SetBooleanList(string key, bool[] value)
• SetIntegerList(string key, int[] value)
• SetLongList(string key, long[] value)
• SetFloatList(string key, float[] value)
• SetDoubleList(string key, double[] value)
• SetStringList(string key, string[] value)

🔒 License

Proprietary - Copyright (c) Motadata 2026. All rights reserved.

📞 Support

For issues, questions, or support:

• Email: engg@motadata.com
• Website: https://www.motadata.com

📝 Notes

This is a TEST VERSION for evaluation purposes. For production use, please contact Motadata.