Skip to main content
Metoro 10.3.0 is a minor release in the 10.x on-premises line. It keeps the 10.x Helm values API, so existing 10.2.0 values files can be reused without migration. No ClickHouse reset, PostgreSQL migration, Temporal migration, or datastore maintenance step is required for this upgrade.
Hub commands assume the Helm release is named metoro and runs in the metoro-hub namespace. Monitored-cluster exporter commands assume the Helm release is named metoro-exporter and runs in the metoro namespace. Adjust release names and namespaces if your installation uses different values.

Upgrade The Hub

Start from the values file used for the existing hub release. If you do not have it locally, export the user-supplied Helm values:
Upgrade the hub chart to 10.3.0:

Check The Hub Rollout

Check the hub Helm release and workloads:
If hub self-monitoring is enabled, check the bundled exporter rollout too:
If Metoro AI is enabled, check the Agent Sandbox components:

Upgrade Monitored-Cluster Exporters

Upgrading the hub repins future onboarding commands, but it does not automatically upgrade exporter releases already installed on monitored clusters. Repeat this section for every monitored cluster that has metoro-exporter-onprem installed. Start from the values file used for the existing exporter release in the monitored cluster. If you do not have it locally, export the user-supplied Helm values:
Upgrade the exporter chart to 10.3.0:

Check Monitored-Cluster Rollouts

After upgrading each monitored cluster, check the exporter Helm release and workloads:
If ServiceMonitor scraping is enabled, check the collector and target allocator rollouts too:
Use the release name and namespace from the existing exporter installation if they differ from the defaults above. Expected outcome:
  • Apiserver and Ingester roll to the 10.3.0 images.
  • Hub self-monitoring rolls to the 10.3.0 exporter chart and images when enabled.
  • Existing monitored-cluster exporter releases roll to the 10.3.0 exporter chart and images after their Helm upgrades.
  • Metoro AI hubs have Agent Sandbox controller, router, and Guardian runner defaults available when ai.enabled=true.
  • Existing PostgreSQL, ClickHouse, Temporal, and telemetry data remain in place.
  • Future monitored-cluster onboarding commands reference metoro-exporter-onprem 10.3.0.