.NET client for communicating with the elmah.io REST API


Keywords
Diagnostics, ELMAH, Error, Exception, Logging, Management, Reporting, Tracing, crash-reporting, crash-reporting-tool, elmah-io, error-handling, error-log, error-logging, error-monitoring, error-reporting
License
Apache-2.0
Install
Install-Package Elmah.Io.Client -Version 4.1.32-pre

Documentation

Elmah.Io.Client

Build status NuGet

Raw client for communicating with the elmah.io API.

Usage

To start logging, create a new instance of the ElmahioAPI class:

client = ElmahioAPI.Create(apiKey);

where apiKey is your API key found on your profile page at elmah.io. Make sure to share this instance as a singleton.

Logging

Log messages either through the log method:

client.Messages.Log(logId, new Exception(), Severity.Error, "This is a bug");

or through one of the helpers:

client.Messages.Debug(logId, "A debug message");
client.Messages.Fatal(logId, exception, "This is a fatal bug");

Creating logs

Logs are containers for log messages. To create a new log for a new application, microservice or similar, use the Create method:

client.Logs.Create(new CreateLog("My log"));

Developing

Parts of this client is auto generated using NSwag. NSwag is an Open Source tool that can generate clients for many languages (like C#) from Swagger/OpenAPI 2.0 and 3.0 specs.

To generate a client from the most reason API specs, you first need to install NSwag. We recommend that you use the NPM package which can be installed with this:

npm install nswag -g

With this NSwag CLI tool, you can execute the following command in this folder to generate the newest client.

nswag run