Skip to content

Commit 34b919f

Browse files
rbx-open-source-docs[bot]rbx-open-source-docs[bot]
committed
update Open Source Docs from Roblox internal teams
1 parent 5ea798b commit 34b919f

File tree

4 files changed

+135
-3
lines changed

4 files changed

+135
-3
lines changed

‎content/common/navigation/engine/guides.yaml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -534,6 +534,8 @@ navigation:
534534
path: /cloud-services/memory-stores/best-practices
535535
- title: Secrets stores
536536
path: /cloud-services/secrets
537+
- title: Extended Services
538+
path: /cloud-services/extended-services
537539
- title: Cross-server communication
538540
path: /cloud-services/cross-server-messaging
539541
- title: Roblox for Unity developers

‎content/en-us/cloud-services/data-stores/observability.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ The data stores dashboard is available for any experience that uses `Class.DataS
1818

1919
## Available charts
2020

21+
- **Storage Usage Bytes** on amount of data store storage and limit currently available for the selected universe.
2122
- **Request Count by API** on API request count per minute by API method, such as `Class.DataStore:SetAsync()` or `Class.OrderedDataStore:GetSortedAsync()`.
2223
- **Request Count by Status** on API request count by [response status](#response-status-codes).
2324
- **Request by API x Status** on response statuses returned by all or a specific API method.
@@ -26,12 +27,16 @@ The data stores dashboard is available for any experience that uses `Class.DataS
2627
- **List Request Type Quota Usage** on number of list API method calls against future list category limits.
2728
- **Remove Request Type Quota Usage** on number of remove API method calls against future remove category limits.
2829

29-
Use the selector at the top of the page to filter by standard or ordered data stores. The default view includes both.
30+
Use the selector at the top of the page to filter by standard or ordered data stores. The default view includes standard data store only.
31+
32+
Use the **Explore** button next to each chart to deep dive into that metric, compare the current period against past periods, or break down that metric by its available categories.
3033

3134
Each chart contains data for the past 30 days, and you can select to view a custom time range with the selector at the top of the page. If you select a time range earlier than 30 days, the system returns a **Request Failed** error.
3235

3336
Data from the most recent three minutes might be incomplete, so it's normal to see a drop at the end of the charts.
3437

38+
Storage usage and limit are displayed in bytes, where 1 kilobyte is 1024 bytes.
39+
3540
## Response status codes
3641

3742
The dashboard's **Request Count by Status** and **Requests by API x Status** charts include status codes of API responses that you can use to understand usage and troubleshoot errors. For a table that lists and describes all of these status codes (aside from `200 OK`), see [Error codes](error-codes-and-limits.md#error-code-reference).

‎content/en-us/cloud-services/extended-services.md‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
---
2+
title: Extended Services
3+
description: Extended Services is a platform that lets you manage your free and paid services.
4+
---
5+
6+
Extended Services is a solution that lets you manage service usage and payment beyond Roblox's default limits.
7+
8+
## Eligibility requirements
9+
10+
To use Extended Services, your Roblox account must:
11+
12+
- Be [ID-verified](../production/publishing/account-verification.md#verify-through-government-id).
13+
- Be located in the United States.
14+
- Have a valid email address associated with it.
15+
- Not currently be banned or moderated.
16+
- Accept and comply with the [terms of service](https://en.help.roblox.com/hc/articles/37967848292500).
17+
18+
<Alert severity="info">
19+
For group accounts, only the group owner needs to meet the eligibility requirements.
20+
</Alert>
21+
22+
## Unlock Extended Services
23+
24+
If you meet all of the [eligibility requirements](#eligibility-requirements), you can finish setting up Extended Services by entering your account details and payment information.
25+
26+
To unlock and use Extended Services:
27+
28+
1. In the Creator Dashboard, go to Creations and select an experience.
29+
2. Go to **Extended Services**.
30+
3. If you haven't entered your account details and payment information yet, click **Add missing information** on the top banner.
31+
1. Enter your account information. The **Account type**, **Tax ID type**, and **Tax ID** fields are optional. You can also go to **Finances** > **Account Information** > **Extended Services** to manage your account information.
32+
2. Click **Next**.
33+
3. Enter a payment method. You can enter a new payment method or select from the available payment options already associated with your Roblox account.
34+
4. Click **Save**.
35+
36+
<h5>Account status</h5>
37+
38+
Your Extended Services account can be in one of the following statuses:
39+
40+
<table>
41+
<thead>
42+
<th width="15%">**Status**</th>
43+
<th width="40%">**Description**</th>
44+
<th width="80%">**Required action**</th>
45+
</thead>
46+
<tbody>
47+
<tr>
48+
<td>**Normal**</td>
49+
<td>You can use all Extended Services features.</td>
50+
<td>No action is required.</td>
51+
</tr>
52+
<tr>
53+
<td>**Overdue**</td>
54+
<td>Your account is overdue because your automatic payment method failed. Roblox offers a grace period of **one day** before suspending your Extended Services account.</td>
55+
<td>Change your payment method and retry a manual payment, or wait until Roblox attempts to charge your payment method again after the grace period has ended.</td>
56+
</tr>
57+
<tr>
58+
<td>**Suspended**</td>
59+
<td>You can't use any paid Extended Services. You can, however, still use services with default limits.</td>
60+
<td>Fix your eligibility requirements, add a valid payment method, or manually pay the overdue balance on your account.</td>
61+
</tr>
62+
</tbody>
63+
</table>
64+
65+
## Enable a service
66+
67+
<Alert severity="warning">
68+
Extended Services is currently only available for the [Memory stores service](./memory-stores/index.md).
69+
</Alert>
70+
71+
To enable a service:
72+
73+
1. Go to **Extended Services**.
74+
2. Toggle on the service you want to enable.
75+
3. Enter a monthly budget for each applicable resource under the service. The minimum monthly budget you can set is $1 USD.
76+
77+
Your payment method is charged either at the end of the month when a bill is generated, or when your usage reaches $5 USD, whichever comes first.
78+
79+
You can increase or decrease a service's monthly budget any time. Your service is automatically throttled if you decrease your budget to an amount below your current month-to-date usage, or if you exceed the budget you have set.
80+
81+
Roblox notifies you by email when your usage reaches 80% of your budget, and then again when it reaches 100%.
82+
83+
## Manage billing
84+
85+
To access the Extended Services billing dashboard:
86+
87+
1. Go to **Finances** > **Billing**.
88+
2. Select the **Cloud services** tab to display the following:
89+
- Your pending balance, including month-to-date cost
90+
- Your billing history, including all Extended Services billing activity across your experiences
91+
92+
For a detailed breakdown of your current pending balance costs, click **View Details** next to your payment method. For a detailed invoice of a previous bill, click **View Bill** under **Billing history**.
93+
94+
## Service pricing
95+
96+
See the following table for Extended Services pricing.
97+
98+
<table>
99+
<thead>
100+
<th>**Service**</th>
101+
<th>**Default**</th>
102+
<th>**Extended**</th>
103+
</thead>
104+
<tbody>
105+
<tr>
106+
<td style={{border: 'none'}}><a href="https://create.roblox.com/docs/cloud-services/memory-stores" style={{color: 'inherit', textDecoration: 'underline'}}><strong>Memory stores</strong></a></td>
107+
</tr>
108+
<tr>
109+
<td style={{border: 'none'}}>Request units</td>
110+
<td style={{border: 'none'}}>1000 + (CCU x 120) request units</td>
111+
<td style={{border: 'none'}}>$0.003 / 1M request units</td>
112+
</tr>
113+
<tr>
114+
<td style={{paddingBottom: '24px'}}>Storage</td>
115+
<td style={{paddingBottom: '24px'}}>64KB + (CCU x 1.2KB)</td>
116+
<td style={{paddingBottom: '24px'}}>$0.10 / GB Hours<sup>1</sup></td>
117+
</tr>
118+
</tbody>
119+
</table>
120+
121+
<sup>1. GB Hours = the storage consumption multiplied by the amount of time. For example, 100GB Hours might equate to "100GB x 1 hour" or "200GB x 0.5 hours".</sup>

‎content/en-us/cloud-services/memory-stores/index.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Memory stores have an eviction policy based on expiration time, also known as ti
2727

2828
### Memory size quota
2929

30-
The memory quota limits the total amount of memory that an experience can consume. It's not a fixed value. Instead, it changes over time depending on the number of users in the experience according to the following formula: **64KB + 1KB \* [number of users]**. The quota applies on the experience level instead of the server level.
30+
The memory quota limits the total amount of memory that an experience can consume. It's not a fixed value; instead, it changes over time depending on the number of users in the experience according to the formula **64KB + 1.2KB \* [number of users]**. The quota applies on the experience level instead of the server level.
3131

3232
When users join the experience, the additional memory quota is available immediately. When users leave the experience, the quota doesn't reduce immediately. There's a traceback period of eight days before the quota reevaluates to a lower value.
3333

@@ -37,7 +37,7 @@ With the [observability](../../cloud-services/memory-stores/observability.md) da
3737

3838
### API request limits
3939

40-
For API request limits, there's a **request unit** quota that applies for all `Class.MemoryStoreService` API calls. The quota is **1000 + 100 \* [number of concurrent users]** request units per minute.
40+
A **request unit** quota applies to all `Class.MemoryStoreService` API calls. This quota is **1000 + 120 \* [number of concurrent users]** request units per minute.
4141

4242
Most API calls only consume one request unit, with a few exceptions:
4343

@@ -100,6 +100,10 @@ To keep your memory usage pattern optimal and avoid hitting the [limits](#limits
100100

101101
For example, consider using the [LZW](https://en.wikipedia.org/wiki/Lempel%E2%80%93Ziv%E2%80%93Welch) algorithm to reduce the stored value size.
102102

103+
- Enroll in Extended Services.
104+
105+
You can increase your Storage and Request Limit quotas by onboarding onto [Extended Services](https://create.roblox.com/docs/cloud-services/extended-services)
106+
103107
## Observability
104108

105109
The [Observability Dashboard](../../cloud-services/memory-stores/observability.md) provides insights and analytics for monitoring and troubleshooting your memory store usage. With real-time updating charts on different aspects of your memory usage and API requests, you can track the memory usage pattern of your experience, view the current allocated quotas, monitor the API status, and identify potential issues for performance optimization.

0 commit comments

Comments
 (0)