logging_seq.md

Logging with Seq

Seq is a popular log-aggregation system that gives you a powerful log search and dashboard engine with views across all of your services.

Tye can push logs to Seq easily without the need for any SDKs or code changes in your services.

Getting started: running locally with Seq

💡 If you want an existing sample to run, the sample here will do. This recipe will show examples of UI and data based on that sample. You own application will work fine, but the data and examples will look different.

The first step is to add the seq extension to your tye.yaml. Add the extensions node and its children from the example below.

name: frontend-backend

extensions:
- name: seq
  logPath: ./.logs

services:
- name: backend
  project: backend/backend.csproj
- name: frontend
  project: frontend/frontend.csproj

The logPath property here configures the path where Seq will store its data.

Now launch the application with Tye:

tye run

If you navigate to the Tye dashboard you should see an extra service (seq) in the list of services.

Visit the first URI (http://localhost:5341) in your browser to access the Seq dashboard.

Now you're ready to view the data! After it loads, it should look like the screenshot below:

Now you can see the logs from your application with each field broken out into structured format. If you take advantage of structured logging then you'll see your own data included in structured form here alongside framework logs.

It should like the screenshot below: