Skip to content

vastde_logs_tail.md

Latest commit

 

History

History
96 lines (69 loc) · 3.3 KB

vastde_logs_tail.md

File metadata and controls

96 lines (69 loc) · 3.3 KB
title vastde logs tail
description Tail logs for a VAST DataEngine pipeline

vastde logs tail

Tail logs for a VAST DataEngine pipeline

Synopsis

Stream live logs from a pipeline and its functions in real-time.

This command continuously streams new log entries as they are generated by pipeline executions. Similar to 'tail -f' for files, it provides a live view of pipeline activity, making it ideal for:

  • Real-time monitoring during development
  • Debugging active pipelines
  • Observing function execution flow
  • Tracking events as they occur

The command polls the telemetry system at regular intervals (default: 5 seconds) and displays new log entries. Filtering options are the same as 'logs get':

  • --function: Filter by specific function
  • --severity: Filter by log level
  • --scope: Filter by scope (user, runtime)
  • --trace-id/--span-id: Filter by trace identifiers
  • --interval: Polling interval (default: 5s)
  • --limit: Initial number of historical logs to show (default: 100)

Press Ctrl+C to stop streaming. The tail command is particularly useful during pipeline deployments and when testing function changes, as it provides immediate feedback on execution behavior.

Usage

vastde logs tail <pipeline name>|<pipeline GUID> [options]

Examples

  # Tail logs in real-time for a pipeline
  vastde logs tail data-processing-pipeline

  # Tail logs for a specific function
  vastde logs tail my-pipeline --function image-processor

  # Tail only error logs
  vastde logs tail my-pipeline --severity ERROR

  # Tail logs with custom polling interval (10 seconds)
  vastde logs tail my-pipeline --interval 10s

  # Tail logs starting from a specific time
  vastde logs tail my-pipeline --start "2024-01-01T12:00:00Z"

  # Tail logs filtered by trace ID
  vastde logs tail my-pipeline --trace-id abc123-def456

  # Tail logs with limit on entries per poll
  vastde logs tail my-pipeline --limit 50 --interval 5s

Options

Command-specific options

Flag Type Description Default
-e, --end string Filter logs until this end time (e.g. '-5m', '2025-04-21T12:00:00Z')
-f, --function string Filter logs by function name or GUID
-i, --interval duration Polling interval for new logs (default 5s) 5s
-l, --limit int32 Maximum number of log records to return per poll 100
--scope string Filter logs by scope (user, runtime) user
--severity string Filter logs by severity (DEBUG, INFO, WARN, ERROR, CRITICAL)
-s, --since string Filter logs since this time ago (e.g. '10m', '2h', '2025-04-21T10:00:00Z') 0s
--span-id string Filter logs by span ID
--trace-id string Filter logs by trace ID

Global options

Flag Type Description Default
--dry-run bool Simulate the operation without making actual changes to the system
-o, --output string Output format: json, yaml, human human
--silent bool Suppress UI outputs, such as spinner and success messages
-v, --verbose int Verbosity level (0-9): 0=standard, 1=verbose, 2=detailed, 3=extended, 4=debug, 5=trace 0

See Also