AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/monitoring/llms.txt. The markdown version of this page is served as plain text. An MCP server at /mcp serves the same content via the search_docs and read_doc tools; it is read-only and needs no credentials. Markdown versions of documentation pages are available by appending .md to the page URL. Directory URLs use index.md. They are served as text/plain because some retrieval backends reject text/markdown.

Heartbeats

The Heartbeat plugin enables endpoint health monitoring by sending regular heartbeat messages from the endpoint to a ServiceControl instance. The ServiceControl instance keeps track of which endpoint instances are sending heartbeats and which ones are not.

graph LR subgraph Endpoint Heartbeats[Heartbeats Plugin] end Heartbeats -- Heartbeat<br>Data --> SCQ SCQ[ServiceControl<br>Input Queue] --> SC[ServiceControl Error Instance] SC -. Integration<br/>Events .-> Integration[Integration<br/>Event Handler] SC -- Endpoint health<br>data --> ServicePulse

Set up Heartbeats

To enable heartbeat monitoring in an environment:

  1. Install a ServiceControl instance
  2. Install and configure the Heartbeat plugin in endpoints that need to be monitored
  3. View the status of monitored endpoints in ServicePulse
  4. Optionally subscribe to integration events from ServiceControl when endpoints start/stop heartbeating

When an endpoint starts sending heartbeat messages, the ServiceControl instance will mark the endpoint as "active". If the ServiceControl instance stops receiving heartbeat messages from an endpoint, it will mark that endpoint as "inactive".

The Heartbeats plugin is only able to determine if the endpoint is running and sending heartbeat messages. For more sophisticated endpoint health checks, develop a custom check

Related Articles