là một công cụ để tự động tạo ra tài liệu. Nó tạo tài liệu bằng cách phân tích các giao diện và nhận xét trong mã nguồn, đồng thời hỗ trợ nhiều định dạng đầu ra tài liệu khác nhau, bao gồm , v.v. Mục tiêu thiết kế của smart-doc là đơn giản hóa quá trình viết tài liệu, nâng cao hiệu quả phát triển và đảm bảo tính chính xác và kịp thời của tài liệu. smart-doc API Java Markdown HTML5 , OpenAPI 3.0 , Trong vòng đời phát triển phần mềm, việc tạo tài liệu API tự động và kiểm tra hiệu suất của giao diện là những bước quan trọng để nâng cao hiệu quả phát triển và đảm bảo chất lượng sản phẩm. Với việc bổ sung khả năng tạo JMeter trong phiên bản , các nhà phát triển có thể thực hiện hai tác vụ này một cách thuận tiện hơn. kiểm tra năng suất smart-doc 3.0.1 Bài viết này sẽ giới thiệu cách sử dụng smart-doc và JMeter để kiểm tra hiệu suất hiệu quả. Tạo tập lệnh JMeter Sử dụng để tạo các kịch bản kiểm tra hiệu suất có thể giảm đáng kể thời gian viết các kịch bản kiểm tra hiệu suất, từ đó nâng cao hiệu quả kiểm tra. Các tập lệnh JMeter được tạo tự động có thể chạy trực tiếp trong JMeter mà không cần cấu hình và gỡ lỗi phức tạp, giúp việc kiểm tra hiệu suất đơn giản và nhanh hơn nhiều. smart-doc JMeter smart-doc Trước tiên, hãy đảm bảo rằng đã được thêm vào dự án của bạn. Sau đó, cấu hình các tham số liên quan của plugin smart-doc trong tệp của dự án, ví dụ: 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> Chạy lệnh . Smart-doc sẽ quét mã nguồn dự án, trích xuất thông tin chú thích và tự động tạo tập lệnh kiểm tra hiệu suất JMeter tương ứng. mvn -Dfile.encoding=UTF-8 smart-doc:jmeter Những ai chưa biết cách sử dụng có thể tham khảo chính thức . tài liệu tài liệu thông minh Nhập vào JMeter Mở JMeter, nhấp vào " " -> " ", chọn tệp script JMeter được tạo ở bước đầu tiên và nhấp vào nút " ". JMeter sau đó sẽ bắt đầu thực hiện các bài kiểm tra hiệu suất theo kịch bản. File Open Start Định cấu hình Prometheus là một công cụ cảnh báo và giám sát nguồn mở để xử lý dữ liệu chuỗi thời gian. Chúng tôi có thể sử dụng nó để thực hiện giám sát thời gian thực trong quá trình kiểm tra căng thẳng JMeter, từ đó nâng cao khả năng quan sát của kiểm tra hiệu suất. Prometheus Bước 1: Cài đặt Plugin JMeter Prometheus Đầu tiên bạn cần cài đặt plugin Prometheus trong thư mục của JMeter. Bạn có thể tải xuống plugin từ Trình quản lý plugin JMeter hoặc . Nó cũng có thể được tải xuống từ . Trong trường hợp này, hãy tải xuống phiên bản 0.7.1 mới nhất từ GitHub. lib/ext Trang web chính thức GitHub Địa chỉ IP nghe mặc định của JMeter là , theo mặc định, địa chỉ này sẽ ngăn Prometheus kết nối với cổng nghe JMeter Prometheus. Vì vậy, cần phải thêm vào . Lưu ý: 127.0.0.1 prometheus.ip=0.0.0.0 jmeter.properties Bước 2: Thêm trình nghe Prometheus Mở JMeter và thêm Prometheus Listener vào kế hoạch kiểm tra của bạn. Điều này có thể được thực hiện bằng cách nhấp chuột phải vào -> -> -> . Test Plan Add Listener Prometheus Listener Cấu hình của trình nghe có thể tham khảo các cài đặt chính thức, với tham chiếu như sau ( hỗ trợ định cấu hình và thêm thế hệ Prometheus Listener): smart-doc 3.0.4 Bước 3: Định cấu hình Prometheus Scrape Trong tệp cấu hình của Prometheus ( ), thêm một mới để tìm nạp dữ liệu từ plugin JMeter Prometheus. Ví dụ: prometheus.yml scrape_config scrape_configs: - job_name: 'jmeter' scrape_interval: 15s static_configs: - targets: ['<Your JMeter machine IP>:9270'] Ở đây, là địa chỉ IP của máy đang chạy thử nghiệm JMeter và là cổng nghe mặc định cho plugin JMeter Prometheus. <Your JMeter machine IP> 9270 Bước 4: Chạy kế hoạch kiểm tra Với mục đích xác minh dễ dàng trong bài viết này, nhóm luồng được đặt thành " " trong quá trình kiểm tra sức chịu đựng, có thể điều chỉnh theo nhu cầu thực tế. vòng lặp vô hạn Sau khi khởi động thành công, theo mặc định, JMeter Prometheus sẽ tạo một dịch vụ trên cổng cục bộ . 9270 Truy cập URL và nếu bạn nhìn thấy nội dung như sau thì có nghĩa là đã thành công. , http://localhost:9270/metrics Bước 5: Khởi động Prometheus Sau khi khởi động , nó sẽ bắt đầu tìm nạp dữ liệu từ plugin JMeter Prometheus. Như được hiển thị trong cấu hình sau, sau khi khởi động thành công, bạn có thể thấy các mục tiêu đã đặt trong . Prometheus Prometheus Bước 6: Định cấu hình Grafana Trên trang web chính thức , hãy tìm bảng giám sát prometheus-jmeter do trang web chính thức cung cấp. Ở đây, chúng tôi chọn mẫu có ID để nhập vào Grafana. Grafana 14927 Sau khi nhấn , chọn nguồn dữ liệu . Load Prometheus Trong quá trình thử nghiệm, chúng tôi nhận thấy mẫu gốc có một số lỗi. Những điều này đã được khắc phục trong quá trình viết bài viết này. Nhập mẫu đã sửa được tải xuống từ . Lưu ý: 14927 GitHub Sau khi mẫu được nhập thành công, chúng ta sẽ có thể xem toàn bộ dữ liệu giám sát kiểm tra hiệu suất trong . Grafana Để tạo điều kiện trải nghiệm nhanh chóng toàn bộ quá trình kiểm tra hiệu suất, cộng đồng đã tuyển chọn và cung cấp một mẫu có thể được khởi chạy bằng một lệnh duy nhất bằng cách sử dụng . Đối với những người muốn trải nghiệm thông qua triển khai , các công cụ AI có thể được sử dụng để chuyển đổi trực tiếp mẫu thành mẫu triển khai . smart-doc docker-compose Kubernetes docker-compose Kubernetes Dự án trải nghiệm cũng bao gồm hướng dẫn sử dụng. Mã ví dụ cho bài viết này có thể được tìm thấy . đây Sự hỗ trợ của Smart-Doc trong kiểm tra hiệu suất JMeter Sự kết hợp giữa và JMeter để kiểm tra hiệu suất hoạt động mang lại một số lợi ích: smart-doc có thể tự động trích xuất thông tin API từ mã nguồn và tạo tập lệnh kiểm tra hiệu suất JMeter mà không cần viết thủ công, cải thiện đáng kể hiệu quả. Tự động hóa: smart-doc Các tập lệnh kiểm tra hiệu năng JMeter do tạo ra hoàn toàn phù hợp với định nghĩa API trong mã nguồn, tránh các lỗi có thể xảy ra khi viết tập lệnh theo cách thủ công. Độ chính xác: smart-doc hỗ trợ nhiều tùy chọn cấu hình khác nhau, cho phép tùy chỉnh các tập lệnh JMeter được tạo theo yêu cầu thử nghiệm. Tính linh hoạt: smart-doc cũng sẽ tiếp tục cải thiện và tối ưu hóa hỗ trợ cho JMeter. Hãy theo dõi để biết . smart-doc sự phát triển liên tục của dự án nguồn mở thông minh-doc Phần kết luận Bằng cách kết hợp và JMeter, chúng tôi không chỉ có thể tự động hóa việc tạo tài liệu API mà còn nhanh chóng tạo các tập lệnh kiểm tra hiệu suất và tiến hành kiểm tra căng thẳng. Công cụ tự động hóa này nâng cao đáng kể hiệu quả phát triển và thử nghiệm, đồng thời giúp các nhóm dễ dàng duy trì và tối ưu hóa hiệu suất của hệ thống phần mềm hơn. smart-doc Chúng tôi hy vọng bài viết này đã cung cấp những tài liệu tham khảo thiết thực để bạn có thể áp dụng những công cụ này hiệu quả hơn trong công việc hàng ngày. Chúng tôi cũng hoan nghênh mọi người tiếp tục theo dõi và hỗ trợ cộng đồng nguồn mở smart-doc. Trong tương lai, chúng tôi đang khám phá khả năng hỗ trợ cho các ngôn ngữ bổ sung để hỗ trợ nhiều nhà phát triển hơn.