ist ein Tool zur automatischen Generierung Dokumentation. Es erstellt Dokumentationen durch die Analyse von Schnittstellen und Kommentaren im Quellcode und unterstützt eine Vielzahl von Dokumentausgabeformaten, darunter , mehr. Das Designziel von smart-doc besteht darin, den Dokumenterstellungsprozess zu vereinfachen, die Entwicklungseffizienz zu verbessern und die Genauigkeit und Aktualität der Dokumentation sicherzustellen. smart-doc Java-API Markdown HTML5 , OpenAPI 3.0 und Im Lebenszyklus der Softwareentwicklung sind die automatische Generierung von API-Dokumentation und die Leistungstests von Schnittstellen wichtige Schritte zur Verbesserung der Entwicklungseffizienz und zur Sicherstellung der Produktqualität. Mit der zusätzlichen Möglichkeit zur Generierung von JMeter Skripte in Version können Entwickler diese beiden Aufgaben bequemer erledigen. Leistungstest smart-doc 3.0.1 Dieser Artikel stellt die Verwendung von Smart-Doc und JMeter für effektive Leistungstests vor. JMeter- Skripte generieren Verwenden von zum Generieren Leistungstestskripte können den Zeitaufwand zum Schreiben von Leistungstestskripten erheblich reduzieren und so die Testeffizienz verbessern. Die von automatisch generierten JMeter-Skripte können direkt in JMeter ausgeführt werden, ohne dass eine komplexe Konfiguration und Fehlerbehebung erforderlich ist, was Leistungstests viel einfacher und schneller macht. smart-doc JMeter smart-doc Stellen Sie zunächst sicher, dass das zu Ihrem Projekt hinzugefügt wurde. Konfigurieren Sie dann die relevanten Parameter des Smart-Doc-Plugins in der Datei des Projekts, zum Beispiel: smart-doc-maven-plugin pom.xml <plugin> <groupId>com.ly.smart-doc</groupId> <artifactId>smart-doc-maven-plugin</artifactId> <version>[latest version]</version> <configuration> <configFile>./src/main/resources/smart-doc.json</configFile> <projectName>${project.description}</projectName> </configuration> </plugin> Führen Sie den Befehl aus. Smart-doc scannt den Quellcode des Projekts, extrahiert Annotationsinformationen und generiert automatisch die entsprechenden JMeter-Leistungstestskripte. mvn -Dfile.encoding=UTF-8 smart-doc:jmeter Diejenigen, die mit der Verwendung nicht vertraut sind, können sich an die offizielle . Smart-Doc-Dokumentation In JMeter importieren Öffnen Sie JMeter, klicken Sie auf „ “ -> „ “, wählen Sie die im ersten Schritt generierte JMeter-Skriptdatei aus und klicken Sie auf die Schaltfläche „ “. JMeter beginnt dann mit der Durchführung von Leistungstests gemäß dem Skript. Datei Öffnen Start Konfigurieren Sie Prometheus ist ein Open-Source-Überwachungs- und Warntool für die Verarbeitung von Zeitreihendaten. Wir können es verwenden, um während des JMeter-Stresstests eine Echtzeitüberwachung durchzuführen und so die Beobachtbarkeit von Leistungstests zu verbessern. Prometheus Schritt 1: Installieren Sie das JMeter Prometheus Plugin Zuerst müssen Sie das Prometheus-Plugin im -Verzeichnis von JMeter installieren. Sie können das Plugin aus dem JMeter Plugins Manager oder dem Es kann auch heruntergeladen werden von . Laden Sie für diese Instanz die neueste Version 0.7.1 von GitHub herunter. lib/ext offizielle Website GitHub Die standardmäßige Abhör-IP-Adresse von JMeter ist . Dies verhindert standardmäßig, dass Prometheus eine Verbindung zum Abhörport von JMeter Prometheus herstellt. Daher ist es notwendig, in hinzuzufügen. Hinweis: 127.0.0.1 prometheus.ip=0.0.0.0 jmeter.properties Schritt 2: Prometheus Listener hinzufügen Öffnen Sie JMeter und fügen Sie den Prometheus Listener zu Ihrem Testplan hinzu. Klicken Sie dazu mit der rechten Maustaste auf -> -> -> . Testplan Hinzufügen Listener Prometheus Listener Die Konfiguration des Listeners kann auf die offiziellen Einstellungen mit den folgenden Referenzen verweisen ( unterstützt das Konfigurieren und Hinzufügen der Prometheus-Listener-Generierung): smart-doc 3.0.4 Schritt 3: Prometheus Scrape konfigurieren Fügen Sie in der Konfigurationsdatei von Prometheus ( ) eine neue hinzu, um Daten vom JMeter Prometheus-Plugin abzurufen. Beispiel: prometheus.yml scrape_config scrape_configs: - job_name: 'jmeter' scrape_interval: 15s static_configs: - targets: ['<Your JMeter machine IP>:9270'] Hier ist die IP-Adresse des Computers, auf dem der JMeter-Test ausgeführt wird, und ist der Standard-Abhörport für das JMeter-Prometheus-Plugin. <Your JMeter machine IP> 9270 Schritt 4: Ausführen des Testplans Zur einfachen Überprüfung wird in diesem Artikel die Thread-Gruppe während des Stresstests auf „ “ eingestellt, die entsprechend den tatsächlichen Anforderungen angepasst werden kann. Endlosschleife Nach dem erfolgreichen Start erstellt JMeter Prometheus standardmäßig einen Dienst auf dem lokalen Port . 9270 Zugriff auf die URL und wenn Sie den folgenden Inhalt sehen, bedeutet dies, dass es erfolgreich war. , http://localhost:9270/metrics Schritt 5: Starten Sie Prometheus Nach dem Start von beginnt es, Daten vom JMeter Prometheus-Plugin abzurufen. Wie in der folgenden Konfiguration gezeigt, können Sie nach dem erfolgreichen Start die festgelegten Ziele in sehen. Prometheus Prometheus Schritt 6: Grafana konfigurieren Auf der offiziellen -Website finden Sie das von der offiziellen Website bereitgestellte Prometheus-JMeter-Überwachungspanel. Hier wählen wir die Vorlage mit der ID aus, um sie in Grafana zu importieren. Grafana 14927 Wählen Sie nach dem Klicken auf die -Datenquelle aus. „Laden“ Prometheus Beim Testen wurde festgestellt, dass die ursprüngliche Vorlage einige Fehler enthielt. Diese wurden während des Schreibprozesses dieses Artikels behoben. Importieren Sie die korrigierte Vorlage, die Sie heruntergeladen haben von . Hinweis: 14927 GitHub Nachdem die Vorlage erfolgreich importiert wurde, können wir die gesamten Leistungstest-Überwachungsdaten in sehen. Grafana Um den gesamten Leistungstestprozess schnell durchlaufen zu können, hat die Community eine Vorlage zusammengestellt und bereitgestellt, die mit einem einzigen Befehl mithilfe von gestartet werden kann. Für diejenigen, die dies über Bereitstellung erleben möchten, können KI-Tools verwendet werden, um die Vorlage direkt in eine Bereitstellungsvorlage umzuwandeln. smart-doc docker-compose Kubernetes docker-compose Kubernetes Zum Erlebnisprojekt gehört auch eine Gebrauchsanleitung. Den Beispielcode für diesen Artikel finden Sie . Hier Die Unterstützung von Smart-Doc beim JMeter-Leistungstest Die Kombination von und JMeter für Leistungsstresstests bietet mehrere Vorteile: smart-doc kann automatisch API-Informationen aus dem Quellcode extrahieren und JMeter-Leistungstestskripte generieren, ohne dass diese manuell geschrieben werden müssen, was die Effizienz erheblich verbessert. Automatisierung: smart-doc Die von generierten JMeter-Leistungstestskripte stimmen vollständig mit den API-Definitionen im Quellcode überein und vermeiden so Fehler, die beim manuellen Schreiben von Skripten auftreten können. Präzision: smart-doc unterstützt eine Vielzahl von Konfigurationsoptionen, sodass die generierten JMeter-Skripte entsprechend den Testanforderungen angepasst werden können. Flexibilität: smart-doc wird auch weiterhin die Unterstützung für JMeter verbessern und optimieren. Bitte bleiben Sie dran für die . smart-doc Weiterentwicklung des Open-Source-Projektes smart-doc Abschluss Durch die Kombination von und JMeter können wir nicht nur die Generierung von API-Dokumentationen automatisieren, sondern auch schnell Leistungstestskripte erstellen und Stresstests durchführen. Dieses Automatisierungstool steigert die Entwicklungs- und Testeffizienz erheblich und hilft Teams dabei, die Leistung von Softwaresystemen einfacher zu warten und zu optimieren. smart-doc Wir hoffen, dass dieser Artikel Ihnen praktische Hinweise gegeben hat, damit Sie diese Tools in Ihrer täglichen Arbeit effizienter einsetzen können. Wir begrüßen auch alle, die Open-Source-Community von smart-doc weiterhin zu verfolgen und zu unterstützen. In Zukunft prüfen wir die Unterstützung weiterer Sprachen, um mehr Entwicklern zu helfen.