Inevitably, something goes wrong with your application. Nullstone provides 3 commands that will help you diagnose any issues and understand what your application is doing.
nullstone status command allows you to view the current status of your Nullstone application. This reports everything from infrastructure status to application version to load balancer health. Typically, you will want to run
nullstone status in watch mode using the
-w flag. Watch mode will continue to poll the status and automatically update your terminal when something changes.
> nullstone status -w node-hello-world dev Env: dev Infra: provisioned Version: 62d67b0b386ad6fcd433076e9e3b7fd56e750fe5 Deployments Created Status Running Desired Pending 2021-08-30 20:50:23.518 +0000 UTC PRIMARY 1 1 0 Load Balancers
You can omit the environment to view an overview of your app across all environments.
> nullstone status -w node-hello-world Env Infra Version Running Desired Pending dev provisioned 62d67b0b386ad6fcd433076e9e3b7fd56e750fe5 1 1 0 prod provisioned 62d67b0b386ad6fcd433076e9e3b7fd56e750fe5 1 1 0
nullstone logs command allows you to view logs of your Nullstone application. You can use the
-s flag to "start" looking for logs a duration ago from now. If you would like to watch all new logs as well, use
-t to tail the logs.
In this example, we look for logs starting 5 minutes ago and tailing
> nullstone logs -s '5m' -t node-hello-world dev Performing application command (Org=nullstone, App=node-hello-world, Stack=, Env=dev) Identifying log provider for app "node-hello-world" Retrieving log provider details for app "node-hello-world" region: "us-east-1" log group: "node-hello-world-kohxy" Querying logs starting 01 Sep 21 12:11 EDT Watching logs (poll interval = 1s) ...Application logs
Connect via SSH
Sometimes you want to connect to one of your application containers in order to run a command directly. The
nullstone ssh command will establish a shell connection to a container. If there is more than one container, the container selected is random.
$ nullstone ssh --app=node-hello-world --env=dev Performing application command (Org=nullstone, App=node-hello-world, Stack=, Env=dev) Identifying infrastructure for app "node-hello-world" fargate cluster: "arn:aws:ecs:us-east-1:522657839841:cluster/fargate1-ehmra" fargate service: "node-hello-world" repository image url: "522657839841.dkr.ecr.us-east-1.amazonaws.com/node-hello-world-xkjrz" Starting session with SessionId: ecs-execute-command-00b6391971b75c961 #