From 055dcbe3c351f4c4487288f5654c73e111490f66 Mon Sep 17 00:00:00 2001 From: petar-i-todorov Date: Wed, 23 Jul 2025 18:07:03 +0300 Subject: [PATCH 1/2] docs: add info on how to use serilog env vars to enable logging --- dotnet-docs/logging.md | 29 +++++++++++++++++++++++++---- 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/dotnet-docs/logging.md b/dotnet-docs/logging.md index 27464683..5c14296a 100644 --- a/dotnet-docs/logging.md +++ b/dotnet-docs/logging.md @@ -14,10 +14,31 @@ The Report Server for .NET uses [Serilog](https://serilog.net/) to allow writin ## Setup -The configuration options for Serilog that would usually be set up through the C# API - [Serilog Configuration Basics](https://github.com/serilog/serilog/wiki/Configuration-Basics), can instead be -defined in the `appsettings.json` configuration files of the Report Server for .NET. +The configuration options for Serilog that would usually be set up through the C# API - [Serilog Configuration Basics](https://github.com/serilog/serilog/wiki/Configuration-Basics), can be configured in two ways: -### Report Server Manager +1. [Environment Variables](#using-environment-variables) - Set system-wide environment variables. +2. [Configuration Files](#using-configuration-files) - Modify the `appsettings.json` files directly. + +### Using Environment Variables + +You can enable logging for both the Report Server Manager and Service Agent at the same time by setting the following environment variables: + +```` +Serilog__MinimumLevel=Verbose +Serilog__WriteTo__1__Name=File +Serilog__WriteTo__1__Args__path=Logs/rsnetlogs.txt +```` + +This requires the default Serilog configuration to exist in the `appsettings.json` files for both the manager and service components, as environment variables are intended to override these base settings as needed. + +>note When the Report Server is installed using the MSI installer, it runs under a dedicated Windows user account (ReportServerUser) or a system account (e.g., LocalSystem) depending on your installation choice. These accounts do not have access to user-level environment variables. +> To ensure environment variable overrides work correctly, you must define them at the **system level**. + +### Using Configuration Files + +Alternatively, you can define the configuration in the `appsettings.json` configuration files of the Report Server for .NET. + +#### Report Server Manager The `appsettings.json` file of the Report Server Manager for .NET resides in its installation directory, for example, `C:\Program Files (x86)\Progress\Telerik Report Server\Telerik.ReportServer.Web.NET\`. The following configuration settings can be added to that file, at the top level: @@ -37,7 +58,7 @@ The following configuration settings can be added to that file, at the top level } ```` -### Service Agent +#### Service Agent The Report Server for .NET ServiceAgent's `appsettings.json` file can be found in its installation directory, by default - `C:\Program Files (x86)\Progress\Telerik Report Server\Services\.NET\`. The following configuration settings can be added to that file, at the top level: From 6ccf02f2b1601cab9568d1edae242a2f17a1d979 Mon Sep 17 00:00:00 2001 From: Dimitar Nikolov Date: Tue, 26 Aug 2025 18:02:00 +0300 Subject: [PATCH 2/2] Update whitelabeling.md --- implementer-guide/configuration/whitelabeling.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/implementer-guide/configuration/whitelabeling.md b/implementer-guide/configuration/whitelabeling.md index c7fdb103..8ec9155c 100644 --- a/implementer-guide/configuration/whitelabeling.md +++ b/implementer-guide/configuration/whitelabeling.md @@ -10,9 +10,9 @@ position: 600 # Whitelabeling ->note Starting from 2025 Q3, the whitelabeling functionality is now also available for Report Server for .NET. +>note Starting with the [2025 Q3](https://www.telerik.com/support/whats-new/report-server/release-history/progress-telerik-report-server-2025-q3-11-2-25-813) release, the whitelabeling functionality is now also available in the [Report Server for .NET]({%slug coming-soon%}). -Whitelabeling enables Report Server customers to remove branding elements in the Report Server web application and [Standalone Report Designer]({%slug report-designer%}) application and replace them with branding from the customer enterprise. +Whitelabeling enables Report Server customers to remove branding elements in the Report Server web application and [Standalone Report Designer]({%slug report-designer%}) application and replace them with branding from the customer's enterprise. The following elements can be rebranded: