ServiceControl

ServiceControl is the backend to ServicePulse and ServiceInsight. It is a background process that collects useful information about an NServiceBus system. This includes messages that cannot be processed, their exceptions, and the ability to collect every message flowing through the system. It can also collect saga state changes, endpoint heartbeats, and perform custom checks. This information is exposed to ServicePulse and ServiceInsight via an HTTP API.

ServiceControl can also be configured to collect detailed performance metrics for display in ServicePulse.

For more information on how ServiceControl, ServicePulse, and ServiceInsight work together, refer to the Particular Service Platform.

ServiceControl instance types

After installation, the ServiceControl Management Utility provides the ability to add, upgrade and delete ServiceControl instances. There are three different instances that can be created:

  • Error instances
    This is the most commonly used ServiceControl instance and indispensable to ensure the correct working of an NServiceBus system. Together with SerivcePulse, it provides the ability to visualize and retry failed messages.
  • Audit instances
    This ServiceControl Audit instance provides valuable information about the message flow through a system.
  • Monitoring instances
    For performance monitoring and analyzing additional metrics, especially in production.

Installation of ServiceControl instances

After downloading ServiceControl, the ServiceControl Management utility is available in the Windows Start menu. The ServiceControl instances mentioned above need to be installed and configured via the Management utility.

Read more about how to install and configure ServiceControl instances.

Connect endpoints to ServiceControl

NServiceBus endpoints need to be configured to send data about their operations to a set of centralized queues that are unique to the system. ServiceControl monitors these queues, collects and processes this data.

Note that the data is sent to queues, even when ServiceControl is down. When ServiceControl becomes available, it will process the messages that were stored in the queue while it was offline.

To enable ServiceControl to gather this information, configure the endpoints appropriately:

See Optimizing ServiceControl for use in different environments for more information about practical considerations.

Related Articles


Last modified