Google Cloud Functions
Learn about Sentry's .NET integration with Google Cloud Functions.
Sentry provides an integration with Google Cloud Functions
through the Sentry.Google.Cloud.Functions NuGet package.
- Easy Google Cloud Functions integration, single line:
[assembly: FunctionsStartup(typeof(SentryStartup))]
- Captures unhandled exceptions in the middleware pipeline
- Captures exceptions handled by the framework
UseExceptionHandler
- Captures process-wide unhandled exceptions (AppDomain)
- Captures
LogError
orLogCritical
- Any event sent will include relevant application log messages
- RequestId as tag
- URL as tag
- Environment is automatically set (IHostingEnvironment)
- Request payload can be captured if opt-in
- Support for EventProcessors registered with DI
- Support for ExceptionProcessors registered with DI
- Supports configuration system (bind to
SentryAspNetCoreOptions
) - Server OS info sent
- Server Runtime info sent
- Request headers sent
- HTTP Proxy configuration
- Request body compressed
- Event flooding protection (429 retry-after and internal bound queue)
- Assembly Strong named
Add the Sentry dependency:
Install-Package Sentry.Google.Cloud.Functions -Version 4.13.0
Or, manually add the Sentry dependency into your csproj file:
<ItemGroup>
<PackageReference Include="Sentry.Google.Cloud.Functions" Version="4.13.0"/>
</ItemGroup>
This package extends Sentry.AspNetCore
, which in turn extends Sentry
's main SDK. That means that besides the logging-related features, through this package you'll also get access to all API and features available in those packages.
Messages logged from assemblies with the name starting with Sentry
will not generate events.
The simplest way to configure the Sentry.Google.Cloud.Functions
package is by setting up your Sentry configuration into appsettings.json
using the assembly method FunctionsStartup
to include the type SentryStartup
.
For example:
appsettings.json
"Sentry": {
"Dsn": "https://examplePublicKey@o0.ingest.sentry.io/0",
"MaxRequestBodySize": "Always",
"SendDefaultPii": true,
"MinimumBreadcrumbLevel": "Debug",
"MinimumEventLevel": "Warning",
"AttachStackTrace": true,
"Debug": true,
"DiagnosticsLevel": "Error"
}
An example of some of the options that can be configured via
appsettings.json
.
To load the configurations, you will need to use the assembly [assembly: FunctionsStartup(typeof(SentryStartup))]
. After being initialized, the framework automatically loads appsettings.json
and environment variables, binding to SentryAspNetCoreOptions
.
using System.Threading.Tasks;
using Google.Cloud.Functions.Framework;
using Google.Cloud.Functions.Hosting;
using Microsoft.AspNetCore.Http;
[assembly: FunctionsStartup(typeof(SentryStartup))]
public class Function : IHttpFunction
{
}
Some of the settings require actual code. For those, like the BeforeSend
callback, you will need to create a new class implementing the abstract class FunctionsStartup
to set it up:
using Google.Cloud.Functions.Hosting;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Sentry.AspNetCore;
[assembly: FunctionsStartup(typeof(CustomOptions))]
public class CustomOptions : FunctionsStartup
{
public override void ConfigureServices(WebHostBuilderContext context, IServiceCollection services)
{
base.ConfigureServices(context, services);
services.Configure<SentryAspNetCoreOptions>(options =>
{
options.SetBeforeSend(@event =>
{
@event.ServerName = null;
return @event;
});
});
}
}
Example modifying all events before they are sent to avoid server names being reported.
Much of the behavior of the Google cloud functions integration with Sentry can be customized by using the frameworks dependency injection system. That is done by registering your own implementation of some of the exposed abstraction inside of FunctionsStartup
.
When opting in to SendDefaultPii
, the SDK will automatically read the user from the request by inspecting HttpContext.User
. Default claim values like NameIdentifier
for the Id will be used.
If you wish to change the behavior of how to read the user from the request, you can register a new IUserFactory
into the container:
using Google.Cloud.Functions.Hosting;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Sentry.AspNetCore;
[assembly: FunctionsStartup(typeof(UserFactoryStartup))]
public class UserFactoryStartup : FunctionsStartup
{
public override void ConfigureServices(WebHostBuilderContext context, IServiceCollection services)
{
base.ConfigureServices(context, services);
services.AddSingleton<IUserFactory, MyUserFactory>();
}
}
As previously mentioned, this package is a wrapper around Sentry.Extensions.Logging, Sentry.AspNetCore and Sentry. Please refer to the documentation of these packages to get the options that are defined at those levels.
This snippet includes an intentional error, so you can test that everything is working as soon as you set it up.
try
{
throw null;
}
catch (Exception ex)
{
SentrySdk.CaptureException(ex);
}
- Google Cloud Functions sample
- For more samples of the .NET SDKs.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").