eCG Cloud: data and actions
What eCG Cloud is
eCG Cloud is the part of each app that keeps data and does server work. See its three parts, where to find them, who can change them and what states mean.
eCG Cloud is the working back end of one app. It is where the app keeps what it needs to remember, such as orders, bookings and sign-ups, and where it does work a web page cannot do safely on its own, such as taking a payment or sending an email.
Every app has its own eCG Cloud. It is kept apart from every other app, including the other apps in your workspace.
The three parts
| Part | What it is | Example |
|---|---|---|
| eCG Data | The app's database. Tables of information the app keeps. | A list of orders, customers and stock counts |
| eCG Actions | Server functions. Small pieces of work the agent writes for your app. | Take a card payment, send a receipt, check a sign-in |
| Secrets | Keys that the app and its actions use. | A payment provider key, an email key |
You do not have to build any of this yourself. When you ask the agent for something that needs it, such as "save every order and email me a copy", the agent creates the tables, writes the actions and stores the keys it needs. You then look after it from your settings.
How the parts work together
Here is one order from a customer, step by step.
- Your customer opens your shop and picks a product.
- The page sends the order to an eCG Action.
- The action takes the payment through your payment provider, using a key kept in Secrets.
- The action saves the order, the customer and the stock count in eCG Data.
- The action emails the receipt. You see the order in your own dashboard.
The browser never sees your private keys. They stay on the server side, inside eCG Actions.
Where to find it
You can look at eCG Cloud in two places.
| Place | What you see |
|---|---|
| Cloud in the left sidebar, under Platform | Every app in the workspace on one page, with tabs for eCG Data and eCG Actions |
| Project settings, in the eCG Cloud group | One app only: Overview, eCG Data, eCG Actions and Secrets |
To reach the second place, open your project in the editor, open More actions, then Project settings. Under eCG Cloud in the left menu, choose a part. The gear icon in the editor toolbar and the database icon next to it open the same settings.
The Cloud page opens on eCG Data. At the top it shows three figures: how many apps have eCG Data, how many Need attention, and how many Projects without eCG Data. Select a figure to jump to the list. Use Refresh to load the latest state.
If you have white label switched on for your workspace, a third tab, Preview domain, also appears. See white label.
Turn eCG Cloud on for an app
Open Project settings, then eCG Cloud, then Overview. The top card tells you the state of this app's eCG Cloud.
| What the card says | What it means | What to do |
|---|---|---|
| eCG Cloud is not on for this app | The app has no data or actions yet. | Select Turn on eCG Cloud. This opens eCG Data, where you select Provision. |
| Turning on eCG Cloud | Setup is running. It takes a minute or two. | You can leave the page. Come back later. |
| eCG Cloud is on | The app has its own data and actions. | Nothing. The three tiles below show what is inside. |
| eCG Cloud did not turn on | Setup failed. Nothing was charged. | Select Try again. If it keeps failing, contact support. |
Below the card, three tiles show a count for each part, for example "3 tables", "2 actions" and "1 secret". Select a tile to open that part.
You can also turn it on from the Cloud page. Select Set up eCG Data, choose the app from the list, and then select Provision in its console. See eCG Data: your app's database.
What your plan includes
Each app's eCG Cloud is part of your plan. How many apps can have one, and what an extra one costs, are on the pricing page.
A new app starts without eCG Cloud until it is turned on. When your app needs somewhere to keep data, the agent can offer to turn it on for you in the chat.
Who can do what
| Task | Who can do it |
|---|---|
| See the list of apps and their state, open the Overview and Diagram | Anyone who can open the project, including view-only members |
| Read table rows, run changing SQL, download a backup, add or remove secrets | People who can edit the project |
| Turn eCG Cloud on or off, delete eCG Data | Workspace admins and billing admins |
| Ask the agent to create tables, actions and keys | People who can edit the project, from the editor chat |
Members whose only role is billing cannot load the eCG Actions list, because they do not see the workspace's apps. See members and roles.
When an app needs attention
The Cloud page puts the most urgent problem at the top, in a card:
| Card | Meaning | What to do |
|---|---|---|
| Needs attention with "[App] needs attention" | An app's eCG Data is in the error state. | Select Open console. It shows what happened and a Retry button. See eCG Data. |
| In progress with "[App] is being set up" | eCG Data is being created. | Wait a minute or two, then select Refresh. |
If more than one app needs attention, the card names one and says "and 2 more".
In the eCG Actions tab, a red number in Failed (24h) means an action failed in the last day. Open the app, select the action and read its recent runs. See eCG Actions.
Keep reading
- eCG Data: your app's database
- Browse tables and run queries
- eCG Actions: server functions
- Store keys and secrets safely
- Back up your data