You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: servicecontrol/capacity-and-planning.md
+7-9Lines changed: 7 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: ServiceControl capacity planning
3
3
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
5
5
isLearningPath: true
6
6
---
7
7
@@ -13,8 +13,12 @@ The primary job of ServiceControl is to collect information on system behavior i
13
13
14
14
### Location
15
15
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.
17
17
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.
18
22
19
23
### Size
20
24
@@ -30,10 +34,9 @@ See also: [Automatic Expiration of ServiceControl Data](how-purge-expired-data.m
30
34
31
35
**NOTE**
32
36
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.
34
38
* Failed messages *never* expire and are retained indefinitely in the ServiceControl database.
35
39
36
-
37
40
### Performance
38
41
39
42
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
42
45
43
46
For more details, see [Hardware Considerations](servicecontrol-instances/hardware.md).
44
47
45
-
46
48
## Accessing data and audited messages
47
49
48
-
49
50
### Forwarding queues
50
51
51
52
ServiceControl may be configured to forward consumed messages to other queues for further consumption by third party systems.
52
53
53
54
See also: [Forwarding Queues](errorlog-auditlog-behavior.md).
54
55
55
-
56
56
### HTTP API
57
57
58
58
The ServiceControl HTTP API provides a JSON stream of audited and error messages (headers, body, and context) that can be imported into another database.
59
59
60
60
> [!NOTE]
61
61
> 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.
62
62
63
-
64
63
## Throughput
65
64
66
65
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.
67
66
68
67
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.
69
68
70
-
71
69
### Transport type
72
70
73
71
Different transport types have different throughput capabilities.
0 commit comments