Mindscape.Raygun4Net.Azure.WebJob
11.1.1
See the version list below for details.
dotnet add package Mindscape.Raygun4Net.Azure.WebJob --version 11.1.1
NuGet\Install-Package Mindscape.Raygun4Net.Azure.WebJob -Version 11.1.1
<PackageReference Include="Mindscape.Raygun4Net.Azure.WebJob" Version="11.1.1" />
paket add Mindscape.Raygun4Net.Azure.WebJob --version 11.1.1
#r "nuget: Mindscape.Raygun4Net.Azure.WebJob, 11.1.1"
// Install Mindscape.Raygun4Net.Azure.WebJob as a Cake Addin #addin nuget:?package=Mindscape.Raygun4Net.Azure.WebJob&version=11.1.1 // Install Mindscape.Raygun4Net.Azure.WebJob as a Cake Tool #tool nuget:?package=Mindscape.Raygun4Net.Azure.WebJob&version=11.1.1
Raygun4Net.Azure.WebJob - Raygun Provider for Azure WebJob SDK enabled projects
Where is my app API key?
When you create a new application in your Raygun dashboard, your app API key is displayed at the top of the instructions page. You can also find the API key by clicking the "Application Settings" button in the side bar of the Raygun dashboard.
Usage
Add a section to configSections:
<section name="RaygunSettings" type="Mindscape.Raygun4Net.RaygunSettings, Mindscape.Raygun4Net"/>
Add the Raygun settings configuration block from above:
<RaygunSettings apikey="YOUR_APP_API_KEY" />
Now you can setup Raygun to send unhandled exceptions automatically.
To send unhandled exceptions automatically, add a config.UseRaygun() call to your JobHostConfiguration setup (where config is your instance of JobHostConfiguration)
You may optionally also pass in an already constructed RaygunClient instance if you wish to do any further customization of Raygun4Net.
Remove sensitive request data
If you have sensitive data in an HTTP request that you wish to prevent being transmitted to Raygun, you can provide lists of possible keys (names) to remove. Keys to ignore can be specified on the RaygunSettings tag in web.config, (or you can use the equivalent methods on RaygunClient if you are setting things up in code). The available options are:
ignoreFormFieldNames ignoreHeaderNames ignoreCookieNames ignoreServerVariableNames
These can be set to be a comma separated list of keys to ignore. Setting an option as * will indicate that all the keys will not be sent to Raygun. Placing * before, after or at both ends of a key will perform an ends-with, starts-with or contains operation respectively. For example, ignoreFormFieldNames="password" will cause Raygun to ignore all form fields that contain "password" anywhere in the name. These options are not case sensitive.
Modify or cancel message
On a RaygunClient instance, attach an event handler to the SendingMessage event. This event handler will be called just before the RaygunClient sends an exception - either automatically or manually. The event arguments provide the RaygunMessage object that is about to be sent. One use for this event handler is to add or modify any information on the RaygunMessage. Another use for this method is to identify exceptions that you never want to send to raygun, and if so, set e.Cancel = true to cancel the send.
Strip wrapper exceptions
If you have common outer exceptions that wrap a valuable inner exception which you'd prefer to group by, you can specify these by using the multi-parameter method:
raygunClient.AddWrapperExceptions(typeof(TargetInvocationException));
In this case, if a TargetInvocationException occurs, it will be removed and replaced with the actual InnerException that was the cause. Note that HttpUnhandledException and TargetInvocationException are already added to the wrapper exception list; you do not have to add these manually. This method is useful if you have your own custom wrapper exceptions, or a framework is throwing exceptions using its own wrapper.
Unique (affected) user tracking
There is a property named User on RaygunClient which you can set to be the current user's ID or email address. This allows you to see the count of affected users for each error in the Raygun dashboard. If you provide an email address, and the user has an associated Gravatar, you will see their avatar in the error instance page.
Make sure to abide by any privacy policies that your company follows when using this feature.
Version numbering
By default, Raygun will send the assembly version of your project with each report. If you need to provide your own custom version value, you can do so by setting the ApplicationVersion property of the RaygunClient (in the format x.x.x.x where x is a positive integer).
Tags and custom data
When sending exceptions manually, you can also send an arbitrary list of tags (an array of strings), and a collection of custom data (a dictionary of any objects). This can be done using the various Send and SendInBackground method overloads.
If you wish to add custom tags to automatically tracked exceptions you may add them via the RaygunExceptionHandler class
RaygunExceptionHandler.Tags = new[] {"CustomTag"};
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
-
.NETFramework 4.6.2
- Microsoft.Azure.WebJobs.Extensions (>= 2.0.0)
- Mindscape.Raygun4Net (>= 11.1.1)
- Mindscape.Raygun4Net.Core (>= 11.1.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
11.2.1 | 67 | 12/11/2024 |
11.2.0 | 74 | 12/10/2024 |
11.2.0-pre-1 | 64 | 12/8/2024 |
11.1.2 | 88 | 11/12/2024 |
11.1.2-pre-2 | 74 | 11/12/2024 |
11.1.2-pre-1 | 103 | 9/17/2024 |
11.1.1 | 128 | 9/12/2024 |
11.1.0 | 133 | 8/25/2024 |
11.0.4-pre-5 | 109 | 8/23/2024 |
11.0.4-pre-4 | 101 | 8/22/2024 |
11.0.4-pre-2 | 103 | 8/15/2024 |
11.0.4-pre-1 | 104 | 8/13/2024 |
11.0.3 | 85 | 7/25/2024 |
11.0.3-pre-1 | 92 | 7/22/2024 |
11.0.2 | 111 | 6/20/2024 |
11.0.0 | 103 | 6/9/2024 |
11.0.0-rc1 | 93 | 6/7/2024 |
11.0.0-pre3 | 86 | 5/30/2024 |
11.0.0-pre2 | 97 | 5/24/2024 |
11.0.0-pre1 | 101 | 5/23/2024 |
10.1.2 | 127 | 5/9/2024 |
10.1.2-pre-1 | 111 | 5/9/2024 |
10.1.1 | 126 | 3/27/2024 |
10.1.1-pre-1 | 115 | 3/20/2024 |
10.1.0 | 127 | 3/18/2024 |
10.1.0-pre-2 | 99 | 3/18/2024 |
10.1.0-pre-1 | 108 | 3/15/2024 |
10.0.0 | 123 | 3/13/2024 |
10.0.0-pre-6 | 102 | 3/12/2024 |
10.0.0-pre-5 | 100 | 3/12/2024 |
10.0.0-pre-4 | 113 | 2/23/2024 |
10.0.0-pre-2 | 95 | 2/23/2024 |
10.0.0-pre-1 | 113 | 2/22/2024 |
9.0.4 | 140 | 3/3/2024 |
9.0.4-pre-1 | 100 | 2/29/2024 |
9.0.3 | 127 | 2/27/2024 |
9.0.2 | 134 | 2/22/2024 |
9.0.2-pre-1 | 102 | 2/19/2024 |
9.0.1 | 127 | 2/8/2024 |
9.0.0-pre3 | 92 | 2/7/2024 |
9.0.0-pre-1 | 94 | 2/2/2024 |
8.3.0-pre1 | 105 | 1/26/2024 |
8.0.0 | 228 | 11/14/2023 |
8.0.0-pre-1 | 101 | 11/9/2023 |
7.1.0 | 149 | 10/9/2023 |
7.0.0 | 155 | 9/12/2023 |
6.0.3 | 343 | 6/14/2023 |
6.0.2 | 161 | 6/12/2023 |
5.7.0 | 2,072 | 4/21/2021 |
5.6.0 | 18,867 | 9/17/2018 |
5.5.2 | 18,723 | 10/24/2017 |
5.4.2 | 8,559 | 3/16/2017 |
5.4.1 | 1,126 | 3/15/2017 |