👁 Image
PostHog 2.7.1

PostHog .NET SDK

This is a client SDK for the PostHog API written in C#. This is the core implementation of PostHog.

Goals

The goal of this package is to be usable in multiple .NET environments. At this moment, we are far short of that goal. We only support ASP.NET Core via .

Docs

More detailed docs for using this library can be found at PostHog Docs for the .NET Client SDK.

Usage

To use this package, create an instance of PostHogClient and call the appropriate methods. Here's an example:

using PostHog;

var client = new PostHogClient(new PostHogOptions { ProjectToken = "YOUR_PROJECT_TOKEN" });
client.Capture("user-123", "Test Event");

For console apps, scripts, or other places where passing a client instance around is inconvenient, you can configure a process-wide default client and use the PostHogSdk facade:

using PostHog;
using PostHog.Sdk;

PostHogSdk.Init(new PostHogOptions { ProjectToken = "YOUR_PROJECT_TOKEN" });
PostHogSdk.Capture("user-123", "Test Event");

await PostHogSdk.ShutdownAsync();

You can also assign an existing client:

using PostHog;
using PostHog.Sdk;

var client = new PostHogClient(new PostHogOptions { ProjectToken = "YOUR_PROJECT_TOKEN" });
PostHogSdk.DefaultClient = client;

PostHogSdk.Capture("user-123", "Test Event");

If no default client is configured, PostHogSdk methods are no-ops and log a warning once through Microsoft.Extensions.Logging. To enable SDK logs for the static facade and clients created by PostHogSdk.Init, set PostHogSdk.LoggerFactory before calling SDK methods:

using Microsoft.Extensions.Logging;
using PostHog.Sdk;

using var loggerFactory = LoggerFactory.Create(builder =>
{
 builder.AddConsole();
 builder.SetMinimumLevel(LogLevel.Information);
});

PostHogSdk.LoggerFactory = loggerFactory;