Skip to main content

Vessel Logs#

Definition#

The Logs tab of a Vessel shows a list of each unique log of every Voyage or run that has occurred, alongside additional metadata and graphs around performance. By clicking on an ID or the Open action, you can view more information.

The graph on the Vessel Logs tab shows historical run durations trended out for all logs shown on the current page. The scorecards at the top give a high-level insight into how successfully your Vessel has been running historically.

Output#

The output section of an individual Vessel Log will show you:

  • Any environment variables that were set via the Requirements tab or via Blueprint Variable inputs.
  • If using a Git Connection, the commit hash of the code that was cloned.
  • Shipyard functionality, such as downloading your script and changing the current working directory.
  • Any data that your script printed to stdout.

Live Update#

If a log has a status of Scheduled or Running, the individual Log page will automatically refresh every few seconds to show:

  • Current Vessel Status
  • Current Duration
  • Live Output

While the Vessel is actively running, you can click Stop Voyage to immediately terminate the job.

Once the Vessel has finished running, the page will no longer automatically refresh.

Metadata#

NameDefinition
Vessel Log IDUUIDv4 associated with the individual Vessel run.
StatusThe last known information about a run.
TriggerWhat type of Trigger generated this log.
RetriesThe number of times the run was retried.
Exit CodeThe exit code that the script returned upon completion.
DurationThe total length of time that the Vessel ran for.
Start TimeThe timestamp of when the run started.
End TimeThe timestamp of when the run ended.

Screenshots#

Logs Tab for a Vessel

Individual Log for a Vessel

Additional Notes#

  1. Logs cannot currently be exported from Shipyard for analysis. If you need access to this data, reach out to support.
  2. The Log Output does not contain any information pertaining to the process of installing external package dependencies.
  3. The Live Update feature of the Log Output only updates every time there are 256 additional bytes of data. In some instances where very little data is sent to the output, it may look like the Vessel is not actually showing any new data.