Runlogs track the progress, status, and results of each script you run on your servers. Whether you’re executing a single script or orchestrating a complex workflow with a Script Playlist, Runlogs provide valuable insights into your automation activities.

Understanding Runlogs

  • What is a Runlog? A Runlog is a record of a specific script execution instance. It includes details about the server, script (or script playlist), variable group (if used), start time, end time, status, and output.
  • Statuses: Runlogs can have the following statuses:
    • Enqueued: The Runlog is queued and awaiting execution.
    • Running: The script is currently being executed on the server.
    • Finished: The script execution completed successfully.
    • Failed: The script encountered an error and did not complete successfully.
    • Awaiting: The Runlog is executing a Script Playlist and is waiting for one of the script in the playlist to finish.

Creating a Runlog

  1. Navigate to “Runlogs”: Click on the “Runlogs” tab in the CloudRay interface.
  2. Click “New Runlog”: This opens the Runlog creation form.
  3. Enter Details:
    • Server: Select the server where you want to run the script or playlist.
    • Script: Choose either a single script or a script playlist to execute.
    • Variable Group (Optional): If your script uses variables, select the appropriate variable group.
  4. Click “Create Runlog”: CloudRay will queue the Runlog for execution.

Viewing and Managing Runlogs

  • Runlog List: The “Runlogs” page displays a list of all your Runlogs, along with their status, server, script, and start time.
  • View Runlog Details: Click on a Runlog to view detailed information, including:
    • Status: Current execution status.
    • Server: The target server.
    • Script/Script Playlist: The executed script or playlist.
    • Variable Group: The associated variable group (if any).
    • Start Time/End Time: Time stamps for execution start and completion.
    • Output: The console output generated by the script.
  • Filter and Search: Use the filters and search bar to find specific Runlogs.

Important Notes:

  • Queueing: CloudRay executes Runlogs sequentially for each server. If a Runlog is already running on a server, new Runlogs for that server will be queued.
  • Concurrent Execution: To run multiple Runlogs concurrently, use different servers.
  • Error Handling: Refer to the script’s output in the Runlog to diagnose and fix errors.
  • Log Retention: CloudRay retains Runlog data for a specified period (see your plan details).