AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/architecture/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.

AWS observability services

AWS offers several observability solutions that can be used with the Particular Service Platform. They provide native monitoring, logging, alarming, and dashboards with Amazon CloudWatch, tracing through AWS X-Ray, and other open-source-based managed services. Together, these provide the three pillars of observability signals.

Amazon CloudWatch

Amazon CloudWatch is a monitoring and observability service that allows the collection and access of performance and operational data in the form of logs and metrics on a single platform.

➕ Pros:

  • Single tool to visualize metrics and logs emitted by the system
  • Fully managed service
  • Tightly integrated with other AWS services
  • Supports querying data from multiple sources to monitor metrics from AWS, on-premises, or other cloud providers
  • Customizable dashboards with automated alarms and remediating actions
  • Real-time telemetry

➖ Cons:

  • Does not support traces
  • Costs can escalate with increased usage

The Particular Service Platform collects metrics in two forms:

  1. OpenTelemetry-based metrics - can be collected by enabling OpenTelemetry and exporting the metrics to Amazon CloudWatch.
  2. Custom metrics with NServiceBus.Metrics - can be exported to Amazon CloudWatch.

Amazon X-Ray

Amazon X-Ray is a service that can receive trace data from applications. The trace data can provide insights to help identify the root cause of failures, hard-to-detect issues or side effects, and performance bottlenecks.

➕ Pros:

  • Single tool to visualize application-level and infrastructure-level traces
  • Creates a service map using trace data
  • Tightly integrated with other AWS services
  • Fully managed service

➖ Cons:

  • Costs can escalate with increased usage

The Particular Service Platform allows observability tools to capture spans emitted by NServiceBus, providing insights into how messages are being processed.

Try the OpenTelemetry sample with export to Amazon X-Ray →

Additional resources

Message processing failed... But what's the root cause?

In this presentation, Laila Bougria discusses the need for distributed tracing in distributed systems, as well as the ADOT collector (AWS Distro for OpenTelemetry Collector), AWS’ OpenTelemetry Collector implementation that simplifies exporting distributed traces from applications to AWS X-Ray, among others.

The AWS Loan Broker showcase demonstrates how to integrate the Particular Service Platform and OpenTelemetry metrics and traces when hosting solutions in AWS.

Do you have questions?

Ask our solution architects →

Get help with your proof of concept

Book a call →

In this article