Skip to main content

pull

inctl logs pull​

Fetches and downloads text logs for specified assets and time range.

Synopsis​

Fetches and downloads text logs for the given assets and time range into a single archive for download.

To specify multiple assets, you can use a comma-separated list or repeat the flag: --skill "skill1,skill2" --skill skill1 --skill skill2 --resource resource1 --resource resource2 --instance resource1/instance1 --instance resource2/instance2

Example: inctl logs pull --skill my-skill --workcell my-workcell --output_dir /tmp/logs inctl logs pull --resource my-resource --workcell my-workcell --start_time 2025-03-09T12:00:00Z --end_time 2025-03-16T12:00:00Z --output_dir /tmp/logs inctl logs pull --resource my-resource --instance my-resource/instance-1 --workcell my-workcell --output_dir /tmp/logs inctl logs pull --resource my-resource --instance my-resource/instance-1 --workcell my-workcell --output_dir /tmp/logs --filters "hello" "world" inctl logs pull --operation=<previous-operation-name> --output_dir /tmp/logs

inctl logs pull [flags]

Options​

      --end_time string     The end time of the logs to include (RFC3339 format).
      --filters strings     Additional regex filters to apply to the query.
  -h, --help                help for pull
      --instance strings    The instances of the resources to include (format: resource/instance).
      --operation string    Use this flag to reuse the operation name from a previous fetch command.
      --output_dir string   The directory to save the logs to.
      --resource strings    The names of the resources to include.
      --start_time string   The start time of the logs to include (RFC3339 format).
      --workcell string     The name of the workcell.

Options inherited from parent commands​

      --address string          The address of the cluster.
                                When not running the cluster on localhost, this should be the address of the relay
                                (e.g.: dns:///www.endpoints.&lt;gcp_project_name&gt;.cloud.goog:443).
                                Can be defined via the INTRINSIC_ADDRESS environment variable. (default "xfa.lan:17080")
      --debug                   (optional) Prints extensive debug messages
      --follow                  (optional) Whether to follow the solution logs.
      --onprem_address string   (optional) The onprem address (host:port) of the workcell. Used to circumvent the need of routing through the cloud, if the workcell is running in the same network as the inctl
      --org string              The Intrinsic organization to use. You can set the environment variable
                                	INTRINSIC_ORG=organization to set a default organization.
  -o, --output string           (optional) Output format. One of: (json, ndjson)
      --prefix_id               (optional) Prefix each log line with the asset ID, e.g., '[my-skill-id]'. Enabled for multiple targets are provided.
      --prefix_type             (optional) Prefix each log line with the asset type, e.g., '[Skill]' or '[Service]'.
      --print-trace             Print the trace identifier when exiting.
      --service strings         (optional) Indicates logs source is a service (or a list of services)
      --since string            (optional) Show logs starting since value. Value is either relative (e.g 10m) or 
                                date time in RFC3339 format (e.g: 2006-01-02T15:04:05Z07:00)
      --skill strings           (optional) Indicates logs source is a skill (or a list of skills)
      --solution string         Solution ID from which logs will be read.
                                Can be defined via the INTRINSIC_SOLUTION environment variable.
      --tail int                (optional) The number of recent log lines to display. An input number less than 0 shows all log lines. (default 10)
      --timeout string          (optional) Maximum time to wait to receive logs. (default "300s")
      --timestamps              (optional) Whether to include timestamps on each log line.

SEE ALSO​

  • inctl logs - Prints logs from skills or services in a given solution