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 ](https://agentskills.io/home) Agent Skills e disponibile in Agent Toolkit [ on, GitHub che fornisce competenze di dominio per la gestione dei cluster Amazon MSK ](https://github.com/aws/agent-toolkit-for-aws)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](bestpractices.md)(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](bestpractices-express.md)(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](bestpractices.md#bestpractices-monitor-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](bestpractices.md#bestpractices-monitor-disk-space) | 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](client-access.md) | Verifica producer/consumer le impostazioni, configura l'autenticazione, ottimizza l'alta disponibilità e la tolleranza ai guasti |
| 6 | [Creazione di cluster a disponibilità elevata](bestpractices.md#ensure-high-availability) | 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](monitoring.md) | 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](operations.md) | 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](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html)
### 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](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html)
## 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 ](bestpractices.md#partitions-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. ](limits.md#msk-express-quota)
+ 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`
+ `FetchThrottleTime`Controllo 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 come`linger.ms`,, `acks` `batch.size``buffer.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-msk`abilità è open source. Puoi rivedere il codice sorgente, suggerire miglioramenti o contribuire con nuove funzionalità.
+ **GitHub: ** [ aws/agent -toolkit-for-aws attivo ](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/managing-amazon-msk) GitHub
Il feedback su ulteriori scenari di best practice, nuovi casi d'uso o correzioni è ben accetto tramite problemi o pull request. GitHub