Skip to content

1.0.0
Compare
Choose a tag to compare
@andreasohlund andreasohlund released this 16 Apr 06:47
· 1892 commits to master since this release
1.0.0
5597cad

Introduction

ServiceInsight provides debugging and analysis capabilities for your NServiceBus system.

I provides under-the-hood view of the your system's behaviour, clearly displayed and visualized, immediately available and up-to-date.

ServiceInsight features are valuable in development, testing and production environments

http://docs.particular.net/ServiceInsight/getting-started-overview

Prerequisites

  • Microsoft .NET Framework 4.5
  • ServiceControl
    • ServiceInsight connects to and relies on ServiceControl' audit database for its information and functionality
    • See ServiceControl releases for guidance on installation and configuration.
    • ServiceControl can be installed on the local machine or on a remote machine that is accessible (via HTTP) to ServiceInsight

Optional components

  • ServiceMatrix
    • ServiceMatrix enables you to generate a fully functional distributed application skeleton in a matter of minutes, dramatically reducing the learning curve, POC effort and time-to-market of distributed systems development with NServiceBus.
    • ServiceInsight integrates with ServiceMatrix during development and debugging, allowing you to quickly visualize the run-time behavior of your designed NServiceBus system, and quickly iterate from design to run-time views of your system.
  • ServicePulse
    • ServicePulse is a production monitoring tool that allows you to monitor and detect any issues with your NServiceBus endpoints and messages.
    • ServiceInsight integrates with ServicePulse, allowing you to access detailed failure information and context visualizations
    • See ServicePulse release notes for guidance on installation and configuration.

Installation

  1. Run the ServiceInsight installer
  2. By default, the installer will add desktop and programs shortcuts to ServiceInsight

Connecting to ServiceControl

  1. Following the installation, when first launching ServiceInsight, it will try to connect to a local ServiceControl instance (http://localhost:33333/api/)
  2. If there is no ServiceControl instance running on the local machine, you can use the ServiceInsight user interface to connect to any accessible ServiceControl URI, by clicking on the menu "Tools" > "Connect to ServiceControl" or clicking the "Connect" toolbar button
  3. The ServiceControl URI is comprised of the ServiceControl hostname and IP port. By default it is set to localhost with the default port 33333 (http://localhost:33333/api/). Both are configurable.

Troubleshooting:

  1. Unable to connect to ServiceControl URI
    • See ServiceControl Release Notes troubleshooting section
    • ServiceInsight connects to ServiceControl through HTTP
    • You can view the connection and requests logs in the "Logs" tab (at the bottom of the ServiceInsight screen).
      • The "Logs" window details every request made to ServiceControl, including its request parameters, headers and response headers (the request info detailed in the "Logs" window can be re-run through any HTTP / REST client application)
    • Make sure the ServiceControl URI is accessible from the calling machine, using a standard HTTP / REST client
    • Make sure that ServiceInsight is allowed (by firewall / security settings) to make HTTP requests to the ServiceControl URI
  2. ServiceInsight UI display is not responding
    • This may be due to changes in layout engine from beta preview versions of ServiceInsight
    • To resolve this issue, delete the layout settings file:
      1. Close ServiceInsight
      2. Navigate to C:\Users\{current-user}\AppData\Roaming\IsolatedStorage
      3. Inside the IsolatedStorage directory structure, locate the file ShellLayout.settings
      4. Delete ShellLayout.settings
      5. Start ServiceInsight (this will re-create ShellLayout.settings)

Logging

http://docs.particular.net/ServiceInsight/how-logging-works

Assets 3
Loading