Panoptes Docs · v2.0

Product Documentation

Learn how to connect your cloud accounts, monitor costs, detect security issues, and manage your team — all from one unified dashboard.

What is Panoptes?

Panoptes is a multi-cloud observability and management platform for engineering and FinOps teams. It connects to your AWS, GCP, and Azure accounts using either read-only (monitoring) or limited read-write (monitoring + VM actions) IAM permissions — your choice.

Unified Inventory

See all VMs, storage, and K8s pods across every cloud in one list

Cost Optimization

Automatically finds idle resources and overprovisioned instances

IaC Drift Detection

Compares your live cloud against your Terraform state files

Security Scanning

Detects public buckets, open ports, unencrypted volumes

Kubernetes Hub

Observe pods, nodes, and deployments across EKS, GKE, AKS

AI Copilot

Ask your cloud questions in plain English

ℹ

Panoptes never auto-modifies your infrastructure. VM actions (start/stop/restart) only execute when you explicitly click the button — and only if your IAM role includes the specific action permissions listed below.

Quick Start

Get your first cloud account connected and see live data in under 5 minutes.

1
Create your free account

Go to panoptes.software/register — no credit card needed. Your organization workspace is created automatically.

2
Connect a cloud account

Go to Settings → Cloud Accounts → Add Account. Choose your provider (AWS, GCP, or Azure) and follow the IAM setup wizard.

3
Wait for the first sync

Panoptes fetches your resources and cost data. This takes 30–90 seconds for a typical account with 50–200 resources.

4
Explore your dashboard

Your Overview shows total resources, monthly spend, security score, and AI-powered cost insights right away.

ℹ

First sync may take up to 2 minutes for large accounts (>500 resources) as all cost history is fetched.

Connect Cloud Accounts

Panoptes connects to your cloud providers using IAM roles. Your credentials are encrypted at rest with AES-256 and are never logged or transmitted externally. There are two permission tiers depending on what you need:

ModeWhat you getIAM required
ObserverInventory, costs, security scanning, IaC drift, K8s view, AI Copilot — all read operationsRead-only role only
ManagerEverything in Observer + VM start / stop / restart from the dashboardRead-only + specific action permissions

Observer mode — read-only IAM (minimum required)

AWSSecurityAudit

AWS Console → IAM → Roles → Create Role → Attach SecurityAudit managed policy

GCPViewer

GCP Console → IAM & Admin → IAM → Grant principal → Viewer role

AZUREReader

Azure Portal → Subscriptions → Access Control (IAM) → Add Role Assignment → Reader

Manager mode — additional action permissions for VM control

If you want to start, stop, or restart VMs directly from the Panoptes dashboard, add these specific action permissions on top of the read-only role:

AWS — additional inline policy
ec2:StartInstances
ec2:StopInstances
ec2:RebootInstances
GCP — additional role
roles/compute.instanceAdmin.v1
(or custom role with compute.instances.start / stop / reset)
Azure — additional role
Virtual Machine Contributor
(or custom role with start / powerOff / restart actions)
⚠

Panoptes never auto-starts or auto-stops VMs. Actions only run when you explicitly click Start / Stop / Restart in the dashboard. Without action permissions, the buttons are still visible but will return a permission error.

Adding an account

1
Go to Settings → Cloud Accounts

Click 'Add Account' in the top right corner of the Cloud Accounts page.

2
Choose your provider

Select AWS, GCP, or Azure. The form will show exactly which credentials are required.

3
Enter your credentials

For AWS: Role ARN + region. For GCP: Service Account JSON key. For Azure: Tenant ID + Client ID + Client Secret + Subscription ID.

4
Verify & save

Panoptes tests the connection before saving. If the credentials are wrong, you'll see a specific error message.

⚠

Never paste credentials from a production admin account. Always create a dedicated read-only IAM role specifically for Panoptes.

Cloud Inventory

The Inventory page shows every resource across all connected accounts in a single, searchable list. Resources are synced automatically every 30 minutes, or you can trigger a manual sync anytime.

What's included

EC2, RDS, S3, Lambda, ELB, EBS
Compute Engine, Cloud SQL, GCS, GKE
VMs, Blob Storage, AKS, Azure SQL
Pods, Deployments, Nodes, Services

Filtering & search

Use the filter bar to narrow by provider, region, resource type, status (running/stopped/idle), or tag. The search box does full-text matching on resource names and IDs.

Manual sync

Click the sync icon next to any cloud account in Settings → Cloud Accounts to trigger an immediate refresh. Per-account syncs take 10–30 seconds.

Billing & Forecasts

Track your cloud spend across AWS, GCP, and Azure in a unified dashboard. Panoptes breaks down costs by service, region, and custom tags.

Cost by Service & Trends

View your daily and monthly spend trends. The dashboard automatically categorizes costs (Compute, Storage, Database, Networking) so you can easily spot where your money is going.

Predictive Forecasting

Panoptes uses historical spend data to forecast your end-of-month bill, helping you avoid budget overruns before they happen.

Exporting Data

Almost all tables in Panoptes (including Billing, Resources, and Optimization) feature an "Export to Excel/CSV" button. This generates a structured, VIP-styled XML Spreadsheet ready for financial reporting.

FinOps & Cost Optimization

Panoptes's FinOps engine automatically scans your cloud accounts for waste and generates actionable recommendations. No manual configuration required — it runs on every sync.

Types of recommendations

Idle VMs

Instances with < 5% CPU for 7+ days. Safe to stop or resize.

Overprovisioned instances

Instances consistently using < 20% of allocated memory/CPU.

Orphaned storage

Unattached EBS volumes, unused GCS buckets, empty Azure disks.

Missing tags

Resources without required tags (env, team, cost-center) for cost allocation.

Excel FinOps report

Export a board-ready Excel report from the Optimization page. The report includes color-coded severity levels, per-account cost breakdowns, and month-over-month trend charts — formatted for CFO review.

✓

Panoptes never automatically stops or deletes resources. All recommendations are advisory — you act on them manually or approve them one by one.

IaC Drift Detection

Upload your Terraform .tfstate files and Panoptes continuously compares your declared infrastructure against what's actually running in your cloud accounts.

How to upload a state file

1
Go to IaC Drift

Navigate to IaC Drift in the sidebar.

2
Upload your .tfstate

Click 'Upload State File' and paste or upload your terraform.tfstate JSON, or point to an S3/GCS/Azure Blob backend URL.

3
Run a drift check

Panoptes compares every resource in the state file against live provider data. Results show within seconds.

Understanding drift results

Each drift finding shows the resource, the field that changed, the declared vs actual value, and a suggested remediation. Severity is HIGH for security-relevant changes (e.g. security group CIDR), MEDIUM for config drift, LOW for tag/label differences.

⚠

Panoptes cannot auto-remediate drift — it can only show you what changed. Apply fixes through your Terraform workflow.

Security Scanning

Panoptes runs automated CSPM (Cloud Security Posture Management) scans across all connected accounts. Your security score (A–F) is calculated from the severity and count of open findings.

What is scanned

Public S3 / GCS bucketsCRITICAL
Open SSH / RDP to 0.0.0.0/0CRITICAL
Unencrypted EBS / disksHIGH
Root account active access keysHIGH
MFA not enabled on IAM usersMEDIUM
Resources without required tagsLOW

Security score

Your score is calculated as: 100 − (critical×10 + high×5 + medium×2 + low×0.5), capped at 0. Grade A = 90+, B = 75–89, C = 60–74, D = 45–59, F = below 45.

Kubernetes

Panoptes connects to EKS, GKE, and AKS clusters via your kubeconfig. It provides a read-only view of pods, nodes, and deployments across all clusters in one place.

Connecting a cluster

1
Go to Settings → Kubernetes Clusters

Click 'Add Cluster' and choose your cluster type (EKS / GKE / AKS).

2
Paste your kubeconfig

Paste the kubeconfig YAML for the cluster. Panoptes validates the format and tests the connection before saving.

3
Browse pods and nodes

Go to the Kubernetes page to see all pods, node pressure metrics, and deployment status in real time.

Live Metrics (CPU & RAM)

Panoptes integrates natively with your cluster's Metrics Server. You can monitor live CPU and Memory (RAM) utilization for every Node and Pod. If a node crosses 80% utilization, Panoptes flags it with a capacity warning.

Pod logs & Scaling

Click any pod in the Kubernetes view to tail its last 100 lines of logs directly in the browser. You can also easily Scale Up or Scale Down your Deployment replicas directly from the dashboard.

ℹ

Panoptes requires proper RBAC permissions in your kubeconfig to read metrics and scale deployments. However, it cannot exec into pods or delete core cluster workloads.

AI Cloud Copilot

The AI Copilot answers natural language questions about your cloud — costs, resource counts, drift findings, and anomalies — using your own live data as context.

Example questions you can ask

Which of my accounts had the highest cost increase this month?
How many idle VMs do I have across all providers?
What are my top 3 most expensive services in AWS?
Are there any critical security findings I should fix today?
What is my current monthly spend trend vs last month?

Privacy

The AI analyzes only sanitized metadata from your Panoptes dashboard — resource counts, spend figures, region labels. Your raw credentials, application code, and actual cloud resource contents are never sent to the AI model.

ℹ

AI Copilot requires a Groq API key configured by your workspace admin under Settings → AI Configuration.

Alerts & Anomalies

Panoptes monitors your cloud spend and notifies you when thresholds are breached or unusual patterns are detected.

Budget alerts

Set a monthly spend threshold (e.g. $2,500/month). When your total cloud bill crosses that amount, you get an in-dashboard alert. You can set separate thresholds per provider.

Anomaly detection

Panoptes compares your current month's spend against the previous 3 months. If any service spikes more than 30% above its baseline, an anomaly finding is created automatically — no configuration needed.

Slack & Webhook Integrations

Receive instant notifications for high severity security drift, cost anomalies, or manual action requests. Navigate to Settings → Notifications to configure custom Slack channels or arbitrary JSON webhooks.

Reports & Automation

Panoptes allows you to automate repetitive tasks and generate high-level summaries for stakeholders.

Executive Reports

Generate a comprehensive, board-ready executive summary encompassing your global cloud spend, security posture, and infrastructure drift. These reports can be exported to styled Excel files for offline review.

Scheduled Jobs

Configure recurring cron schedules to automatically trigger cloud account syncs, Kubernetes metric pulls, or security scans during off-peak hours.

Team & Roles

Panoptes uses organization-based multi-tenancy. Every user belongs to exactly one organization and has one role.

Roles

RoleCan do
OwnerEverything — billing, team management, connect/remove accounts
AdminAll features except billing and removing the owner
MemberView all data, trigger syncs, manage alerts and schedules
ViewerRead-only access to all dashboards — no mutations

Inviting teammates

Go to Settings → Team → Invite Member. Enter the email and choose a role. The invitee receives a link to register and is automatically added to your organization.

Settings & Security

Two-factor authentication (2FA)

Enable TOTP-based 2FA from Settings → Security. Scan the QR code with any authenticator app (Google Authenticator, Authy, 1Password). Each login will require a 6-digit code.

Password management

Change your password from Settings → Security → Change Password. Panoptes uses bcrypt hashing — passwords are never stored in plaintext.

Credential vault

All cloud provider credentials are encrypted at rest with AES-256-GCM before being stored in the database. The encryption key is rotated automatically. Credentials are never returned in any API response.

Audit Logs (SOC 2 Ready)

Panoptes maintains a detailed, immutable audit log of all organizational activity. This includes user logins, password changes, infra state uploads, and credential modifications. Pro and Enterprise teams can export this log as CSV/Excel for compliance reporting.

✓

Enable 2FA before inviting team members to ensure your organization meets SOC 2 baseline requirements.

Ready to get started?

Connect your first cloud account in under 5 minutes. Free forever, no credit card.