Skip to content

Add query parameter support for filter deep-linking #192

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 5 commits into
base: master
Choose a base branch
from
Open

Add query parameter support for filter deep-linking #192

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3d9f0c9
Initial plan
Copilot Jan 26, 2026
8ff4e5b
Add query parameter support for filters
Copilot Jan 26, 2026
55b098f
Fix infinite loop prevention in URL sync
Copilot Jan 26, 2026
b27b5c3
Add documentation for query parameters feature
Copilot Jan 26, 2026
7e8773e
Address code review feedback - add validation and use constants
Copilot Jan 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,42 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)

Do you want to test the package on-the-fly? Try out the [samples](https://github.com/serilog-contrib/serilog-ui/wiki/Develop#sample-applications), with no configuration required!

## Query Parameters for Deep Linking

You can now link directly to serilog-ui with specific filter values using query parameters in the URL. This is useful for:
- Linking from external systems to specific logs or timeframes
- Sharing filtered views with team members
- Bookmarking frequently used filter combinations

### Supported Query Parameters

| Parameter | Aliases | Description | Example |
|-----------|---------|-------------|---------|
| `table` | `key` | The log table/database to query | `?table=MyLogs` |
| `level` | - | Filter by log level | `?level=Error` |
| `search` | - | Search text filter | `?search=exception` |
| `startDate` | `from` | Start date/time (ISO 8601) | `?startDate=2024-01-01T00:00:00Z` |
| `endDate` | `to`, `till` | End date/time (ISO 8601) | `?endDate=2024-01-02T00:00:00Z` |
| `sortOn` | - | Property to sort by | `?sortOn=Timestamp` |
| `sortBy` | - | Sort direction (`Asc` or `Desc`) | `?sortBy=Desc` |
| `page` | - | Page number | `?page=2` |
| `count` | `entriesPerPage` | Number of entries per page | `?count=50` |

Comment on lines +98 to +109
Copy link

Copilot AI Mar 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The README’s markdown table is malformed (each row starts with ||), which renders as an extra empty column in most markdown parsers. Use single leading/trailing | for each row so the table formats correctly.

Copilot uses AI. Check for mistakes.
### Examples

```
# Link to errors from the last day
/serilog-ui?level=Error&startDate=2024-01-25T00:00:00Z&endDate=2024-01-26T00:00:00Z

# Link to logs containing "payment" in a specific table
/serilog-ui?table=ProductionLogs&search=payment

# Combine multiple filters
/serilog-ui?level=Warning&startDate=2024-01-01T00:00:00Z&search=timeout&count=25
```

The URL will automatically update as you change filters in the UI, making it easy to share your current view with others.

## Issues and Contribution

Everything is welcome! :trophy: See the [contribution guidelines](https://github.com/serilog-contrib/serilog-ui/blob/master/CONTRIBUTING.md) for details.
Expand Down
Loading
Loading