aws-doctor

Uno strumento da terminale che funge da check-up completo per i tuoi account AWS. Costruito con Golang, aws-doctor diagnostica anomalie di costo, rileva risorse inutilizzate e fornisce un'analisi proattiva della tua infrastruttura cloud.

[!TIP] Visualizza la documentazione completa, la guida ai permessi e gli esempi di utilizzo su awsdoctor.compacompila.com

👀 Sguardo veloce

⚖️ Analisi comparativa dei costi

📈 Analisi delle tendenze su 6 mesi

🧟 Rilevamento degli sprechi

Supporta la scansione selettiva: aws-doctor waste ec2 s3 cloudwatch rds vpc lambda sagemaker elb ecr secrets-manager iam

• Interfaccia utente interattiva nel terminale: Naviga facilmente tra le categorie di spreco rilevate usando i tasti freccia o tab, con una vista Riepilogo aggregata.
• Degradazione graduale: Eseguito in CI/CD? aws-doctor rileva automaticamente se l'output è reindirizzato ed esegue il fallback a tabelle statiche.

📄 Report professionali

aws-doctor può ora generare report PDF dettagliati e professionali pronti per gli stakeholder. I report includono intestazioni personalizzate, tabelle formattate e analisi complete di costi/sprechi.

[!TIP] Visualizza esempi di report PDF e dettagli su awsdoctor.compacompila.com/docs/reporting/

Generare un report di confronto costi

aws-doctor report cost

Generare un report di analisi degli sprechi

# Report completo degli sprechi
aws-doctor report waste

# Controlli selettivi (ad es. solo ec2, s3 e lambda)
aws-doctor report waste ec2 s3 lambda sagemaker

Generare un report di tendenza

# Report completo delle tendenze (tutti i servizi)
aws-doctor report trend

# Servizi selettivi (ad es. solo ec2 e rds)
aws-doctor report trend ec2 rds

[!TIP] Argomenti dei sottocomandi: Come per i comandi da terminale, report waste accetta controlli specifici (ad es. ec2, s3, rds, lambda) e report trend accetta nomi di servizi specifici.

[!TIP] Per impostazione predefinita, i report vengono salvati nella cartella Documenti. Usa il flag --path per specificare una directory o un nome file personalizzato: aws-doctor report cost --path ./analisi-costi.pdf

🚀 Installazione

Homebrew (macOS/Linux):

brew install elC0mpa/homebrew-tap/aws-doctor

Script one-liner (macOS/Linux):

curl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.ps1 | iex

Usando Go:

go install github.com/elC0mpa/aws-doctor@latest

✨ Caratteristiche principali

• 📄 Report PDF professionali: Genera documenti PDF brandizzati e pronti per la condivisione per costi, tendenze e analisi degli sprechi.
• 📉 Confronto equo dei costi: Confronta finestre temporali identiche tra mesi diversi per individuare anomalie reali.
• 🧟 Scoperta di risorse "zombie": Scansiona alla ricerca di EIP inutilizzati, istanze ferme, istanze EC2 in esecuzione ma inattive, snapshot orfani, istanze RDS inattive, NAT Gateway inattivi, Load Balancer inattivi, memoria Lambda sovradimensionata, endpoint SageMaker di inferenza in tempo reale inattivi, repository ECR con immagini senza tag, policy del ciclo di vita mancanti o nessuna immagine, segreti Secrets Manager non utilizzati e utenti IAM o account Root senza MFA. Supporta il filtraggio selettivo dei servizi (ec2, s3, elb, cloudwatch, rds, vpc, lambda, sagemaker, ecr, secrets-manager, iam).
• 📊 Tendenze su 6 mesi: Visualizzazione ANSI ad alta fedeltà della velocità di spesa.
• 📤 Formati di output multipli: Esporta i risultati in table, json o csv per una facile integrazione con altri strumenti o report.
• 🔔 Notifiche di aggiornamento: Controlla automaticamente la presenza di nuove versioni in background e ti avvisa dopo l'esecuzione del comando.
• 🚀 Caching efficiente: Utilizza un servizio di cache locale per minimizzare le chiamate di rete ridondanti. Attualmente utilizzato per le notifiche di controllo versione (TTL di 2 ore) e in programma per l'espansione ai dati sui prezzi e altri flussi pesanti.
• 🔐 Pronto per MFA: Supporto nativo per profili che richiedono l'autenticazione multi-fattore.
• 🌍 Prezzi basati sulla regione: Interroga l'API dei prezzi AWS all'avvio per utilizzare le tariffe della regione configurata, con fallback ai valori predefiniti di us-east-1 se l'API non è disponibile. Richiede pricing:GetProducts nella policy IAM del chiamante; in sua assenza, le stime utilizzano silenziosamente i valori predefiniti.

💡 Motivazione

In qualità di Cloud Architect, ho spesso bisogno di controllare i costi e le informazioni di fatturazione AWS. Mentre la Console AWS fornisce dati grezzi, manca del contesto immediato necessario per rispondere alla domanda: "Stiamo spendendo in modo efficiente?"

Ho creato *aws-doctor* per colmare questa lacuna. Non si limita a mostrare la fattura; funge da strumento diagnostico che aiuta a capire *dove* stanno andando i soldi e *cosa* può essere ripulito. Automatizza i controlli di routine che eseguivo manualmente, offrendo un'alternativa gratuita e open source alle raccomandazioni a pagamento di AWS Trusted Advisor.

👥 Comunità

Collaboratori

Un enorme ringraziamento a tutti coloro che hanno contribuito a aws-doctor! Il vostro aiuto rende questo strumento migliore per tutti.

Storico delle stelle