> ## Documentation Index
> Fetch the complete documentation index at: https://hyrex.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring

> Monitor your Hyrex tasks and workflows with TypeScript

<Tabs>
  <Tab title="Hyrex Cloud">
    ## Hyrex Cloud Dashboard

    Access your monitoring dashboard at [hyrex.io/cloud](https://hyrex.io/cloud).
  </Tab>

  <Tab title="FOSS">
    ## Hyrex Studio

    Web UI for monitoring tasks and workflows.

    ### Start Studio

    ```bash theme={null}
    hyrex studio

    # Custom port
    hyrex studio --port 8080

    # Verbose logging
    hyrex studio --verbose
    ```

    Access at [https://local.hyrex.studio](https://local.hyrex.studio)

    ### Features

    * Task status and history
    * Queue depths
    * Worker health
    * Error tracking
    * Workflow visualization

    ## Environment Variables

    ```bash theme={null}
    # Required
    HYREX_DATABASE_URL=postgresql://user:pass@localhost/hyrex

    # Optional
    STUDIO_PORT=1337
    STUDIO_VERBOSE=true

    # Optional - Log Storage (FOSS only)
    HYREX_S3_LOG_BUCKET=your-bucket-name
    AWS_ACCESS_KEY_ID=your-access-key
    AWS_SECRET_ACCESS_KEY=your-secret-key
    AWS_REGION=us-east-1
    ```
  </Tab>
</Tabs>

## Task Logs

<Tabs>
  <Tab title="Hyrex Cloud">
    Task logs are automatically saved and accessible through the Hyrex Cloud dashboard. No additional configuration required - logs are managed by the Hyrex Cloud infrastructure.
  </Tab>

  <Tab title="Hyrex FOSS">
    Configure S3 storage to persist task logs:

    ```bash theme={null}
    # S3 bucket for log storage
    HYREX_S3_LOG_BUCKET=your-bucket-name

    # AWS credentials (required for S3 access)
    AWS_ACCESS_KEY_ID=your-access-key
    AWS_SECRET_ACCESS_KEY=your-secret-key
    AWS_REGION=us-east-1  # Optional, defaults to us-east-1
    ```

    Once configured, logs for each task execution will be automatically saved to the specified S3 bucket and accessible through Hyrex Studio.
  </Tab>
</Tabs>