Skip to main content

Managing your data applications on Meroxa

Once you have a data app or two successfully deployed, there are a few commands you will want to keep in mind when managing data apps in Meroxa going forward.

Describe Applications

Use the meroxa app describe for high-level information about a data app.

$ meroxa app describe liveapp

Name: liveapp
Language: javascript
Environment: common
UUID: ab011c9d-a5bc-1234-ab01-12ab34c8def5
Created At: 2022-01-01 22:22:22 +0000 UTC
Updated At: 2022-01-01 22:22:22 +0000 UTC
State: running

Use the meroxa app describe --extended for detailed information about a data app.

$ meroxa app describe liveapp --extended ff056b9e-e5dc-4099-ba09-87da49e8ffb0

Name: liveapp
Language: javascript
Environment: common
UUID: ab011c9d-a5bc-1234-ab01-12ab34c8def5
Created At: 2022-01-01 22:22:22 +0000 UTC
Updated At: 2022-01-01 22:22:22 +0000 UTC
State: running
Resources
prod_db
UUID: zyx432w1v-zy4xw-4321-zy43-65zy43w2vut1
Type: postgres
State: Ready
As: Source
prod_s3
UUID: zyx432w1v-zy4xw-4321-zy43-65zy43w2vut1
Type: redshift
State: Ready
As: Destination
Functions
anonymize
UUID: zyx432w1v-zy4xw-4321-zy43-65zy43w2vut1
State: ready

List Applications

Use the meroxa app list command to list existing data apps on your account.

$ meroxa app list

ID NAME LANGUAGE STATE
====== ======================= ============ ==========
584 liveapp javascript running
2980 fooapp golang degraded
3095 barapp python running

Application States

Monitor the state of your existing data apps in the Meroxa Dashboard or the CLI using meroxa app describe.

The state itself is descriptive of whether your application is operational and in a healthy state. The states are as follows:

Running

The running state indicates that your data app build was successful and is operational and in a healthy state.

Degraded

The degraded state indicates that app is no longer operational and in a errornous state. This could be due to any number of issues, including a resource issue or a malfunction of your code or dependencies.

Update Applications

Use the meroxa app update command to edit the name of your data app.

$ meroxa app update liveapp --name awesome_app

Updating app "liveapp"...
App "awesome_app" is successfully updated!

Remove Applications

Use the meroxa app remove command to remove your data app from the Meroxa Platform.

$ meroxa app remove liveapp

To proceed, type "liveapp" or re-run this command with --force
▸ liveapp
Removing app "liveapp"...
App "liveapp" successfully removed