View a markdown version of this page

Analysieren Sie bewährte Methoden mit dem Skill managing-amazon-msk - Amazon Managed Streaming für Apache Kafka
CapabilitiesFunktionsweiseInstallationAnwendungsfälle und BeispieleQuellcode und Beiträge

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Analysieren Sie bewährte Methoden mit dem Skill managing-amazon-msk

Bei dem managing-amazon-msk Skill handelt es sich um einen Open-Source-Agenten-Skill, der ab dem Agent Toolkit auf GitHub der AWS Agent Skills-Website zur Verfügung steht und Fachwissen für den Betrieb von Amazon MSK Provisioned Clustern bietet. Nachdem Sie den Skill in einem MCP-compatible KI-Coding-Agenten (wieKiro,, und anderen) installiert haben CursorClaude Code, ermöglicht der Skill dem AI-Agenten, Ihnen zu helfen, Ihren Cluster und Ihre Kunden anhand von Best Practices zu bewerten, Betriebsprobleme zu diagnostizieren und empfohlene Konfigurationen für Standard- und Express-Broker und -Kunden zu implementieren. Kafka Der Skill kodiert MSK-specific betriebliches Wissen, das bei allgemeinen KI-Modellen häufig falsch angewendet oder weggelassen wird.

Capabilities

Der Skill deckt die folgenden Bereiche ab, von denen jeder den in diesem Handbuch dokumentierten bewährten Verfahren entspricht.

Bereich „Bewährte Verfahren“ Wobei hilft dir der Skill
1 Bewährte Methoden für Standard-Broker(Standard) Bewerten Sie die Anzahl der Partitionen pro Broker, empfehlen Sie Instance-Größen, evaluieren Sie num.io.threads und num.network.threads optimieren Sie sie für m5.4xl+- und m7g.4xl+ Instances
2 Bewährte Methoden für Express-Broker(Express) Berechnen Sie die erforderliche Broker-Anzahl auf der Grundlage der Durchsatzgrenzen pro Broker, empfehlen Sie Express-Instance-Typen für das Ziel ingress/egress, vergleichen Sie die Anzahl der Partitionen anhand der Express-Kontingente
3 CPU-Auslastung überwachen Diagnostizieren Sie die Auslastung der Broker-Ressourcen, unterscheiden Sie zwischen den Ursachen und Fehlkonfigurationen auf Brokerseite und auf der Client-Seite und ermitteln Sie, wann eine Skalierung erforderlich ist
4 Überwachen der Festplattenkapazität Bewerten Sie die Speichernutzung für Standard-Broker, identifizieren Sie Themen mit hohem Wachstum und empfehlen Sie EBS-Erweiterungen oder Anpassungen der Kundenbindung. Überwachen Sie bei Express die Speichernutzung (der Speicher wird vollständig verwaltet), um die Kosten zu optimieren
5 Stellen Sie eine Connect zu einem von Amazon MSK bereitgestellten Cluster her Überwachen Sie die producer/consumer Einstellungen, konfigurieren Sie die Authentifizierung und sorgen Sie für hohe Verfügbarkeit und Fehlertoleranz
6 Erstellen hochverfügbarer Cluster Überprüfen Sie Hochverfügbarkeitskonfigurationen und die Multi-AZ-Bereitstellung für Standard-Broker sowie die Konfiguration des Client-Failovers
7 Überwachen Sie einen von Amazon MSK bereitgestellten Cluster Erstellen Sie CloudWatch Dashboards und Alarme für wichtige Kennzahlen, die für die Beobachtbarkeit und den Betrieb von Amazon MSK von entscheidender Bedeutung sind
8 Die wichtigsten Funktionen und Konzepte von Amazon MSK Beurteilen Sie die Bereitschaft des Clusters für Updates, machen Sie sich ein Bild vom Patch-Verhalten zwischen Standard und Express und machen Sie sich ein Bild von den Auswirkungen eines Broker-Neustarts auf die Kunden

Funktionsweise

Wenn Sie Ihrem KI-Codierungsagenten eine Frage zu Amazon MSK stellen, z. B. „Warum ist die CPU meines MSK-Clusters hoch?“ oder „Helfen Sie mir, die Überwachung für meinen Express-Cluster einzurichten“ — der Skill wird aktiviert und bietet dem Agenten:

  • Diagnose-Workflows — Strukturierte Schritte zur Fehlerbehebung, bei denen zuerst die wahrscheinlichsten Ursachen überprüft werden (z. B. Überprüfung, linger.ms bevor eine Broker-Skalierung bei CPU-Problemen empfohlen wird).

  • Broker-type-aware Anleitung — Der Skill bestimmt, ob Ihr Cluster Standard- oder Express-Broker verwendet, und wendet die richtigen Metriken, Schwellenwerte und Empfehlungen für diesen Brokertyp an.

  • AWS CLI-Befehle — Ready-to-run Befehle zur Beschreibung von Clustern, zum Erweitern des Speichers, zum Erstellen von Konfigurationen und zum Abfragen CloudWatch von Metriken.

  • Validierung bewährter Verfahren — Prüft Ihre Cluster-Konfiguration anhand dokumentierter Empfehlungen und kennzeichnet Abweichungen.

Installation

Option 1: AWS CLI

Erfordert AWS CLI-Version 2.35.0 oder höher.

# 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

Die vollständige CLI-Dokumentation finden Sie unter Verwaltung von Fähigkeiten mit der AWS CLI.

Option 2: AWS MCP-Server

Verbinden Sie Ihren KI-Codierungsagenten mit dem AWS MCP-Server, der den Skill zusammen mit API-Ausführungsfunktionen in der Sandbox bereitstellt. 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"
      ]
    }
  }
}

Vollständige Anweisungen zur Einrichtung finden Sie unter Einrichten des AWS MCP-Servers.

Anwendungsfälle und Beispiele

Bewerten Sie die bewährten Methoden von Standardmaklern

Aufforderung: „Ich habe einen MSK Standard-Cluster, der kafka.m5.2xlarge Broker mit 2.500 Partitionen pro Broker verwendet. Befolge ich bewährte Methoden?“

Die Fähigkeit:

  • Vergleichen Sie die Anzahl Ihrer Partitionen mit dem empfohlenen Limit von 2.000 Partitionen pro Broker für m5.2xlarge.

  • Warnen Sie, wenn Sie die empfohlene Anzahl überschreiten und sich dem Maximum von 3.000 nähern, das Aktualisierungsvorgänge unterstützt.

  • Es wird empfohlen, entweder die Anzahl der Partitionen zu reduzieren oder ein Upgrade auf m5.4xlarge durchzuführen (das 4.000 Partitionen pro Broker unterstützt).

  • Überprüfe deine num.network.threads AND-Einstellungen num.io.threads und empfehle, sie zu optimieren, falls sie zu klein sind.

Diagnostizieren Sie die Leistung von Express Broker

Aufforderung: „Mein Express-Cluster hat 3 express.m7g.large Broker und ich sehe eine Drosselung. Was stimmt nicht?“

Die Fähigkeit:

Überprüfen Sie die Client-Konfiguration

Aufforderung: „Überprüfen Sie meine Kafka-Producer-Konfiguration auf bewährte Methoden für MSK“

Die Fähigkeit:

  • Prüfen Sie wichtige Konfigurationen wielinger.ms,, acks batch.sizebuffer.memory, und mehr auf Leistungs- und Haltbarkeitsaspekte.

  • Geben Sie Empfehlungen für Ihr Szenario ab, um Konfigurationen zu optimieren, die Leistung zu verbessern und eine hohe Verfügbarkeit sicherzustellen.

Richten Sie Überwachung und Alarme ein

Aufforderung: „Helfen Sie mir, die CloudWatch Überwachung für meinen MSK-Cluster gemäß den bewährten Methoden einzurichten“

Die Fähigkeit:

  • Erstellen Sie Alarme für wichtige Kennzahlen wie CPU-Auslastung (CpuUser + CpuSystem) und andereRequestHandlerAvgIdlePercent, um die Auslastung der Broker zu überwachen.

  • Für Standard: KafkaDataLogsDiskUsed > 85% Alarm und UnderReplicatedPartitions > 0 Alarm hinzufügen.

  • Für Express: Fügen Sie StorageUsed Überwachung zur Kostenoptimierung hinzu.

  • Richten Sie Dashboards pro Broker, pro Thema und pro Verbrauchergruppe ein.

Quellcode und Beiträge

Der managing-amazon-msk Skill ist Open Source. Sie können den Quellcode überprüfen, Verbesserungen vorschlagen oder neue Funktionen beitragen.

Feedback zu weiteren Best-Practice-Szenarien, neuen Anwendungsfällen oder Korrekturen ist per GitHub Issues oder Pull Requests willkommen.