Warning

Nightly releases are generated automatically from the latest source code and are intended for experimental purposes only. These builds may contain incomplete or untested features, bugs, or security vulnerabilities, and as such, are not for production use. Users should be aware that nightly releases may cause unexpected behavior, data loss, or system instability. Use of these releases is at the user's own risk, and it is advised to have adequate backups before testing. The software is provided as is with no guarantees or support.

Admin UI

Introduction

The following contains a brief overview of the instant3Dhub Admin UI and it’s features. The Admin UI is a web-based interface that allows users to monitor some aspects of the instant3Dhub system, accessible via web browser under /admin/ui/.

Overview

The overview page shows the number of currently active jobs. During idle, this number should be zero. See the system overview section for a list of services, or Services below for more information.

Services

The services page breaks down the active jobs from the overview page into their respective services. This page shows the number of active jobs for each service.

Further job information can be accessed for each service by clicking on the DETAILS link.

Service Details

Each service works on queued jobs, processing them in the order they were requested. The details page groups jobs by their status, allowing log inspection of each job.

Jobs can have the following states:

  • Created: Soon to be queued.

  • Open: Queued for processing.

  • ClaimedForProcessing: Will be worked on next.

  • InProgress: Currently being processed.

  • Closed: Finished without error.

  • Warning: Finished with a warning.

  • Error: Finished with a fatal error.

  • ErrorTerminated: Crashed during processing.

  • ErrorRequestExpired: Failed to find a suitable worker in time.

  • ErrorNoLicense: Failed to find a license when starting this job.

  • ErrorInternal: Failed internally. Check Kubernetes Pod logs.

  • MarkedForDeletion: Will be deleted soon.

  • ErrorUnqueueable: Failed to find a suitable worker for this job.

In progress jobs can also be cancelled from this page.

Logs are not always available, the job will need to have started for it’s logs to be visible. This means only the following states will have logs available:

  • InProgress, Closed, Warning, Error, ErrorTerminated

Monitoring

The monitoring page provides links to the interfaces of several internal services:

  • Consul: The service discovery system.

  • RabbitMQ: Internally used message broker. Will need login credentials. Default credentials are i3dhub and 7F7dbMgFQjVshwzQ.

  • License Server: License usage statistics overview and manual usage export.

  • Prometheus: System for querying system metrics.

  • Jaeger: System for viewing request traces, useful for finding performance issues.

  • Debug Configuration: View internal configuration settings.

Downloads

Pre-packaged add-ons can be downloaded from this page. Currently, the only entry here is a link to an installable iOS App for instant3Dhub.

Tools

Provides a cache clear button. This is usually not necessary, but provides an easy way to reset the cache if needed.