3squaredcircles/atlas repository overview

⁠3SC Atlas

The FinOps Command Center for Your Cloud Infrastructure.

3SC Atlas is a cloud-agnostic discovery and visualization tool that provides engineering teams and leadership with a clear, actionable view of their cloud infrastructure's cost versus its actual utilization. It scans your cloud environment (Azure, AWS, GCP, Kubernetes), collects performance metrics, and generates simple, version-controlled JSON artifacts that provide a snapshot and analysis of your entire estate.

Unlike complex, finance-first FinOps platforms, Atlas is designed for engineers. It answers a simple, powerful question: "What infrastructure are we paying for, and how much of it are we actually using?"

Visit: https://docs.3squaredcircles.com⁠ for complete configuration options.

---

⁠For the Manager (VP, Director, FinOps Lead)

As a leader responsible for budget and efficiency, you need to ensure your cloud spend is delivering maximum value. Atlas provides a direct, quantifiable return on investment by translating abstract cloud bills into tangible utilization data.

Atlas answers your critical questions:

• "Are our multi-million dollar cloud budgets being spent efficiently, or are we paying for idle resources?"
• "Where is our biggest cloud waste, and which teams are responsible for it?"
• "How can we prove the ROI of our optimization efforts and track cost savings over time?"
• "How can we empower our engineering teams to take ownership of their own cloud costs?"

⁠Key Business Values:

• Quantify Cloud Waste: Atlas moves beyond simple cost reporting to show you the utilization of your provisioned resources. It highlights oversized VMs, idle databases, and underused Kubernetes clusters, providing a clear "hit list" for cost optimization.
• Drive Accountability: By generating a clear, visual map of the infrastructure, you can easily attribute costs and usage to specific teams, applications, or resource groups, fostering a culture of financial accountability.
• Track ROI Over Time: The atlas-stats.json snapshot is committed to Git with every run. This creates an auditable history of your cloud estate, allowing you to track the impact of optimization initiatives and demonstrate concrete cost savings month-over-month.
• Reduce Cloud Spend: By identifying specific, underutilized resources, Atlas enables targeted actions—like downsizing, scheduling shutdowns, or migrating to more efficient services—that can lead to immediate and significant reductions in your monthly cloud bill.

---

⁠For the Engineer & Architect

As an architect or developer, you need to understand the infrastructure that runs your code. Atlas provides an interactive, local UI to explore your cloud environment, understand its hierarchy, and identify optimization opportunities.

Atlas is your local command center for cloud infrastructure.

⁠Key Technical Values:

• Visualize Your Environment: See your entire cloud estate as an interactive graph showing the logical view of your infrastructure's hierarchy (e.g., Subscription > Resource Group > Virtual Machine).
• Instantly Spot Waste: The graph uses a simple, intuitive color-coding system to highlight utilization. This allows you to instantly spot an expensive, oversized VM that's running at 5% CPU or an idle database that can be downsized.
• Historical Performance Analysis: The interactive mode allows you to view a resource's performance history, helping you identify trends, validate optimization decisions, or make informed choices about scaling.
• Infrastructure as Documentation: The atlas-stats.json file provides a consistent, machine-readable, and version-controlled document of your infrastructure's state, which is invaluable for onboarding, planning, and disaster recovery.

---

⁠For the Platform Engineer (DevOps, SRE)

As an operator, you need tools that are secure, automatable, and consistent. Atlas is a containerized, self-hosted application designed for safe and seamless integration into any CI/CD pipeline.

Atlas is a predictable, read-only discovery agent.

⁠Execution Modes:

• execute The primary CI mode. It performs a read-only scan of your cloud environment, generates the analysis artifacts, and commits the state snapshot to Git.
• interactive: Starts a local web server to serve the interactive visualization UI for exploring an existing snapshot.
• serve-docs: Starts a local web server to serve this documentation in a readable HTML format.

⁠Produced Artifacts

Verifying Image Signatures All published images are signed with Cosign. To verify:

Install cosign: https://docs.sigstore.dev/cosign/system_config/installation/⁠ Download our public key: curl -O https://www.3squaredsquaredcircles.com/keys/3squaredcircles.pub⁠ Verify: cosign verify --key 3squaredcircles.pub 3squaredcircles/atlas:latest