Documentation
DocumentationDiscussions
These docs are for v5.0. Click to read the latest docs for v2024.2.

Getting Started on Windows

Seq is the easiest way to collect, search, analyze and alert on structured log data. This page will have you up and running in under five minutes!

Seq is a log server that runs on a central machine. Your applications send structured events through a framework like ASP.NET Core logging or Serilog:

log.Warning(
  "HTTP {Method} {RequestPath} responded {StatusCode} in {Elapsed:0.000} ms",
  request.Method,
  request.Path,
  response.StatusCode,
  elapsed.TotalMilliseconds);

Structured logging preserves the individual property values, as well as the text, associated with each event.

These are sent across the network to Seq, which displays them and makes them searchable:

2256

Getting started is easy and quick. You need to:

  1. Download and install the Seq server
  2. Add the appropriate NuGet package to your application

And that's it! Here we go step by step.

Installing the Seq Server

The Seq server is a Windows service that accepts incoming events and hosts the main web user interface over HTTP or HTTPS.

If you're just setting up on your own developer workstation, you machine almost certainly has everything required. If you're hosting Seq on a shared server for your team, check out the System Requirements and Azure Installation Guide.

Opening the installer MSI file will start the Setup Wizard:

896

Step through each page of the wizard. On a developer workstation the defaults are fine. Check out the Production Deployment Checklist if you're going "live".

After the wizard completes, browse the Seq UI at http://localhost:5341.

Enabling Authentication

A local development instance that isn't exposed to the outside world might be fine without authentication on the UI and API. In most cases, though, your next step should be visiting Settings > Users and enabling authentication.

Collecting Log Events

Before you can benefit from Seq, your applications need to be configured to send log events through one of the supported logging libraries.

  • Using Serilog - Serilog is a modern logging library for the .NET platform with deep support for structured event data.
  • Using ASP.NET Core - the Microsoft.Extensions.Logging library included in ASP.NET Core works well with Seq.
  • Using Node.js - on Node.js, we support the Bunyan logging library

Seq integrates with a range of languages, libraries and frameworks, and has a simple HTTP API for receiving log data. For detailed options see the Inputs heading in the topic list on the left-hand side of this page.

📘

If you're unsure where to start, we recommend Serilog.

What's Next?

Once your apps are happily sending events to Seq, you can:

Happy logging!