Skip to main content

Managing your data applications on Meroxa

Once you have a data app 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

Application logs

Use the meroxa app logs to view relevant logs to the state of the given Turbine Data Application.

$ meroxa app logs liveapp

function-960959 (function)
[2022-04-19T05:35:51Z] Received key:"{\"schema\":{\"type\":\"int32\",\"optional\":false},\"payload\":3}" value:"{\"payload\":{\"id\":3},\"schema\":{\"fields\":[{\"field\":\"id\",\"optional\":false,\"type\":\"int32\"}],\"name\":\"account\",\"optional\":false,\"type\":\"struct\"}}" timestamp:1658430032
[2022-04-19T05:35:51Z] Received key:"{\"schema\":{\"type\":\"int32\",\"optional\":false},\"payload\":4}" value:"{\"payload\":{\"id\":4},\"schema\":{\"fields\":[{\"field\":\"id\",\"optional\":false,\"type\":\"int32\"}],\"name\":\"account\",\"optional\":false,\"type\":\"struct\"}}" timestamp:1658430032
[2022-04-19T05:35:51Z] Received key:"{\"schema\":{\"type\":\"int32\",\"optional\":false},\"payload\":5}" value:"{\"payload\":{\"id\":5},\"schema\":{\"fields\":[{\"field\":\"id\",\"optional\":false,\"type\":\"int32\"}],\"name\":\"account\",\"optional\":false,\"type\":\"struct\"}}" timestamp:1658430032
[2022-04-19T05:35:51Z] panic: interface conversion: interface {} is nil, not string
[2022-04-19T05:35:51Z]
[2022-04-19T05:35:51Z] goroutine 8 [running]:
[2022-04-19T05:35:51Z] main.Anonymize.Process({}, {0xc000208540, 0x1, 0x1})
[2022-04-19T05:35:51Z] /go/src/app/app.go:75 +0x214
[2022-04-19T05:35:51Z] github.com/meroxa/turbine-go/platform.wrapFrameworkFunc.func1({0x0, 0x0}, 0xc00024fb00)
[2022-04-19T05:35:51Z] /go/src/app/vendor/github.com/meroxa/turbine-go/platform/server.go:72 +0x2f
[2022-04-19T05:35:51Z] github.com/meroxa/turbine-go/platform.ProtoWrapper.Process({0x40ae05}, {0x9dc6e0, 0xc00001ec30}, 0x40d100)
[2022-04-19T05:35:51Z] /go/src/app/vendor/github.com/meroxa/turbine-go/platform/server.go:27 +0x2f
[2022-04-19T05:35:51Z] github.com/meroxa/funtime/proto._Function_Process_Handler({0x8c2d80, 0xc000119b30}, {0x9dc6e0, 0xc00001ec30}, 0xc0000686c0, 0x0)
[2022-04-19T05:35:51Z] /go/src/app/vendor/github.com/meroxa/funtime/proto/service.pb.go:364 +0x170
[2022-04-19T05:35:51Z] google.golang.org/grpc.(*Server).processUnaryRPC(0xc000193340, {0x9e51b8, 0xc000194180}, 0xc000228120, 0xc0001b6ba0, 0xd1dd70, 0x0)
[2022-04-19T05:35:51Z] /go/src/app/vendor/google.golang.org/grpc/server.go:1282 +0xccf
[2022-04-19T05:35:51Z] google.golang.org/grpc.(*Server).handleStream(0xc000193340, {0x9e51b8, 0xc000194180}, 0xc000228120, 0x0)
[2022-04-19T05:35:51Z] /go/src/app/vendor/google.golang.org/grpc/server.go:1616 +0xa2a
[2022-04-19T05:35:51Z] google.golang.org/grpc.(*Server).serveStreams.func1.2()
[2022-04-19T05:35:51Z] /go/src/app/vendor/google.golang.org/grpc/server.go:921 +0x98
[2022-04-19T05:35:51Z] created by google.golang.org/grpc.(*Server).serveStreams.func1
[2022-04-19T05:35:51Z] /go/src/app/vendor/google.golang.org/grpc/server.go:919 +0x294
...

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 erroneous state. This could be due to any number of issues, including a resource issue or a malfunction of your code or dependencies.

Redeployment

Anytime you would like to update the logic of your Turbine Data Application, you can remove, edit and redeploy it.

Learn how to remove your Turbine Data Application from the Meroxa Platform and get your app ready for redeployment.

Once your app has been successfully deleted, you can make the desired changes in your Turbine Data Application from your text editor, commit your changes to Git and deploy again:

$ git add .
$ git commit -m "Update resource configuration"

1 file changed, 1 insertion(+), 1 deletion(-)
$ meroxa apps deploy
Checking for uncommitted changes...
✔ No uncommitted changes!
# ...