diff --git a/cloud-recording/develop/integration-best-practices.md b/cloud-recording/develop/integration-best-practices.md index 7a7411107..142dc0330 100644 --- a/cloud-recording/develop/integration-best-practices.md +++ b/cloud-recording/develop/integration-best-practices.md @@ -23,7 +23,41 @@ You use Cloud Recording RESTful APIs to get the status of the recording service. Best practice is that core apps do not rely on (). If your apps already rely heavily on the , contact support@agora.io and enable the redundant message notification function. This doubles the received notifications and reduces the probability of message loss. After enabling the message notification function, you need to deduplicate messages based on `sid`. Message notification still cannot guarantee a 100% arrival rate. -The initial QPS limit is 10 per App ID when you register. You can estimate the QPS quota your project needs according to your Peak Concurrent Worker (PCW) quota and query frequency. The initial PCW limit is 50 per AppID when you register. If the RESTful API returns QPS limitation error code `429`, or PCW quota limitation error code `406`, then retry, or contact support@agora.io to increase your QPS or PCW quota. +### Check the PCW and QPS limits + +Check that the Peak Concurrent Worker (PCW) and Queries per Second (QPS) values under your App ID do not exceed the Agora limits. + +#### PSW + +PCW limitations depend on your video stream resolution and region: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:---------------------|:----------------------|:---------------------|:----------------------|:--------------------------------| +| Individual recording | 1000 | 200 | 400 | 300 | +| Composite recording | SD 100, HD 50, FHD 30 | SD 50, HD 30, FHD 10 | SD 100, HD 50, FHD 30 | SD 100, HD 50, FHD 30 | + +Resolution description: + +- SD: Standard definition video, resolution ≤ 640 × 360 +- HD: High definition video, resolution ≤ 1280 × 720 and > 640 × 360 +- FHD: Full HD video, resolution ≤ 1920 × 1080 and > 1280 × 720 + +If you need to extend the limit for PSW, please contact support@agora.io. + +#### QPS + +The initial QPS limit is 10 per App ID when you register. You can estimate the QPS that your project needs according to your Peak Concurrent Worker (PCW) value and query frequency. If you need to extend the limit for QPS, please contact support@agora.io. + +### Check the stream limit + +The upper limit of video attributes supported by Agora is as follows: resolution 1920 × 1080, frame rate 30 FPS. +The maximum number of supported streams is detailed in the table below: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:----------------|:----------------------|:---------------------|:----------------------|:--------------------------------| +| Cloud recording | SD 100, HD 50, FHD 30 | SD 50, HD 30, FHD 10 | SD 100, HD 50, FHD 30 | SD 100, HD 50, FHD 30 | + +If you need to record multiple streams of different resolutions at the same time, make sure you meet the following requirements:
  • The number of streams in each resolution cannot exceed the corresponding limit for that resolution.
  • The total number of streams cannot exceed the limit set for the higher resolution. For example, if you need to use cloud recording service in mainland China to record both SD and HD, the total number of streams cannot exceed 100. If you record both HD and FHD, the total number cannot exceed 50.
 ### Ensure the recording service starts successfully diff --git a/cloud-recording/develop/webpage-best-practices.md b/cloud-recording/develop/webpage-best-practices.md index 6dfadf104..eb3887e00 100644 --- a/cloud-recording/develop/webpage-best-practices.md +++ b/cloud-recording/develop/webpage-best-practices.md @@ -21,6 +21,41 @@ External factors can cause problems with web page recording, including the follo To ensure reliability and consistency in the face of network issues, Agora recommends the following best practices. +### Check the PCW and QPS limits + +Check that the Peak Concurrent Worker (PCW) and Queries per Second (QPS) values under your App ID do not exceed the Agora limits. + +#### PSW + +PCW limitations depend on your video stream resolution and region: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:---------------------|:----------------------|:---------------------|:----------------------|:--------------------------------| +| Web page recording | SD 100, HD 50, FHD 30 | SD 50, HD 30, FHD 10 | SD 100, HD 50, FHD 30 | SD 100, HD 50, FHD 30 | + +Resolution description: + +- SD: Standard definition video, resolution ≤ 640 × 360 +- HD: High definition video, resolution ≤ 1280 × 720 and > 640 × 360 +- FHD: Full HD video, resolution ≤ 1920 × 1080 and > 1280 × 720 + +If you need to extend the limit for PSW, please contact support@agora.io. + +#### QPS + +The initial QPS limit is 10 per App ID when you register. You can estimate the QPS that your project needs according to your Peak Concurrent Worker (PCW) value and query frequency. If you need to extend the limit for QPS, please contact support@agora.io. + +### Check the stream limit + +The upper limit of video attributes supported by Agora is as follows: resolution 1920 × 1080, frame rate 30 FPS. +The maximum number of supported streams is detailed in the table below: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:----------------|:----------------------|:---------------------|:----------------------|:--------------------------------| +| Page recording | SD 100, HD 50, FHD 30 | SD 50, HD 30, FHD 10 | SD 100, HD 50, FHD 30 | SD 100, HD 100, FHD 30 | + +If you need to record multiple streams of different resolutions at the same time, make sure you meet the following requirements:
  • The number of streams in each resolution cannot exceed the corresponding limit for that resolution.
  • The total number of streams cannot exceed the limit set for the higher resolution. For example, if you need to use the web page recording service in mainland China to record both SD and HD, the total number of streams cannot exceed 100. If you record both HD and FHD, the total number cannot exceed 50.
 + ### Ensure the recording service starts successfully Take the following steps to ensure that the recording service starts successfully: diff --git a/flexible-classroom/get-started/enable-flexible-classroom.mdx b/flexible-classroom/get-started/enable-flexible-classroom.mdx index 84572e374..c7f953c62 100644 --- a/flexible-classroom/get-started/enable-flexible-classroom.mdx +++ b/flexible-classroom/get-started/enable-flexible-classroom.mdx @@ -217,10 +217,10 @@ To enable and configure Chat: ## Considerations -To ensure that Agora can access files in your third-party cloud storage space, you should enable public access or higher permissions for third-party storage spaces. - #### AWS S3 account configuration +To ensure that Agora can access files in your third-party cloud storage space, you should enable public access or higher permissions for third-party storage spaces. + Configure your AWS S3 account as follows: * Bucket policy @@ -265,6 +265,10 @@ Configure your AWS S3 account as follows: ``` ![](/images/flexible-classroom/configure-aws-ss2.png) +#### Service limit + +Flexible Classroom supports a maximum of 10,000 people online at the same time. If you need to extend your limit, contact technical support. + ## Next steps After enabling the service, see how to [quickly launch a classroom](../get-started). diff --git a/media-pull/develop/integration-best-practices.mdx b/media-pull/develop/integration-best-practices.mdx index ecb7f0feb..a7eb397cf 100644 --- a/media-pull/develop/integration-best-practices.mdx +++ b/media-pull/develop/integration-best-practices.mdx @@ -34,10 +34,32 @@ The following table shows the limits the number of queries per second (QPS) to t When the QPS is exceeded, the status code `429` (Too Many Requests) is returned. If you need a higher QPS limit, contact technical support. -### Maximum number of concurrent tasks +### PSW -The default maximum number of concurrent tasks is 50, which indicates that a maximum of 50 tasks can be run simultaneously in one project. -If a higher quota is required, contact technical support. +PCW limitations depend on your video stream resolution and region: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:-------------|:----------------------|:----------------------|:----------------------|:--------------------------------| +| Media Pull | SD 20, HD 20, FHD 10 | SD 20, HD 10, FHD 5 |SD 20, HD 10, FHD 5 | SD 20, HD 20, FHD 5 | + +Resolution description: + +- SD: Standard definition video, resolution ≤ 640 × 360 +- HD: High definition video, resolution ≤ 1280 × 720 and > 640 × 360 +- FHD: Full HD video, resolution ≤ 1920 × 1080 and > 1280 × 720 + +If you need to extend the limit for PSW, please contact support@agora.io. + +### Number of streams + +The upper limit of video attributes supported by Agora is as follows: resolution 1920 × 1080, frame rate 30 FPS. +The maximum number of supported streams is detailed in the table below: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:---------------|:----------------------|:---------------------|:----------------------|:--------------------------------| +| Media Pull | SD 20, HD 20, FHD 10 | SD 20, HD 10, FHD 5 | SD 20, HD 10, FHD 5 | SD 20, HD 20, FHD 5 | + +If you need to pull multiple streams of different resolutions at the same time, make sure you meet the following requirements:
  • The number of streams in each resolution cannot exceed the corresponding limit for that resolution.
  • The total number of streams cannot exceed the limit set for the higher resolution. For example, if you need both SD and HD streams in mainland China, the total number of streams cannot exceed 100. For HD and FHD, the total number cannot exceed 50.
 ## Ensure the high availability of REST services diff --git a/media-push/develop/integration-best-practices.mdx b/media-push/develop/integration-best-practices.mdx index a69e2827e..8702f82e4 100644 --- a/media-push/develop/integration-best-practices.mdx +++ b/media-push/develop/integration-best-practices.mdx @@ -26,7 +26,6 @@ The Agora server limits the number of queries per second (QPS) to the Media Push When the QPS is exceeded, the status code `429` (Too Many Requests) is returned. If you need a higher QPS limit, contact technical support. - |API |QPS limit | |:---------|:-----------------------------------------------------------------------| |Create |Creating a converter is limited to 50 queries per second.| @@ -34,11 +33,32 @@ is returned. If you need a higher QPS limit, contact technical support. |Update |Updating a specified converter is limited to 50 queries per second.| |Get |Getting the request rate of a specified converter is limited to 50 queries per second.| -### Maximum number of concurrent tasks +### PSW + +PCW limitations depend on your video stream resolution and region: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:-------------|:----------------------|:----------------------|:----------------------|:--------------------------------| +| Media Push | SD 300, HD 50, FHD 20 | SD 20, HD 5, FHD 0 |SD 20, HD 5, FHD 0 | SD 20, HD 5, FHD 0 | + +Resolution description: + +- SD: Standard definition video, resolution ≤ 640 × 360 +- HD: High definition video, resolution ≤ 1280 × 720 and > 640 × 360 +- FHD: Full HD video, resolution ≤ 1920 × 1080 and > 1280 × 720 + +If you need to extend the limit for PSW, please contact support@agora.io. + +### Number of streams + +The upper limit of video attributes supported by Agora is as follows: resolution 1920 × 1080, frame rate 30 FPS. +The maximum number of supported streams is detailed in the table below: + +| Service type | Mainland China | Europe | America | Asia (excluding mainland China) | +|:---------------|:----------------------|:---------------------|:----------------------|:--------------------------------| +| Media Push | SD 300, HD 50, FHD 20 | SD 20, HD 5, FHD 0 | SD 20, HD 5, FHD 0 | SD 20, HD 5, FHD 0 | -The default maximum number of concurrent tasks is 20, which indicates -that a maximum of 20 Media Push tasks can be run simultaneously in one -project. If a higher quota is required, contact technical support. +If you need to push multiple streams of different resolutions at the same time, make sure you meet the following requirements:
  • The number of streams in each resolution cannot exceed the corresponding limit for that resolution.
  • The total number of streams cannot exceed the limit set for the higher resolution. For example, if you need both SD and HD streams in mainland China, the total number of streams cannot exceed 100. For HD and FHD, the total number cannot exceed 50.
 ## Ensure the high availability of REST services diff --git a/shared/video-sdk/reference/_service_limits.mdx b/shared/video-sdk/reference/_service_limits.mdx new file mode 100644 index 000000000..9e40abe2a --- /dev/null +++ b/shared/video-sdk/reference/_service_limits.mdx @@ -0,0 +1,50 @@ +Agora imposes the following limits on PCU (Peak Concurrent Users), PCW (Per-Channel Workrate), and bandwidth: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ServePCU/PCW/BandwidthDomesticEuropeAmericaAsia
Real-time communicationPCU10K10K10K10K
Bandwidth10G10G10G10G
Media pushPCWSD：200 HD：50 FHD: 20SD：50 HD：20 FHD: 5SD：50 HD：20 FHD: 5SD：50 HD：20 FHD: 5
+ +PCU refers to the maximum number of people online at the same time, while PCW refers to the maximum number of concurrent tasks. The bandwidth calculation formula is as follows: + +PCU × host’s sending bit rate × number of concurrent hosts (single channel). + +For basic real-time interaction scenarios, the limit is reached when PCU or bandwidth reaches its corresponding limit. +For Media Push, the limit depends on the video resolution and is reached When PCW of any resolution reaches its respective limit. + +To ensure that your project runs smoothly, check the PCU, PCW, and bandwidth in your project regularly to ensure that all indicators are within the limit. If you need to extend the limit as your business grows, contact technical support. + + diff --git a/signaling/reference/limitations.mdx b/signaling/reference/limitations.mdx index fff7311f6..59d199fbd 100644 --- a/signaling/reference/limitations.mdx +++ b/signaling/reference/limitations.mdx @@ -13,7 +13,7 @@ A brief overview of the limitations of the Agora , including ## Channel message limit -The Agora does not have a limit on the number of concurrent online users. However, Agora has the following recommendations on the maximum number of channel messages per second for a single channel: +Agora has the following recommendations on the maximum number of channel messages per second for a single channel: | Concurrent online users in a single channel | Number of channel messages per second | | ------------------------------------------- | ----------------------------- | @@ -33,6 +33,21 @@ Agora provides customized service to increase the number of messages per second +## Service quota limits + +The following table lists the service quota limits for . When any of the following indicators exceed the limit, + contact technical support to extend it. + + +|Item |Limit | +|:--------------------------------------------|:------------------| +|RESTful API requests per second per App ID |500 | +|Increment in the number of concurrent users |50,000 | +|Increment in the number of daily active users|500,000 | +|Number of users on a single channel |50,000 | +|The number of users of a single channel is greater than 10,000 and the total number of messages sent by the channel per second is greater than 100 |/ | + + ## Miscellaneous - Notifications of a member joining or leaving the channel are automatically disabled when the number of channel members exceeds 512. diff --git a/video-calling/reference/service-limits.mdx b/video-calling/reference/service-limits.mdx new file mode 100644 index 000000000..76a1d9d27 --- /dev/null +++ b/video-calling/reference/service-limits.mdx @@ -0,0 +1,12 @@ +--- +title: Service limits +sidebar_position: 1 +description: > + Provides you with information on service limits +--- + +import ServiceLimits from '@docs/shared/video-sdk/reference/_service_limits.mdx'; + +export const toc = [{}] + +