Skip to content

Commit 7d782ca

Browse files
authored
Update capacity-and-planning.md
Update based on containers
1 parent 5f56ea4 commit 7d782ca

File tree

1 file changed

+7
-9
lines changed

1 file changed

+7
-9
lines changed

servicecontrol/capacity-and-planning.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: ServiceControl capacity planning
33
summary: Outlines the ServiceControl capacity, throughput, and storage considerations for planning and supporting production environments
4-
reviewed: 2023-06-02
4+
reviewed: 2024-12-02
55
isLearningPath: true
66
---
77

@@ -13,8 +13,12 @@ The primary job of ServiceControl is to collect information on system behavior i
1313

1414
### Location
1515

16-
Each ServiceControl instance stores its data in a [RavenDB embedded](https://ravendb.net/docs/article-page/5.3/csharp/server/embedded) instance. The location of the database has a significant impact on overall system performance and throughput. The embedded database files should be located on a high-performance storage device with a high-throughput connection to the machine hosting ServiceControl.
16+
Each ServiceControl instance stores its data in a [RavenDB](https://ravendb.net) instance.
1717

18+
For ServiceControl instances deployed via PowerShell or the ServiceControl Management Utility the database is run via an [embedded RavenDB server](/servicecontrol/configure-ravendb-location.md).
19+
For ServiceControl instances deployed via Containers the database is run via a [dedicated container](/servicecontrol/ravendb/containers.md).
20+
21+
The location of the database has a significant impact on overall system performance and throughput. The database files should be located on a high-performance storage device with a high-throughput connection to the machine hosting ServiceControl.
1822

1923
### Size
2024

@@ -30,10 +34,9 @@ See also: [Automatic Expiration of ServiceControl Data](how-purge-expired-data.m
3034

3135
**NOTE**
3236

33-
* The maximum supported size of the RavenDB embedded database is 16 TB.
37+
* The maximum supported size of a RavenDB embedded database is 16 TB.
3438
* Failed messages *never* expire and are retained indefinitely in the ServiceControl database.
3539

36-
3740
### Performance
3841

3942
From a performance perspective, ServiceControl is similar to a database installation. It requires a significant amount of disk and network I/O due to process audit, error and monitoring messages. Each of these message-processing operations requires disk I/O. The higher the message throughput of an environment, the higher the required disk I/O.
@@ -42,32 +45,27 @@ For this reason, it is best to store ServiceControl data on a disk with low late
4245

4346
For more details, see [Hardware Considerations](servicecontrol-instances/hardware.md).
4447

45-
4648
## Accessing data and audited messages
4749

48-
4950
### Forwarding queues
5051

5152
ServiceControl may be configured to forward consumed messages to other queues for further consumption by third party systems.
5253

5354
See also: [Forwarding Queues](errorlog-auditlog-behavior.md).
5455

55-
5656
### HTTP API
5757

5858
The ServiceControl HTTP API provides a JSON stream of audited and error messages (headers, body, and context) that can be imported into another database.
5959

6060
> [!NOTE]
6161
> The ServiceControl HTTP API is subject to changes and enhancements that may not be backward compatible. Use of the HTTP API by third parties is discouraged at this time.
6262
63-
6463
## Throughput
6564

6665
ServiceControl consumes audit, error, and control messages from all endpoints configured to forward those messages to it. This means the throughput (measured in received and processed messages per second) required by ServiceControl is the aggregate throughput of all endpoints forwarding messages to its queues.
6766

6867
The throughput of ServiceControl depends on multiple factors. Message size and network bandwidth have a significant effect. Another factor is the transport type used by the system.
6968

70-
7169
### Transport type
7270

7371
Different transport types have different throughput capabilities.

0 commit comments

Comments
 (0)