Read a service's logs

Follow a service's build and runtime logs live, search and filter them, and download them.

Follow the log

  1. Open the service in the console, press ⌘K and choose Go to › Logs.

    The log is live, with the lines of every replica as they arrive.

    With the CLI:

    Terminal
    ghaym cloud services logs web
  2. Type in Search the lines to search, and pick a Level to filter: Error, Warning, Info or Debug.

    While the log is live, a search reaches the last hour.

  3. Choose Pause to hold the lines in place, and Resume to follow again.

If the service isn't running (asleep, stopped or never deployed), the CLI exits. Add -f to wait instead: when a request wakes a sleeping service, its first lines show up.

Read an earlier range

Pick a Range: 15 minutes, 1 hour, 24 hours, 7 days or Custom. How far back you can go depends on your plan: the log says how many hours your plan keeps.

Read a deploy's build log

Press ⌘K, choose Go to › All deploys and open a deploy. Its Log has three phases: Build, Run and App output. It opens on the phase that failed, so a failed build shows its first red line. Copy log copies all three phases once the deploy settles. The CLI streams a deploy's build and runtime logs by its ID:

Terminal
ghaym cloud deployments list --service web
ghaym cloud deployments logs <deployment-id> -f

Download the log

Choose Download in the log's head, or press ⌘K and choose Go to › Download logs. It saves what the log shows, with your filters applied.