Lightrun 1.21.0

Lightrun for .NET

Lightrun is a developer-native observabity platform. It's a way to add logs, inspect the state of the current execution (in a familiar, debugger-like view), and extract any type of code-level metric on the fly - without redeploying, restarting or even stopping the running application.

Check out our docs to learn more.

Getting Started

To get started with Lightrun you'll need three things:

1. A Lightrun Account - you can get one here.
2. A Lightrun Plugin - you'll have instructions to download it once you create an account, but you can also check them out here.
3. A Lightrun Agent - which is this very NuGet package! It's the thing that actually does the magic.

Once you've signed up for an account and downloaded the plugin, you can install the agent in your application.

Installing the Lightrun Agent

In order to install the Lightrun .NET Agent please follow these steps:

1. Add the Lightrun NuGet package to your project

2. Import Lightrun at the start of your your application file (i.e. Program.cs) and then start it:

using Lightrun;

LightrunAgent.Start(new AgentOptions {
   Secret = "<COMPANY-SECRET>",
});

You will have a <COMPANY-SECRET> auto-generated for you during the onboarding process, right after signing up for an account.

Important Note - Debugging Information

Lightrun for .NET needs to have debugging information available to it in order to work properly. Please make sure to set DebugType to portable when compiling your project code.

3. Run the application as you normally would.

You should now see the application's agent popping up in the Lightrun Plugin's sidebar - you can now add logs, snapshots and metrics to your application.

Providing Credentials via Environment Variables

You can optionally choose to provide the <COMPANY-SECRET> via environment variables to the .NET process. To do so, follow these steps after installing the agent:

1. Import Lightrun at the start of the file:

using Lightrun;

LightrunAgent.Start(new AgentOptions());

2. Run the application with the environment variables provided before the dotnet command (note that this does not work on Windows):

LIGHTRUN_SECRET=<COMPANY-SECRET> dotnet myapp.dll