> For the complete documentation index, see [llms.txt](https://docs.xplatform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xplatform.com/performance/benchmark-suite/modules.md).

# Modules

The X Platform Performance Benchmark Suite consists of 7 modules, each testing a specific X Platform runtime component. This section provides detailed documentation for each module including benchmark programs, parameters, and interpreting results.

## Module Overview

| Module                                                                               | X Platform Component | What It Tests                                                      |
| ------------------------------------------------------------------------------------ | -------------------- | ------------------------------------------------------------------ |
| [Time Module](/performance/benchmark-suite/modules/time-module.md)                   | Time API             | Overhead of X Platform's high-performance time API                 |
| [Serialization Module](/performance/benchmark-suite/modules/serialization-module.md) | Encoding (ADM)       | Message encoding/decoding performance across different serializers |
| [Link Module](/performance/benchmark-suite/modules/link-module.md)                   | Link                 | Cluster replication link throughput and latency                    |
| [Messaging Module](/performance/benchmark-suite/modules/messaging-module.md)         | Messaging (SMA)      | Pub/sub messaging layer performance                                |
| [Persistence Module](/performance/benchmark-suite/modules/persistence-module.md)     | Persistence          | Message and data persistence performance                           |
| [Storage Module](/performance/benchmark-suite/modules/storage-module.md)             | Store (ODS)          | Object store operation performance                                 |
| [AEP Module](/performance/benchmark-suite/modules/aep-module.md)                     | Engine (AEP)         | **End-to-end canonical benchmark**                                 |

## Canonical Benchmark

The [**AEP Module**](/performance/benchmark-suite/modules/aep-module.md) contains the canonical end-to-end benchmark used for X Platform's official performance testing. This benchmark measures the complete Receive-Process-Send flow of a clustered microservice.

For detailed results from the canonical benchmark, see:

* [Canonical Benchmark Overview](/performance/canonical-benchmark.md)
* [Test Results](/performance/canonical-benchmark/test-results.md)

## Component Benchmarks

The other six modules isolate and test individual X Platform components:

### Low-Level Components

[**Time Module**](/performance/benchmark-suite/modules/time-module.md) - Tests the overhead of X Platform's time API, which is critical for timestamping and latency measurement.

[**Serialization Module**](/performance/benchmark-suite/modules/serialization-module.md) - Benchmarks message encoding/decoding across different serialization formats (Xbuf2, Protobuf, etc.).

### Messaging and Replication

[**Link Module**](/performance/benchmark-suite/modules/link-module.md) - Tests the cluster replication link that synchronizes state between primary and backup instances.

[**Messaging Module**](/performance/benchmark-suite/modules/messaging-module.md) - Benchmarks the pub/sub messaging layer (SMA) used for inter-service communication.

### Persistence and Storage

[**Persistence Module**](/performance/benchmark-suite/modules/persistence-module.md) - Tests message and transaction log persistence performance.

[**Storage Module**](/performance/benchmark-suite/modules/storage-module.md) - Benchmarks the object data store (ODS) used for state persistence.

## Using Module Documentation

Each module page includes:

1. **Overview** - What the module tests and why it matters
2. **Benchmark Programs** - Available test programs and their purposes
3. **Parameters** - Command-line options and their effects
4. **Running Examples** - Complete command-line examples
5. **Interpreting Results** - Understanding the benchmark output
6. **Performance Insights** - What the results tell you about X Platform performance

## Next Steps

* Choose a module from the list above to learn about its benchmarks
* See [Benchmark Suite Overview](/performance/benchmark-suite.md) for download and installation instructions
* Review [Canonical Benchmark Results](/performance/canonical-benchmark/test-results.md)
