載地址HTMLTestRunner.py文件:
http://tungwaiyip.info/software/HTMLTestRunner.html
下載的適合python2,如果python3要修改一些內容
首先吧HTMLTestRunner文件添加到環境變量里,可以直接放到python的Lib目錄下
HTMLTestRunner是python標準庫unittest單元測試框架的一個擴展,用于生成HTML測試報告
#coding:utf-8
import unittest, HTMLTestRunner
class Testcase(unittest.TestCase): # 測試用例類
# 具體的測試用例,一定要以test開頭
def test1(self):
self.assertEqual(1, 1)
def test2(self):
self.assertEqual(2, 2)
if __name__ == "__main__":
# 構造測試集
suite = unittest.TestSuite()
suite.addTest(unittest.makeSuite(Testcase)) # 執行該測試類所有用例
# 定義報告的存放路徑,以二進制寫的形式打開文件
f = open('test.html', 'wb')
# 定義測試報告,stream:報告存放路徑,title:報告標題,description:描述
runner = HTMLTestRunner.HTMLTestRunner(stream=f, title=u'測試用例標題', description=u'描述')
runner.run(suite) # 運行測試用例
f.close() # 關閉文件
返回結果(測試報告詳情):
--stream :存放報告寫入文件的存入區域
--title :測試報告的主題
--description :測試報告的描述
為了生成帶有中文描述的測試用例類和測試用例
在用例類和用例方法下,通過’’’ ‘’’或””” “””來添加備注
#coding:utf-8
import unittest, HTMLTestRunner
class Testcase(unittest.TestCase): # 測試用例類
u'''類名后加備注'''
def test1(self):
u'''用例后面加備注1'''
self.assertEqual(1, 1)
def test2(self):
u'''用例后面加備注2'''
self.assertEqual(2, 2)
if __name__ == "__main__":
# 構造測試集
suite = unittest.TestSuite()
suite.addTest(unittest.makeSuite(Testcase))
# 定義報告的存放路徑,以二進制寫的形式打開文件
f = open('test.html', 'wb')
# 定義測試報告,stream:報告存放路徑,title:報告標題,description:描述
runner = HTMLTestRunner.HTMLTestRunner(stream=f, title=u'測試用例標題', description=u'描述')
runner.run(suite) # 運行測試用例
f.close() # 關閉文件
返回結果:
#coding:utf-8
import unittest, HTMLTestRunner, time
from unittest.loader import makeSuite
class Testcase(unittest.TestCase): # 測試用例類
# 具體的測試用例,一定要以test開頭
def test1(self):
self.assertEqual(1, 1)
def test2(self):
self.assertEqual(2, 2)
if __name__ == "__main__":
# 構造測試集
suite = unittest.TestSuite()
suite.addTest(makeSuite(Testcase)) # 執行該測試類所有用例
# 定義報告的存放路徑,以二進制寫的形式打開文件
now = time.strftime("%y-%m-%d %H_%M_%S")
f = open('./' + now + 'test.html', 'wb')
# 定義測試報告,stream:報告存放路徑,title:報告標題,description:描述
runner = HTMLTestRunner.HTMLTestRunner(stream=f, title=u'測試用例標題', description=u'描述')
runner.run(suite) # 運行測試用例
f.close() # 關閉文件
返回結果:
將紅框里的內容注釋掉改成uo = o.decode('utf-8')
、為什么用命令行模式
使用GUI方式啟動jmeter,運行線程較多的測試時,會造成內存和CPU的大量消耗,導致客戶機卡死;
所以一般采用的方式是在GUI模式下調整測試腳本,再用命令行模式執行;
命令行方式支持在多個環境下使用,windosw的dos環境下,也可以在linux環境上執行。
注意:使用命令執行jmeter腳本必須使用jmeter 3.0及以上版本。
2、怎么用
2.1、執行命令
jmeter -n -t <testplan filename> -l <listener filename>
示例: jmeter -n -t testplan.jmx -l test.jtl
示例含義:表示以命令行模式運行testplan.jmx文件,輸出的日志文件為test.jtl
2.2、參數介紹
Jmeter官方手冊給的介紹如下:
-h, –help -> prints usage information and exit
-n, –nongui -> run JMeter in nongui mode
-t, –testfile <argument> -> the jmeter test(.jmx) file to run
-l, –logfile <argument> -> the file to log samples to
-r, –runremote -> Start remote servers (as defined in remote_hosts)
-H, –proxyHost <argument> -> Set a proxy server for JMeter to use
-P, –proxyPort <argument> -> Set proxy server port for JMeter to use
中文釋義:
-h 幫助 -> 打印出有用的信息并退出
-n 非 GUI 模式 -> 在非 GUI 模式下運行 JMeter
-t 測試文件 -> 要運行的 JMeter 測試腳本文件
-l 日志文件 -> 記錄結果的文件
-R 遠程執行 -> 遠程執行機的IP(ip地址)如果有多個ip時,使用-R 192.168.2.170,192.168.2.171(分布式使用)
-r 遠程執行 -> 在Jmter.properties文件中指定的所有遠程服務器(分布式使用)
-H 代理主機 -> 設置 JMeter 使用的代理主機
-P 代理端口 -> 設置 JMeter 使用的代理主機的端口號
2.3、執行過程
命令:jmeter -n -t C:\Users\yzs\Desktop\Unione_performance.jmx -l report-result.jtl
不在jmeter安卓目錄執行腳本的前提是配置了jmeter的環境變量。
上述的命令有測試結果保存到D:\report中,在GUI模式下查看測試報告:
1、在測試計劃下,添加對應的測試報告元件,舉例增加了:查看結果樹、聚合報告
2、在“所有數據寫入一個文件”,選擇加載對應的結果文件
3、下面就會有對應的表格展示,具體見下圖
2.5、命令行傳遞變量值
設置線程組的線程數和循環次數。
注意格式:
${__P(threadNum)}
${__P(threadCount)}
其中P前面是兩個下劃線,()內就是變量名
執行時,在命令行中用-J參數給變量賦值即可:
jmeter -n -t C:\Users\yzs\Desktop\Unione_performance.jmx -J threadNum=10 -J threadCount=2 -l report-result.jtl
此次測試相當于:10個線程,循環2次,共計20個請求。
3、生成HTML報告
生成HTML報告有2種方式,一種是直接在命令行加上-o參數,另一種是已有jtl結果文件,運行命令生成報告
3.1、命令行直接生成報告
jmeter -n -t 【Jmx腳本位置】-l 【中間文件result.jtl位置】-e -o 【報告指定文件夾】
-e:測試結束后,生成測試報告
-o:指定測試報告的存放位置
注意:-o后面跟的文件夾一定是不存在的或者是空文件夾
3.2、已有jtl結果文件,運行命令生成報告
jmeter -g【已經存在的.jtl文件的路徑】-o 【用于存放html報告的目錄】
注意:經實操,windows系統上,以上2種方法都可以生成HTML測試報告,但是在Linux系統上第1種方法,沒有生成報告,只有第二種方法才可以(具體原因后面在慢慢找吧)
3.3、HTML報告注解
用瀏覽器打開index.html
報告詳解
Dashboard:(重點查看)
Test and Report informations:指的是測試和報告信息
APDEX(Application Performance Index):應用程序性能滿意度的標準
其中,
Requests Summary:請求的通過率(OK)與失敗率(KO),百分比顯示
Statistics:數據分析,基本將Summary Report和Aggrerate Report的結果合并(平均響應時間、TPS在此查看)
Errors:錯誤情況,依據不同的錯誤類型,將所有錯誤結果展示
關于Apdex的補充:
性能指數,Apdex(Application Performance Index)是一個國際通用標準,Apdex 是用戶對應用性能滿意度的量化值。它提供了一個統一的測量和報告用戶體驗的方法,把最終用戶的體驗和應用性能作為一個完整的指標進行統一度量。下圖表示為通用用戶滿意度區域,0代表沒有滿意用戶,1則代表所有用戶都滿意。實際業務系統開發過程中,1是團隊的追求目標。
若所有請求的Apdex值都接近1,說明用戶滿意度優秀,也從側面說明了服務器響應速度快。
通常而言,最低要求超過0.5,當然項目組可設定具體需求。
Charts:(輔助分析)
主要有如下特點:
(1)將測試過程中經常使用的數據,用圖表的形式展示,讓測試結果更加直觀
(2)每個圖表數據,有兩種展示形式
(3)支持請求樣例過濾顯示
(4)支持導出PNG圖片格式
Over Time Charts:
Throughput Charts:
Response Times Charts:
3.4、HTML報告的自定義配置
JMeter3.0開始在bin目錄新增了reportgenerator.properties文件保存了所有關于圖形化HTML報告生成模塊的默認配置,要變更配置,建議不要直接編輯該文件,而是推薦在user.properties中去配置和覆蓋。
3.4.1總體配置
總體配置都是以jmeter.reportgenerator.為前綴,如:jmeter.reportgenerator.overall_granularity=60000
# Change this parameter if you want to change the granularity of over time graphs.
jmeter.reportgenerator.overall_granularity=6000
Apdext = (Satisfied Count + Tolerating Count / 2) / Total Samples
另外,在jmeter.properties中,有關于集合報告中的三個百分位的默認值:
aggregate_rpt_pct1 : Defaults to 50
aggregate_rpt_pct2 : Defaults to 70
aggregate_rpt_pct3 : Defaults to 99
3.5、HTML報告的定制
JMeter的HTML報告生成時是使用了固定的模板,模板文件路徑為./bin/report-template。
進入該目錄可以看到報告的每個頁面都有一個.fmkr模板文件,包括index.html.fmkr和./content/pages路徑下的幾個文件。通過查看這些模板文件,就可以知道怎樣去進行報告的輕度定制,比如將一些文本修改得更易懂,或者修改為中文等
頁面的title
默認為"Apache JMeter Dashboard"
可以由reportgenerator.properties中的jmeter.reportgenerator.report_title來統一定義,這種方式就是所有頁面的title都使用同一個。
也可以直接修改對應的.fmkr文件中的title標簽中雙引號內的值,如<title>${reportTitle!"想要設置的title"}</title>,這中方式可以為每個頁面單獨定義title
圖表的名稱
當前版本下,各圖表的名稱是直接在模板文件中定義,要修改也是直接修改模板文件中對應元素的值即可
如要修改Transactions Per Second圖表的名稱,可以直接在./content/pages/Throughput.html.fmkr文件中修改,效果如下圖
1、之前出了一篇oracle自動巡檢腳本生成html報告和一篇Linux服務器系統自動巡檢腳本生成html報告,本篇文章出一篇mysql自動巡檢腳本生成html報告。
2、腳本只提供部分簡單的巡檢內容,如binlog信息、數據庫運行信息,還有些mysql的一些重要參數配置,其他的巡檢內容大家根據實際需要編輯修改,增加符合自己需求的巡檢內容。
3、項目已經上傳到我的github上
項目地址:https://github.com/domdanrtsey/mywatch
二、注意事項與報告部分截圖
注意閱讀git上的README.md說明
1、需要使用root用戶執行
2、使用說明
多實例下運行此腳本時,要注意區分不同實例的root用戶密碼與對應端口號
myuser="root"
mypasswd="XXXXX"
myip="localhost"
myport="3306"
3、執行完巡檢之后,將在腳本所在的路徑下生成html巡檢結果報告,如下192.168.35.244os_mysql_simple_summary.html
4、巡檢項信息如下(其他統計項可根據實際需要自行添加)
0)、巡檢ip信息
1)、數據庫基本信息與binlog參數信息
2)、數據庫運行狀況信息
3)、數據庫一些重要參數配置信息
*請認真填寫需求信息,我們會在24小時內與您取得聯系。