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.

Guide: running instant3Dhub with Grafana

Read First

This section explains how to enable Grafana for instant3Dhub. As Grafana uses AGPL it is not directly packaged with a regular installation. Grafana serves as a tracing and debugging tool to diagnose functional or performance issues.

instant3Dhub configuration

The Grafana image is not hosted on the Threedy image repository. The official docker image hosted on docker.io is used by default. In order to copy the image to a local registry, the following script can transfer the image to your repository via docker:

docker pull docker.io/grafana/grafana:9.1.6
docker image docker.io/grafana/grafana:9.1.6 ${TARGET_IMAGE_REGISTRY_HOST}/grafana/grafana:9.1.6
docker push ${TARGET_IMAGE_REGISTRY_HOST}/grafana/grafana:9.1.6

Grafana is disabled by default. The following options must be set in values.yaml to enable Grafana support:

# Controls third party system tracing and logging.
tracing:

  # Options for deploying services required for integrated tracing and metrics
  # dashboards.
  withIntegrated:

    # Whether this option is enabled. This does not include Grafana. Metrics
    # must be manually explored via the Prometheus GUI. Traces must be manually
    # explored via the Jaeger GUI.
    enabled: true

    # Settings for deploying Grafana.
    grafana:

      # Whether grafana should be enabled. This also deploys dashboards detailing
      # system performance regarding transcoding, service runtimes, error rates
      # and memory usage. Additionally, metrics are linked to traces to allow
      # detailed inspection of internals for given metrics.
      enabled: true

      # Which Grafana image to use. The image is not hosted on the Threedy registry
      # as it is AGPL licensed.
      image: docker.io/grafana/grafana:9.1.6

Or, alternatively, via Helm

# helm chart parameter
helm install --set tracing.withIntegrated.enabled=true --set tracing.withIntegrated.grafana.enabled=true ...