From f803291ed02b14550b529fd828880d12d45fb19b Mon Sep 17 00:00:00 2001 From: Charles Torre Date: Thu, 6 Mar 2025 18:20:41 -0800 Subject: [PATCH] 3.3.1: Readme/md/nuspec updates. --- ClusterObserver.nuspec.template | 3 ++- FabricObserver.nuspec.template | 6 +++--- README.md | 4 ++-- conuget.md | 4 ++-- foextlib.md | 6 ++++-- fonuget.md | 2 +- 6 files changed, 14 insertions(+), 11 deletions(-) diff --git a/ClusterObserver.nuspec.template b/ClusterObserver.nuspec.template index b3d783f6..79b193e2 100644 --- a/ClusterObserver.nuspec.template +++ b/ClusterObserver.nuspec.template @@ -4,7 +4,8 @@ %PACKAGE_ID% 2.3.1 -- .NET 8 implementation of ClusterObserver. This version is built for .NET 8 and SF Runtime >= 9.1 (Self-Contained FO builds only). If you have deployed SF Runtime version >= 10.1 Cumulative Update 3.0 (CU3), then you can deploy the framework-dependent release build for the target platform (Windows or Linux). If you are not running SF Runtime version >= 10.1 CU3, then you must deploy the Self-Contained release build for the target platform (Windows or Linux). **If you can't upgrade to .NET 8 yet, then do not upgrade to this version.** +- This version is built for .NET 8 and SF Runtime >= 10.0 (Self-Contained FO builds only for 10.0 - 10.1 CU2). If you have deployed SF Runtime version >= 10.1 Cumulative Update 3.0 (CU3), then you can deploy the framework-dependent release build for the target platform (Windows or Linux). If you are not running SF Runtime version >= 10.1 CU3, then you must deploy the Self-Contained release build for the target platform (Windows or Linux). **If you can't upgrade to .NET 8 yet, then do not upgrade to this version.** +- Removed Microsoft.ServiceFabric.Services package reference in ClusterObserver.csproj. This is not needed and cause compatibility issues for ClusterObserver plugins. Microsoft MIT diff --git a/FabricObserver.nuspec.template b/FabricObserver.nuspec.template index 4a507a06..fd38473d 100644 --- a/FabricObserver.nuspec.template +++ b/FabricObserver.nuspec.template @@ -4,9 +4,9 @@ %PACKAGE_ID% 3.3.1 - - .NET 8 implementation of FabricObserver. This version is built for .NET 8 and SF Runtime >= 9.1 (Self-Contained FO builds only). If you have deployed SF Runtime version >= 10.1 Cumulative Update 3.0 (CU3), then you can deploy the framework-dependent release build for the target platform (Windows or Linux). If you are not running SF Runtime version >= 10.1 CU3, then you must deploy the Self-Contained release build for the target platform (Windows or Linux). **If you can't upgrade to .NET 8 yet, then do not upgrade to this version.** - - The FabricObserverWebAPI project has been completely removed and all related usage in observers removed. - - FabricSystemObserver no longer monitors Windows Event Logs. Setting the related configuration values will have no effect. + - This version of FabricObserver is built for NET8 and SF Runtime 10.0 and higher: It will not work on lower versions of Service Fabric. + - Bug Fix: Extensibility library targets SF Services versions greater than or equal to 7.0.1816, which is SF 10.x. This is to ensure compatibility with the latest versions of Service Fabric and enable FO plugin authors to reference Microsoft SDK package that target 7.x versions. + - Linux Bug Fix: AppObserver conditional logic bug (Linux-only) is now fixed. This bug causes AppObserver to fail in FO version 3.3.0 (not earlier versions) running in Linux SF clusters. Microsoft MIT diff --git a/README.md b/README.md index 0b58c26c..01a2dd27 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ -## FabricObserver 3.3.1 (.NET 8, SF Runtime version 10.0 and higher) +## FabricObserver 3.3.1 (NET 8, SF Runtime version 10.0 and higher) [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fmicrosoft%2Fservice-fabric-observer%2Fmain%2FDocumentation%2FDeployment%2Fservice-fabric-observer.json) -[**FabricObserver (FO)**](https://github.com/microsoft/service-fabric-observer/releases) is a production-ready watchdog service with an easy-to-use extensibility model, written as a stateless, singleton Service Fabric **.NET 8** application that by default +[**FabricObserver (FO)**](https://github.com/microsoft/service-fabric-observer/releases) is a production-ready watchdog service with an easy-to-use extensibility model, written as a stateless, singleton Service Fabric **NET 8** application that by default 1. Monitors a broad range of physical machine resources that tend to be very important to all Service Fabric services and maps these metrics to the related Service Fabric entities. 2. Runs on multiple versions of Windows Server and Ubuntu. diff --git a/conuget.md b/conuget.md index f6ee2f64..a8134339 100644 --- a/conuget.md +++ b/conuget.md @@ -1,5 +1,5 @@ -### ClusterObserver 2.3.1 (.NET 8) -#### This version requires SF Runtime >= 9.1 and targets .NET 8. +### ClusterObserver 2.3.1 (NET 8) +#### This version requires SF Runtime >= 10.0 and higher, and targets NET 8. [ClusterObserver (CO)](https://github.com/microsoft/service-fabric-observer/tree/main/ClusterObserver) is a stateless singleton Service Fabric .NET 8 application that runs on one node in a cluster. CO observes cluster health (aggregated) and sends telemetry when a cluster is in Error or Warning. CO shares a very small subset of FabricObserver's (FO) code. It is designed to be completely independent from FO sources, diff --git a/foextlib.md b/foextlib.md index 8982e97a..63bf5ea3 100644 --- a/foextlib.md +++ b/foextlib.md @@ -1,6 +1,8 @@ -## FabricObserver Extensibility Library 3.3.1 (.NET 8) +## FabricObserver Extensibility Library 3.3.1 (NET 8, SF Runtime version 10.0 and higher) -FabricObserver.Extensibility is a .NET 8 library for building custom observers that extend FabricObserver's and ClusterObserver's capabilities to match your needs. A custom observer is managed just like a built-in observer. +FabricObserver.Extensibility is a .NET 8 library for building custom observers that extend FabricObserver's and ClusterObserver's capabilities to match your needs. A custom observer is managed just like a built-in observer. + +Note: Version 3.3.1 supports SF Runtime versions 10.0 and higher. It can not be used for lesser versions. ### How to implement an observer using FO's extensibility model diff --git a/fonuget.md b/fonuget.md index a8be2336..9a7c46e9 100644 --- a/fonuget.md +++ b/fonuget.md @@ -1,4 +1,4 @@ -## FabricObserver 3.3.1 (.NET 8) +## FabricObserver 3.3.1 (NET 8, SF Runtime version 10.0 and higher) [**FabricObserver (FO)**](https://github.com/microsoft/service-fabric-observer) is a production-ready watchdog service with an easy-to-use extensibility model, written as a stateless, singleton Service Fabric **.NET 8** application that by default