Shadow Service
Shadow Service is a data cache service provided by EMQX Cloud. Users can implement IoT applications quickly through Topics and APIs.
With Shadow Service, users do not need to set up cloud services, create VPC connections, or transfer data through data integration step by step. Instead, this capability is used to rapidly implement applications such as things models, device shadow, and other applications related to data reporting and distribution, resulting in significant savings in development and costs.
Enable Shadow Service
Due to the architect infrastructure, Shadow Service is currently only available for the deployments managed on AWS. In addition, Shadow Service is only available for Professional Plan, so if you have purchased Standard Plan, it's not able to use this service for the time being.
If you have a running deployment that meets all the criteria above, you can submit a ticket to apply for enabling the service. Once it is enabled, you need to refresh the deployment overview page and you will see Shadow Service from the left menu. Click the Shadow Service menu will bring you to the Usage Overview tab page.
Brief Instruction
The metrics for Shadow Service include memory, invocation, and traffic.
- The memory for Shadow Service is in three sizes: 1GB, 2GB, and 4GB. The size indicates the storage and the maximum amount of shadow models. The maximum size of a shadow JSON is 128 KB. The estimated amount of shadows that can be created is based on the file size.
| Specification | Shadow Model Amount |
|---|---|
| 1 GB | 8000 |
| 2 GB | 16,000 |
| 4 GB | 32,000 |
The above figures are for reference only and the actual number of shadows that can be created is subject to the actual scenario. As shadows are generally smaller than the maximum size of 128KB, the actual maximum amount can be much larger than the above figures.
:::
The invocation includes every message published from the device or client and every API call. It will be billed at a unit rate of 0.04 USD per 10,000 requests.
The traffic generated by Shadow Service will be attributed as part of the monthly traffic of the deployment.
Shadow Service supports up to 1000 QPS (Query Per Second).
Trial
Shadow Service is available on a 7-day trial with the following rules.
- Only for Professional Plan deployments.
- Only 1GB service can be selected for the trial.
- The trial is available once for each account and cannot be applied again when the trial period ends or if the service is deleted during the trial period.
- After the trial ends, the service will be billed according to usage.
- At the end of the trial, if there is no credit card info of the account, the service will be deleted and the data related to the service will be deleted as well.
Billing
For more about billing, please see Billing of Shadow Service。
Delete Shadow Service
Please note that when the service is in the billing phase, it will still be billed even if no shadows have been created. When you decide not to use the service anymore, click the "delete" icon at the upper right corner of the Shadow Service page to stop the billing.
Quick Guide
Please see the Features Overview for a quick-start guide on Shadow Service.