Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Visualizing your cluster using Azure Service Fabric Explorer description: Service Fabric Explorer is an application for inspecting and managing cloud applications and nodes in a Microsoft Azure Service Fabric cluster. ms.topic: how-to ms.author: tomcassidy author: tomvcassidy ms.service: azure-service-fabric services: service-fabric ms.date: 03/22/2026 # Customer intent: "As a cloud application administrator, I want to visualize my Service Fabric cluster using a management tool, so that I can monitor its health, manage applications, and execute necessary actions efficiently." --- # Visualize your cluster with Service Fabric Explorer Service Fabric Explorer (SFX) is an open-source tool for inspecting and managing Azure Service Fabric clusters. Service Fabric Explorer is a desktop application for Windows, macOS and Linux. ### Running Service Fabric Explorer from the cluster Service Fabric Explorer is also hosted in a Service Fabric cluster's HTTP management endpoint. To launch SFX in a web browser, browse to the cluster's HTTP management endpoint from any browser - for example https:\//clusterFQDN:19080. For developer workstation setup, you can launch Service Fabric Explorer on your local cluster by navigating to https://localhost:19080/Explorer. Look at this article to [prepare your development environment](service-fabric-get-started.md). > [!NOTE] > If your cluster is secured by a self-signed certificate, you receive an error message from the web browser "This site isn't secure". You can proceed through most modern web browsers by overriding the warning. In a production environment, your cluster should be secured using common name and a certificate authority issued certificate. > > ## Connect to a Service Fabric cluster To connect to a Service Fabric cluster, you need the clusters management endpoint (FQDN/IP) and the HTTP management endpoint port (19080 by default). For example https\://mysfcluster.westus.cloudapp.azure.com:19080. Use the "Connect to localhost" checkbox to connect to a local cluster on your workstation. ### Connect to a secure cluster You can control client access to your Service Fabric cluster either with certificates or using Microsoft Entra ID. If you attempt to connect to a secure cluster, then depending on the cluster's configuration you will be required to present a client certificate or sign in using Microsoft Entra ID. ## Video tutorial [<b>Check this page for a training video to learn how to use Service Fabric Explorer.</b>](/shows/building-microservices-applications-on-azure-service-fabric/service-fabric-explorer) [!NOTE] > This video shows Service Fabric Explorer hosted in a Service Fabric cluster, not the desktop version. > ## Understand the Service Fabric Explorer layout You can navigate through Service Fabric Explorer by using the tree on the left. At the root of the tree, the cluster dashboard provides an overview of your cluster, including a summary of application and node health. ![Service Fabric Explorer cluster dashboard][sfx-cluster-dashboard] ### View the cluster's layout Nodes in a Service Fabric cluster are placed across a two-dimensional grid of fault domains and upgrade domains. This placement ensures that your applications remain available in the presence of hardware failures and application upgrades. You can view how the current cluster is laid out by using the cluster map. ![Service Fabric Explorer cluster map][sfx-cluster-map] ### View applications and services The cluster contains two subtrees: one for applications and another for nodes. You can use the application view to navigate through Service Fabric's logical hierarchy: applications, services, partitions, and replicas. In the example below, the application **MyApp** consists of two services, **MyStatefulService** and **WebService**. Since **MyStatefulService** is stateful, it includes a partition with one primary and two secondary replicas. By contrast, WebSvcService is stateless and contains a single instance. ![Service Fabric Explorer application view][sfx-application-tree] At each level of the tree, the main pane shows pertinent information about the item. For example, you can see the health status and version for a particular service. ![Service Fabric Explorer essentials pane][sfx-service-essentials] ### View the cluster's nodes The node view shows the physical layout of the cluster. For a given node, you can inspect which applications have code deployed on that node. More specifically, you can see which replicas are currently running there. ## Actions Service Fabric Explorer offers a quick way to invoke actions on nodes, applications, and services within your cluster. For example, to delete an application instance, choose the application from the tree on the left, and then choose **Actions** > **Delete Application**. ![Deleting an application in Service Fabric Explorer][sfx-delete-application] > [!TIP] > You can perform the same actions by clicking the ellipsis next to each element. > > Every action that can be performed through Service Fabric Explorer can also be performed through PowerShell or a REST API, to enable automation. > > You can also use Service Fabric Explorer to create application instances for a given application type and version. Choose the application type in the tree view, then click the **Create app instance** link next to the version you'd like in the right pane. ![Creating an application instance in Service Fabric Explorer][sfx-create-app-instance] > [!NOTE] > Service Fabric Explorer doesn't support parameters when creating application instances. Application instances use default parameter values. > > ## Event Store EventStore is a feature offered by the platform that provides Service Fabric platform events available in the Service Fabric Explorer and through REST API. You can see a snapshot view of what's going on in your cluster for each entity e.g. node, service, application and query based on the time of the event. You can also Read more about the EventStore at the [EventStore Overview](service-fabric-diagnostics-eventstore.md). ![Screenshot shows the Nodes pane with EVENTS selected.][sfx-eventstore] >[!NOTE] >As of Service Fabric version 6.4. EventStore isn't enabled by default and must be enabled in the resource manager template >[!NOTE] >As of Service Fabric version 6.4. the EventStore APIs are only available for Windows clusters running on Azure only. We are working on porting this functionality to Linux as well as our Standalone clusters. ## Image Store Viewer Image store viewer is a feature offered if using Native Image Store that allows for viewing the current contents of the Image store and get file and folder information, along with removing files/folders. ![Screenshot that shows the Image Store Viewer.][sfx-imagestore] ## Backup and Restore Service Fabric Explorer offers the ability to interface with [Backup and Restore](./service-fabric-reliable-services-backup-restore.md).In order to see Backup and Restore features in SFX BackupRestoreService must be enabled on cluster (Validate cluster manifest file). The following operations are possible: * Create, edit, and delete a Backup Policy. * Enable and disable Backup for an application, service, or partition. * Suspend and resume Backup for an application, service, or partition. * Trigger and track Backup of a partition. * Trigger and track Restore for a partition. For more on the Backup and Restore service, see the [REST API reference](/rest/api/servicefabric/sfclient-index-backuprestore). ## Next steps * [Managing your Service Fabric applications in Visual Studio](service-fabric-manage-application-in-visual-studio.md) * [Service Fabric application deployment using PowerShell](service-fabric-deploy-remove-applications.md) <!--Image references--> [sfx-cluster-dashboard]: ./media/service-fabric-visualizing-your-cluster/sfx-cluster-dashboard.png [sfx-cluster-map]: ./media/service-fabric-visualizing-your-cluster/sfx-cluster-map.png [sfx-application-tree]: ./media/service-fabric-visualizing-your-cluster/sfx-application-tree.png [sfx-service-essentials]: ./media/service-fabric-visualizing-your-cluster/sfx-service-essentials.png [sfx-delete-application]: ./media/service-fabric-visualizing-your-cluster/sfx-delete-application.png [sfx-create-app-instance]: ./media/service-fabric-visualizing-your-cluster/sfx-create-app-instance.png [sfx-eventstore]: ./media/service-fabric-diagnostics-eventstore/eventstore.png [sfx-imagestore]: ./media/service-fabric-visualizing-your-cluster/sfx-image-store.png