View a markdown version of this page

Analizza le best practice con l'abilità managing-amazon-msk - Amazon Managed Streaming per Apache Kafka
FunzionalitàCome funzionaInstallazioneCasi d'uso ed esempiCodice sorgente e contributi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Analizza le best practice con l'abilità managing-amazon-msk

La managing-amazon-msk skill è una skill open source disponibile sul sito Agent Skills e disponibile in Agent Toolkit on, GitHub che fornisce competenze di dominio per la gestione dei cluster Amazon MSK AWS Provisioned. Dopo aver installato la skill in un agente di codifica MCP-compatible AI (ad esempioKiro,, e altri) CursorClaude Code, la skill consente all'agente AI di aiutarti a valutare il cluster e i clienti rispetto alle best practice, diagnosticare problemi operativi e implementare le configurazioni consigliate per broker e clienti Standard ed Express. Kafka L'abilità codifica la conoscenza MSK-specific operativa che i modelli di intelligenza artificiale generici spesso si applicano erroneamente o omettono.

Funzionalità

La competenza copre le seguenti aree, ognuna delle quali si basa sulle migliori pratiche documentate in questa guida.

Area delle migliori pratiche Cosa ti aiuta a fare l'abilità
1 Le migliori pratiche per i broker Standard(Standard) Valuta il numero di partizioni per broker, consiglia le dimensioni delle istanze, valuta num.io.threads e num.network.threads ottimizza le istanze m5.4xl+ e m7g.4xl+
2 Le migliori pratiche per i broker Express(Express) Calcola il numero di broker richiesto in base ai limiti di throughput per broker, consiglia i tipi di istanze Express come destinazione ingress/egress, valuta il numero delle partizioni rispetto alle quote Express
3 Monitoraggio dell'utilizzo della CPU Diagnostica la saturazione delle risorse del broker, distingui tra le cause principali e gli errori di configurazione a livello di broker e client e determina quando è necessario scalare
4 Monitoraggio dello spazio su disco Valuta l'utilizzo dello storage per i broker Standard, identifica gli argomenti ad alta crescita, consiglia l'espansione o le modifiche alla fidelizzazione di EBS. Per Express, monitora l'utilizzo dello storage (lo storage è completamente gestito) per l'ottimizzazione dei costi
5 Connect a un cluster Amazon MSK Provisioned Verifica producer/consumer le impostazioni, configura l'autenticazione, ottimizza l'alta disponibilità e la tolleranza ai guasti
6 Creazione di cluster a disponibilità elevata Verifica le configurazioni ad alta disponibilità e l'implementazione Multi-AZ per i broker Standard e la configurazione di failover del client
7 Monitora un cluster Amazon MSK Provisioned Crea CloudWatch dashboard e allarmi per le metriche chiave fondamentali per l'osservabilità e le operazioni di Amazon MSK
8 Caratteristiche e concetti chiave di Amazon MSK Valuta la disponibilità del cluster per gli aggiornamenti, comprendi il comportamento di applicazione delle patch tra Standard ed Express, comprendi l'impatto del riavvio dei broker sui clienti

Come funziona

Quando fai al tuo agente di codifica AI una domanda su Amazon MSK, ad esempio «Perché la CPU del mio cluster MSK è alta?» o «Aiutami a configurare il monitoraggio per il mio cluster Express»: la skill si attiva e fornisce all'agente:

  • Flussi di lavoro diagnostici: procedure strutturate per la risoluzione dei problemi che consentono di individuare innanzitutto le cause principali più probabili (ad esempio, linger.ms verificandole prima di consigliare la scalabilità del broker per i problemi relativi alla CPU).

  • Broker-type-aware guida: l'abilità determina se il cluster utilizza broker Standard o Express e applica le metriche, le soglie e i consigli corretti per quel tipo di broker.

  • AWS Comandi CLI: Ready-to-run comandi per descrivere i cluster, espandere lo storage, creare configurazioni e interrogare le metriche. CloudWatch

  • Convalida delle best practice: verifica la configurazione del cluster rispetto a raccomandazioni documentate e contrassegna le deviazioni.

Installazione

Opzione 1: AWS CLI

Richiede la versione AWS CLI 2.35.0 o successiva.

# Interactive setup (installs default skills + configures AWS MCP Server)
aws configure agent-toolkit

# Or install the skill individually
aws agent-toolkit add-skill --skill-name managing-amazon-msk

Per la documentazione completa della CLI, vedi Gestire le competenze con la CLI. AWS

Opzione 2: AWS Server MCP

Collega il tuo agente di codifica AI al server AWS MCP, che fornisce le competenze e le funzionalità di esecuzione delle API in modalità sandbox AWS .

{
  "mcpServers": {
    "aws-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws==1.6.2",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata", "AWS_REGION=us-east-1"
      ]
    }
  }
}

Per le istruzioni di configurazione complete, consulta Configurazione del server MCP. AWS

Casi d'uso ed esempi

Valuta le migliori pratiche dei broker standard

Richiesta: «Ho un cluster MSK Standard che utilizza broker kafka.m5.2xlarge con 2.500 partizioni per broker. Sto seguendo le migliori pratiche?»

L'abilità:

  • Controlla il numero delle partizioni rispetto al limite consigliato di 2.000 partizioni per broker per m5.2xlarge.

  • Avvisa se superi il numero consigliato e ti stai avvicinando al massimo di 3.000 che supporta le operazioni di aggiornamento.

  • Consigliamo di ridurre le partizioni o di effettuare l'aggiornamento a m5.4xlarge (che supporta 4.000 partizioni per broker).

  • Controlla le tue impostazioni e consiglia di modificarle se le dimensioni sono inferiori. num.io.threads num.network.threads

Diagnostica le prestazioni del broker Express

Prompt: «Il mio cluster Express ha 3 broker express.m7g.large e vedo delle limitazioni. Cosa c'è che non va?»

L'abilità:

  • Identifica che express.m7g.large supporta 15,6 MBps in ingresso e 31,2 MBps in uscita per broker.

  • Chiedi informazioni sul tuo throughput attuale o esegui una query per verificare e. CloudWatch BytesInPerSec BytesOutPerSec

  • Se il throughput supera i limiti per broker, consiglia di aumentare o aggiungere broker. express.m7g.xlarge

  • FetchThrottleTimeControllo e ProduceThrottleTime metriche.

Verifica la configurazione del client

Prompt: «Rivedi la configurazione del mio produttore Kafka per le best practice su MSK»

L'abilità:

  • Controlla le configurazioni critiche comelinger.ms,, acks batch.sizebuffer.memory, e altre per considerazioni sulle prestazioni e sulla durata.

  • Fornisci consigli per il tuo scenario per ottimizzare le configurazioni, migliorare le prestazioni e garantire un'elevata disponibilità.

Configura il monitoraggio e gli allarmi

Richiesta: «Aiutatemi a configurare il CloudWatch monitoraggio per il mio cluster MSK seguendo le best practice»

L'abilità:

  • Crea allarmi per metriche critiche come l'utilizzo della CPU (CpuUser + CpuSystem) e altre per monitorare RequestHandlerAvgIdlePercent la saturazione dei broker.

  • Per Standard: aggiungi KafkaDataLogsDiskUsed > 85% allarme e UnderReplicatedPartitions > 0 allarme.

  • Per Express: aggiungi il StorageUsed monitoraggio per l'ottimizzazione dei costi.

  • Configura dashboard per broker, per argomento e per gruppo di consumatori.

Codice sorgente e contributi

L'managing-amazon-mskabilità è open source. Puoi rivedere il codice sorgente, suggerire miglioramenti o contribuire con nuove funzionalità.

Il feedback su ulteriori scenari di best practice, nuovi casi d'uso o correzioni è ben accetto tramite problemi o pull request. GitHub