pantheon-systems/terminus-node-logs-plugin

Terminus plugin for viewing nodejs logs

0.1.2 2025-09-04 20:11 UTC

README

Actively Maintained

[Terminus v4.x Compatible]

A plugin to access builds and runtime logs for Node.js sites on Pantheon. Though this plugin is written generically to report logs from build steps and containers running Node.js-based sites, Next.js is the only framework that Pantheon officially supports.

Configuration

These commands require no configuration

Usage

  • terminus node:logs:build:list [<site>.<env>]
  • terminus node:logs:build:get <site>.<env> <build_id> [<destination>]
  • terminus node:logs:runtime:get <site>.<env>

Installation

To install this plugin using Terminus 4:

terminus self:plugin:install terminus-node-logs-plugin

Build statuses

Builds may have the following statuses. Please note that a build is actually a two steps process: "Build" and "Deploy" as described in the following statuses table:

Status Description
BUILD_QUEUED A build process has been queued.
BUILD_WORKING A build process is currently in progress.
BUILD_FAILURE A build process has failed. See logs for details.
BUILD_SUCCESS A build process has succeeded. This status should not be that common as it should be almost immediately replaced by a DEPLOYMENT_* status.
DEPLOYMENT_QUEUED A deployment process has been queued.
DEPLOYMENT_WORKING A deployment process is currently in progress.
DEPLOYMENT_FAILURE A deployment process has failed.
DEPLOYMENT_SUCCESS A deployment process has succeeded.

Help

Run terminus help node:logs:build:list for help.