Skip to content

lbarahona30/Exceptionless

 
 

Repository files navigation

Exceptionless

Build status ![Gitter](https://badges.gitter.im/Join Chat.svg)

The definition of the word exceptionless is: to be without exception. Exceptionless provides real-time error reporting for your ASP.NET, Web API, WebForms, WPF, Console, and MVC apps. It organizes the gathered information into simple actionable data that will help your app become exceptionless!

Getting Started (Development)

NOTE: If you simply want to use Exceptionless, just go to http://exceptionless.io and signup for a free account and you will be up and running in seconds.

  1. You will need to have Visual Studio 2013 installed.
  2. Start Elasticsearch, and MongoDB by running StartBackendServers.bat.
  3. Open the Exceptionless.sln Visual Studio solution file.
  4. Select Exceptionless.Api as startup projects.
  5. Run the project by pressing F5 to start the server.
  6. (OPTIONAL) For a user interface you must also setup and configure the Exceptionless.UI project.

Alternatively, you can watch this short YouTube video showing how to get started with the project.

Using Exceptionless

Refer to the Exceptionless documentation here: Exceptionless Docs

Hosting Options

  1. We provide very reasonably priced hosting at Exceptionless. By using our hosted service, you are supporting the project and helping it get better! We also provide set up and support services.
  2. If you would rather host Exceptionless yourself, you will need to follow these steps:
  3. Setup Elasticsearch (Linux, Windows) with our elasticsearch.yml config, Mongo (Linux, Windows) and Redis servers (Linux, Windows). We highly recommend that you run these on Linux systems because the Windows versions aren't as performant and reliable as the Linux versions. We also highly recommend that you setup Mongo in a replica set configuration.
  4. Enable Web Sockets.
  5. Setup IIS and add the Exceptionless API website (Download).
  6. Update the connection strings in the Web.config file to point to your Elasticsearch, MongoDB and Redis servers.
  7. Update the app settings (BaseURL, EnableSSL, WebsiteMode, etc..) in the Web.config file.
  8. Update the mail settings in the Web.config file.
  9. Configure your clients to send errors to your installation.

How is Exceptionless licensed?

The Exceptionless server is licensed under GNU AGPL v3.0. The client libraries are licensed under Apache License v2.0.

We want Exceptionless to be free for those of you who want to host the application and data internally or just simply do not want to pay for a hosted account. Our hope is that by making the application free and open source that more people will be aware of it and use it which will indirectly result in more people using our hosted service.

The server is licensed under the AGPL license to ensure that any modifications that are made will be contributed back to the community.

We chose to release the client libraries under Apache License v2.0 to remove any ambiguity as to the extent of the server license — you do not have to license any software that uses Exceptionless under AGPL and are completely free to use any licensing mechanism of your choice.

Contributing

Please read the contributing document.

In appreciation for anyone who submits a non-trivial pull request, we will give you a free Exceptionless paid plan for a year. After your pull request is accepted, simply send an email to team@exceptionless.io with the name of your organization and we will upgrade you to a paid plan.

Roadmap

We are currently in the planning process for 2.1. However, this is a list of high level things that we are planning to do:

##Thanks Thanks to the community for your support!

Thanks to JetBrains for a community WebStorm and ReSharper license to use on this project. It's the best JavaScript IDE/Visual Studio productivity enhancement hands down.

Thanks to Red Gate for providing an open source license for a .NET Developer Bundle. It's an indepensible tool when you need to track down a performance/memory issue.

Packages

No packages published

Languages

  • C# 98.6%
  • Other 1.4%