CustomTelemetryExporter 1.0.0

.NET Framework 4.8

dotnet add package CustomTelemetryExporter --version 1.0.0

NuGet\Install-Package CustomTelemetryExporter -Version 1.0.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="CustomTelemetryExporter" Version="1.0.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="CustomTelemetryExporter" Version="1.0.0" />
                    

                            Directory.Packages.props

<PackageReference Include="CustomTelemetryExporter" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add CustomTelemetryExporter --version 1.0.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: CustomTelemetryExporter, 1.0.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#addin nuget:?package=CustomTelemetryExporter&version=1.0.0
                    

                            Install CustomTelemetryExporter as a Cake Addin

#tool nuget:?package=CustomTelemetryExporter&version=1.0.0
                    

                            Install CustomTelemetryExporter as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

CustomTelemetryExporter

CustomTelemetryExporter è una libreria .NET che permette di esportare facilmente dati di telemetria (metriche, log ed eccezioni) in formato Loki. Fornisce un modo semplice per monitorare il comportamento e le prestazioni della tua applicazione.

Funzionalità

Esportazione di metriche con etichette personalizzate
Esportazione di log con proprietà
Esportazione di eccezioni con stack trace completo
Formato compatibile con Loki per una facile integrazione
Policy di retry integrata per una consegna affidabile
Opzioni di configurazione flessibili

Installazione

Installa il pacchetto tramite NuGet:

dotnet add package CustomTelemetryExporter

Utilizzo Rapido

Prima, configura l'esportatore:

var config = new EmailConfiguration
{
    EmailTo = "tuo-collector@esempio.com",
    SmtpServer = "smtp.esempio.com",
    SmtpPort = 587,
    SmtpUsername = "username",
    SmtpPassword = "password",
    ApplicationName = "TuaApp"
};

var esportatore = new TelemetryExporter(config);

Esporta eccezioni:

try
{
    // Il tuo codice che potrebbe generare un'eccezione
}
catch (Exception ex)
{
    var datiEccezione = TelemetryExporter.CreateExceptionData(ex);
    esportatore.Export(new Batch<object>(new[] { datiEccezione }));
}

Esporta metriche:

var metrica = new MetricReading
{
    Name = "tempo_elaborazione_ordine",
    Value = 1250.45,
    Unit = "ms",
    Labels = new Dictionary<string, string>
    {
        { "tipo_ordine", "standard" },
        { "tipo_cliente", "premium" }
    }
};

esportatore.Export(new Batch<object>(new[] { metrica }));

Esporta log:

var log = new LogEntry
{
    Level = "Avviso",
    Message = "L'elaborazione dell'ordine ha richiesto più tempo del previsto",
    Properties = new Dictionary<string, string>
    {
        { "id_ordine", "12345" },
        { "tempo_elaborazione", "1250.45ms" }
    }
};

esportatore.Export(new Batch<object>(new[] { log }));

Formato dei Dati

Metriche

{
    "streams": [{
        "stream": {
            "metric_name": "tempo_elaborazione_ordine",
            "unit": "ms",
            "tipo_ordine": "standard",
            "tipo_cliente": "premium"
        },
        "values": [["1703422790671487400", "1250.45"]]
    }]
}

Log

{
    "streams": [{
        "stream": {
            "level": "Avviso",
            "id_ordine": "12345",
            "tempo_elaborazione": "1250.45ms"
        },
        "values": [["1703422790671487400", "L'elaborazione dell'ordine ha richiesto più tempo del previsto"]]
    }]
}

Eccezioni

{
    "streams": [{
        "stream": {
            "level": "error",
            "exception_type": "System.InvalidOperationException",
            "source": "TuaApp"
        },
        "values": [["1703422790671487400", "Eccezione: Operazione fallita\nStackTrace: ..."]]
    }]
}

Opzioni di Configurazione

La classe EmailConfiguration supporta le seguenti opzioni:

EmailTo: Indirizzo email di destinazione
SmtpServer: Indirizzo del server SMTP
SmtpPort: Porta del server SMTP
SmtpUsername: Username per l'autenticazione SMTP
SmtpPassword: Password per l'autenticazione SMTP
ApplicationName: Nome della tua applicazione (usato come sorgente nella telemetria)

Product	Compatible and additional computed target framework versions.
.NET Framework	net48 is compatible. net481 was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 4.8
- App.Metrics.Formatters.Json (>= 4.3.0)
- Microsoft.Bcl.AsyncInterfaces (>= 9.0.0)
- Microsoft.Extensions.Diagnostics.Abstractions (>= 9.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.0)
- Newtonsoft.Json (>= 13.0.3)
- OpenTelemetry (>= 1.11.0-rc.1)
- OpenTelemetry.Exporter.Console (>= 1.7.0)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.7.0)
- OpenTelemetry.Extensions.Hosting (>= 1.7.0)
- Polly (>= 8.5.0)
- System.Memory (>= 4.5.5)
- System.Numerics.Vectors (>= 4.5.0)
- System.Runtime.CompilerServices.Unsafe (>= 6.0.0)
- System.Text.Encodings.Web (>= 9.0.0)
- System.Text.Json (>= 9.0.0)

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
1.0.0	0	3 months ago

Primo rilascio.