astronomer-orbis 0.9.1

A tool for generating astronomer software deployment compute reports

Orbis

Orbis is a diagnostic and reporting tool for Astro Private Cloud (formerly Astronomer Software). It collects support bundles from Kubernetes clusters and generates deployment compute reports.

Key Features

1. Report Generation — Deployment metrics analysis including CPU usage, memory consumption, resource allocation, task success/failure rates, processing trends, and execution latency. Outputs DOCX, CSV, and JSON reports.
2. Diagnostic Scanner — Creates support bundles containing Kubernetes cluster information, Astronomer deployment details, logs, and configurations. Supports CP/DP multi-cluster collection, session management, and incremental resume workflows.

Quick Start

Report Generation

echo "ASTRO_SOFTWARE_API_TOKEN=<your-token>" > .env && mkdir -p output
podman run --rm -it \
  --env-file .env \
  -v $(pwd)/output:/app/output \
  quay.io/astronomer/orbis:0.9.0 \
  reporting \
  -s <start-date> \
  -e <end-date> \
  -b <base-domain>

Or install locally:

pip install astronomer-orbis
export ASTRO_SOFTWARE_API_TOKEN=<your-token>
orbis reporting -s <start-date> -e <end-date> -b <base-domain>

Diagnostic Scanner

podman run --rm -it \
  -e ASTRO_SOFTWARE_API_TOKEN=<your-token> \
  -v <path-to-kubeconfig>:/tmp/kubeconfig:ro \
  -v $(pwd)/output:/app/output \
  quay.io/astronomer/orbis:0.9.0 \
  scanner create \
  -n <platform-namespace> \
  --kubeconfig /tmp/kubeconfig \
  --image quay.io/astronomer/orbis:0.9.0

Installation

Install with uv (recommended for CLI tools):

uv tool install astronomer-orbis

Or with pip:

pip install astronomer-orbis

Documentation

Full documentation is available at https://astronomer.github.io/orbis-docs/

• Install Orbis
• Generate a compute report
• Create a support bundle
• Multi-cluster guide
• Changelog

License

Copyright (c) 2021 Astronomer, LLC