diff --git a/docs/grafana/rmf-app/oxygen-webhelp/app/config.js b/docs/grafana/rmf-app/oxygen-webhelp/app/config.js index eb03725f..afa4ef1a 100644 --- a/docs/grafana/rmf-app/oxygen-webhelp/app/config.js +++ b/docs/grafana/rmf-app/oxygen-webhelp/app/config.js @@ -114,7 +114,7 @@ define(function() { if(id === 'index-1' || id === 'index-2' || id === 'index-3' || id === 'stopwords' ||id === 'htmlFileInfoList' || id === 'keywords') { - args = '20250404160800'; + args = '20250513175015'; } return (url.indexOf('?') === -1 ? '?' : '&') + args; diff --git a/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-1.js b/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-1.js index 41a7bb01..a869951e 100644 --- a/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-1.js +++ b/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-1.js @@ -1,4 +1,4 @@ define(function () { // Auto generated index for searching. -return {"--detach":"11*0*8m,17*0*6f","--env":"11*1*9b$a3,17*1*74$7s","--hostname":"11*0*8h,17*0*6a","--name":"11*0*8c,17*0*65","--pluginurl":"11*0*6c,17*0*2i","--publish":"11*0*97,17*0*70","--restart":"11*0*8o,17*0*6h","--verify":"11*0*gv","--volume":"11*0*8t,17*0*6m","-specific":"7*0*5t",".ini":"13*0*ac","/etc/grafana/grafana.ini":"11*0*3p,13*0*bb","/path/to/certificate.crt":"8*0*9j","/path/to/jwks.json":"8*0*47,13*0*8i","/path/to/privatekey.key":"8*0*a7","/usr/local/etc/grafana/grafana.ini":"11*0*3v,13*0*bh","/var/lib/grafana":"11*0*93,17*0*6s","0-9":"6*0*3p","1.0.x":"15*0*dt","10":"7*0*59","1024":"3*0*9f","12345":"13*2*7e$7l$83","128":"3*0*9c","2023":"15*2*bt$c5$cd","2024":"15*4*2c$34$4f$5g$8s","2025":"15*0*m","24":"6*0*3i","2>&1":"7*0*7t","3.1":"11*0*19,15*0*dj","3000":"6*0*68,11*1*99$9a,17*1*72$73","3650":"11*0*1e","4000":"6*0*55","60":"3*0*5l","60m":"8*1*57$59","9.5.1":"11*0*1i,15*0*dv","&1":"7*0*7t","3.1":"11*0*19,15*0*fk","3000":"6*0*68,11*1*99$9a,17*1*72$73","3650":"11*0*1e","4000":"6*0*55","60":"3*0*5l","60m":"8*1*57$59","9.5.1":"11*0*1i,15*0*g0","/ibm-rmf-grafana-.zip":"11*0*6e,17*0*2k","hub":"11*0*bq","iat":"8*0*5u","ibm":"0*0*2p,2*2*18$24$5e,3*1*1m$28,5*12*-1$6$32$7i,6*0*1d,7*16*-1$c$1f$2p$3f$41$71$7d,9*40*-1$2$9$h,11*39*-1$f$21$23$26$6i$6m$6q$72$9j$9n$9r$a1$ac$ae$ah$bh$db$dl$du$ed$fa$fu$g5$gc$gm$h2$h8$hg$i0$i9,12*11*-1$a$k,13*1*70$7n,14*31*0$4$11,15*22*-1$c$2n$37$3j$3r$9b$9j$a3$bm$ci$cv$d8$dn,16*14*-1$f$1e$21$3h$4g,17*26*-1$f$2o$2s$30$38$45$49$4d$7c$7g$7k$7q$85$87$8a$bj$c5,19*11*-1$p$1q","ibm-rmf":"11*1*71$a0,17*1*37$7p","ibm-rmf-grafana-x.y.z.zip":"11*1*g4$h7","ibm-rmf-grafana-x.y.z.zip.asc":"11*1*gb$h1","icon":"2*1*4p$88,5*1*85$8e","id":"7*1*4r$57,8*0*6t","identical":"6*0*4d,18*0*1o","identifies":"1*0*14","identify":"2*0*29,7*12*-1$t$4v$5p,8*0*35","iframe":"8*0*bu","ignored":"3*0*6d","iii":"0*10*-1$k,3*10*-1$b,11*10*-1$p,14*3*2h$2q$44$dt,19*40*-1$3$9$1c","iip":"14*0*bk","image":"2*0*50,5*2*59$5g$7e,11*2*ak$b4$b7,14*2*bn$c1$ek,15*1*6t$71,17*2*8d$8t$90,18*0*8n","images":"11*2*bd$bg$bk","immediately":"7*0*2f","import":"5*0*82,15*0*7l,17*4*99$9j$ae$bs$bv","importance":"10*0*q","important":"3*0*4e,18*1*2d$2f","imported":"5*0*2q","importing":"11*0*fm","improve":"15*0*5q","improved":"15*0*48","improves":"15*0*1k","incidents":"1*0*1s","include":"15*1*7v$9u","included":"15*0*8l","including":"6*0*3k,19*0*3d","incoming":"1*0*o","index":"5*1*5k$5q,15*0*74","indicative":"7*0*3l","individual":"13*0*aa","information":"1*0*1u,2*1*a1$am,3*0*ac,5*1*26$8k,7*12*-1$q$3p$3q,8*13*-1$9$53$5n$ca,9*0*1s,11*5*hn$j6,13*3*2a$2s$40$8m,14*1*3h$d4,15*1*8n$at,16*2*p$16$1u","informs":"7*0*3s","ini":"11*5*2l$2s$31$3n$3t$45,13*3*ad$b9$bf$bn","insights":"10*0*1a","install":"5*0*2g,9*0*28,11*15*-1$e$50$65$70$9e$dk,13*11*2i$2m$a3,17*3*1e$36$3q$77","installation":"11*0*2i,15*0*ao","installed":"2*1*17$3m,3*1*v$2o,6*0*1c,11*5*15$1g$7f$b3$d3$hv,13*0*1b,17*0*bb","installing":"2*0*1f,3*0*16,6*0*1k,9*0*2e,11*32*0$6$5a$5m,13*1*15$32,15*0*av,17*10*-1$10","instance":"8*1*ak$ce","instead":"18*0*1r","instructions":"11*0*fl,13*0*31,15*0*ad","integer":"14*3*7q$7u$86$8a","integration":"19*0*3m","interactive":"14*0*dp,18*10*-1$d,19*10*-1$n","interacts":"5*0*1t","interest":"14*0*60","interface":"2*0*3f,3*0*2h,5*0*76,11*0*cs,15*0*5k,17*0*b4","internally":"15*5*28$2g$4b$50$5u$9n","interval":"10*0*43","introduction":"1*30*0$2","invalid":"11*0*e4","investigate":"0*10*-1$h","investigation":"16*0*24","involves":"14*0*l","ioq":"5*0*5m","ip":"6*2*4i$4r$50","iss":"8*1*6a$6e","issue":"7*1*52$79,15*0*9a,16*0*1l","issued":"7*0*66","issues":"1*11*-1$d$16,7*12*-1$9$19$5q,15*13*-1$b$91$bh$ca,16*43*-1$1$3$a$s$29$2g","it's":"7*0*4d,18*0*2e","its":"3*0*ah,13*1*1i$34,14*0*1f,17*10*-1$o,19*0*3e","jes":"5*0*5v","job":"10*0*45,14*0*b2","json":"8*3*3v$45$4a$5l,13*14*48$4n$6f$8d$8l$9n","json-encoded":"8*0*5k","jti":"8*0*6d","june":"15*0*5f","jwk":"8*0*3o,13*3*66$6m$73$7q","jwk_set_file":"8*0*3n","jwks":"8*0*49,13*2*8c$8k$9r","jwks.json":"13*0*8b","jwksuri":"13*3*6a$6p$7g$8a","jwt":"8*18*-1$h$t$19$1e$2q$3c$3g$7j$cp,13*28*4b$4q$4u$58$5i$5n$6v$7m$8p$93$9b$ah","keep":"1*0*m","key":"8*3*41$9p$9v$aa,11*4*ek$et$f1$fi$fo,13*1*6h$9p","know":"3*0*1e","known":"15*10*-1$a","label":"18*6*4e$5c$5o$66$6j$70$8a","language":"2*0*64","languages":"2*1*21$27,14*30*3$7","later":"11*0*1j,13*0*2q,15*0*e0","latest":"15*0*7o,16*0*o,17*10*-1$12","lax":"8*0*bb","lb":"14*0*6p","lead":"1*0*1q","learn":"18*0*8o","least":"2*11*-1$o$2u","level":"3*1*69$6g,11*0*1c,14*0*5m","leverage":"17*10*-1$n","lib":"11*0*95,17*0*6u","limited":"18*1*4d$4g","link":"12*10*-1$7","linux":"11*0*3o,13*0*ba","linuxone":"11*0*bi","list":"0*0*22,2*4*5t$6m$7j$7q$bq,6*1*2k$5g,14*10*55$63$6n$70$7g$7v$8b$8p$90$97$9e,18*2*1c$2s$31,19*0*5i","listed":"3*0*7h,11*0*ic","lists":"5*0*37,8*0*m,9*0*1i","lo":"14*1*84$85","loaded":"8*0*43","loading":"11*3*1u$4e$4m$a9,17*0*82","local":"11*0*41,13*1*9t$bj","location":"11*1*37$f3,13*0*ap","locksp":"5*0*67","locksu":"5*0*6g","log":"0*0*1d,6*0*21,7*0*54","logged":"0*0*1i,6*0*26","login":"8*2*1p$24$7f","logs":"7*1*7c$7p","longer":"5*0*89,15*0*42","looking":"7*0*5r","lower":"7*0*5c,14*2*6s$76$7j","lowest":"14*0*88","macos":"11*0*3u,13*0*bg","made":"2*1*97$9c","main":"11*0*fd","maintenance":"3*1*68$6f,18*0*1j","make":"3*0*32,18*0*u","making":"10*0*11","manage":"18*0*8s","management":"9*40*-1$5$c$k,13*3*2e$3i$43$8u,15*0*a6","managing":"5*0*29","mandatory":"8*0*39","manual":"1*0*1k","many":"13*0*24","master":"3*1*a9$af,5*43*-1$1$4$i$3k$7f$8h","match":"14*0*6k","maximizes":"14*0*1e","may":"7*1*1b$6t,10*0*3m,15*0*bi,16*11*-1$b$t","mb":"3*0*91","means":"3*0*5r,10*0*23","measurement":"7*0*6k,14*1*4b$e3,15*0*df,19*10*-1$14","measures":"7*0*2j","meet":"5*0*1k","megabytes":"15*0*4t","mention":"8*0*3e","mentioned":"17*0*4k","menu":"2*0*59,6*0*7g","message":"3*0*9m,7*2*3d$3r$84,11*0*e8","messages":"7*15*-1$n$12$65$6e$6m$6r","met":"19*0*4v","methods":"11*1*4s$58,17*0*1h","metric":"10*1*1m$3a,14*14*2a$2s$30$37$4h$4k$4v,18*10*-1$n","metric_description":"14*1*36$4g","metrics":"0*10*-1$l,1*0*p,3*10*-1$c,10*0*27,11*10*-1$q,14*0*2i,16*0*2q,19*40*-1$4$a$1d","might":"3*0*4q","minimum":"8*0*n","minutes":"8*0*58","missing":"15*0*20","model":"14*0*46","modifications":"7*0*64","modify":"6*0*77,15*0*3p,16*0*4s","modifying":"8*0*cf,13*0*5a","monitor":"0*10*-1$j,3*10*-1$a,9*10*-1$m,11*10*-1$o,14*3*2g$2p$43$ds,16*0*2p,19*50*-1$-1$2$8$1b$1l","monitoring":"0*11*-1$d$1n,1*1*i$1l,6*10*-1$j,19*10*-1$e","more":"1*0*1t,2*1*a0$al,3*0*4s,5*2*15$25$8j,8*0*c9,9*0*1r,11*0*hm,13*2*29$2r$3v,14*1*6h$a4,15*0*aa,18*10*-1$c","most":"17*0*9o","multiple":"2*3*6e$76$at$b2,18*0*1n","must":"0*0*r,2*11*-1$m$12,3*3*t$1d$4k$98,6*13*-1$7$r$39$3u,8*1*q$64,9*0*17,11*16*-1$d$10$1d$1l$76$an$c3,13*5*1l$2l$3e$4g$87$97,14*2*3k$6j$d7,15*1*7i$d3,17*12*-1$d$3c$8g","mutually":"14*1*82$8e","mvs":"14*2*bm$c0$ej,18*0*8m","mvs_image":"14*2*bl$bv$ei,18*0*8l","na":"14*2*8i$8n$cd","name":"2*0*46,3*1*2q$2t,6*8*2u$32$35$3c$3e$41$4h$4q$4v,7*0*7s,8*1*2d$2j,11*0*8d,14*9*4j$5i$5n$5o$6l$bt$c9$cs$dh$di,15*0*c3,16*0*4b,17*1*5e$66,18*11*42$4c$4u$53$6a$6d$6q$77$7o$7v$8e$8h","names":"6*0*47,14*4*8q$8r$91$92$do","nature":"7*0*33","navigating":"0*0*2n,5*0*30,16*0*1d","navigation":"2*0*3d,3*0*2f,11*0*cq,17*0*b2","nbf":"8*0*5t","nd":"14*1*8j$8u","necessary":"7*0*2i,13*0*6k,16*0*47","need":"1*0*1j,3*10*-1$f,7*0*48,13*11*-1$p$3p,15*0*43,16*0*18,17*0*ab","needs":"8*0*3a","network":"3*0*4n,16*1*38$4q","new":"3*1*24$3c,5*0*7t,15*22*-1$6$k$p$5c$8b,17*0*9e","next":"0*9*2f,2*10*9n$be,3*9*a4,6*9*71,11*9*ii","nn":"14*2*8m$9j$9u","note":"2*3*3c$68$6v$92,3*3*2e$38$7s$8j,6*1*3s$3v,11*3*46$b9$cp$dh,14*0*e7,15*0*7g,17*1*3a$b1,18*1*2g$49","notes":"15*30*1$3","notification":"2*0*4o","notifications":"1*0*19,19*0*4n","november":"15*2*2b$c4$cc","now":"15*2*2l$3d$4m","nucleus":"13*0*1p","number":"3*2*1h$46$4c,6*2*5q$66$6k,11*2*7d$b1$hf,13*0*85,14*1*6q$7a,17*1*3l$8q","numerous":"19*0*3n","oa67541":"3*0*6a","object":"8*0*c2","occur":"7*0*1n,15*0*bj","occurs":"7*0*4n","october":"15*0*33","off":"3*2*6k$6q$83,13*0*51","offer":"18*10*-1$g","offers":"5*0*77,13*0*28","ok":"0*0*24,6*0*6m","once":"13*0*5g","one":"2*13*-1$p$2h$2v$52,3*0*37,5*0*14,11*0*4r,14*2*68$6g$ae,18*0*25","only":"3*0*8o,8*0*5r,14*4*6v$7f$7r$87$ee,18*0*4i","opd":"5*0*6q","open":"11*0*dt,16*0*1b","opening":"16*0*1p","operating":"3*0*67,11*0*3b,13*1*1e$at","option":"3*4*5n$6p$78$81$87,5*0*7r,11*1*7b$av,15*2*q$13$4o,17*1*3h$8o","optional":"2*5*8n,3*11*2v$4i$73,11*5*ea,13*0*1u,14*0*57","optionally":"2*0*4a","options":"2*3*6q$7v$a6$ah,5*0*7a,11*0*ar,17*0*8k,19*0*28","ord":"14*2*8h$9t$cc","order":"14*4*8t$94$9b$9i$9p,18*0*32","organizations":"10*0*n","os":"2*2*1b$1i$5h,3*1*12$19,5*12*-1$9$2j$7l,6*1*1g$1n,7*17*-1$f$1i$2s$3i$44$6i$74$7g,9*52*-1$-1$4$b$j$p$2b$2h,11*49*-1$3$9$i$18$53$5d$5p$bu$do$g1$hj$i3,12*11*-1$d$n,13*2*17$2d$8t,14*3*14$41$49$e1,15*21*-1$f$2q$3a$8h$a5$am$b2$bp$cl$db$di$dq,16*12*-1$i$3k$4j,17*41*-1$3$9$i$c8,19*31*-1$-1$-1$s$17$1a$1t","osmf":"0*14*-1$g$11$1a$1f$2c,6*23*-1$-1$e$m$1b$1u$23,8*4*16$6v$81$89$bp,9*13*-1$15$1f$1p$27,13*67*-1$5$b$l$13$19$1o$27$4e$4j$53$60$65$77$80,15*0*ai","other":"8*2*5h$68$b6,10*0*20,11*0*bl,18*0*4l,19*0*4q","outages":"1*0*1o","over":"8*3*83$8b$8i$al,10*0*3h","overall":"5*1*58$5f,15*1*6s$70","override":"11*0*4j","overview":"5*1*4d$4k,15*1*6d$6h","page":"0*10*-1$e,6*11*-1$k$7k,11*2*cl$d9$e1,15*0*9l,17*1*at$bh","panel":"2*18*-1$l$30$3o$43$47$4g$4n$4s$ag,18*10*-1$p,19*0*39","panels":"2*12*-1$9$2p$a5,3*0*3d,5*12*-1$e$17$1f,14*0*1j,19*1*2b$2v","parameter":"8*17*1c$21$2f$34$3s$4f$4o$5e$6l$7h$7u$98$9f$9r$a3$ag$b0$bh,13*2*6b$6c$6q,14*0*58","parameters":"8*43*-1$2$5$b$o$11$cg,13*1*ab$an","part":"14*0*6m","particular":"10*0*2o","particularly":"18*0*1k","partition":"14*0*b9","pass":"13*0*a7","passed":"2*0*bd","password":"3*1*8h$8l,11*0*ch,15*0*47,17*0*ap","pat":"14*0*6d","path":"3*2*47$4d$4h,8*4*48$9a$9k$9t$a8,11*0*3e,13*1*8j$b0,18*1*5m$6u","pattern":"14*0*6e","patterns":"14*0*6i,19*0*2k","pcie":"5*0*72","pdf":"12*40*-1$0$2$i,15*1*2u$31","per":"15*1*5b$8a","percentage":"10*1*3v$4h","perform":"0*0*2i,2*2*2g$2s$33,6*1*2l$74,11*2*5k$60$c4,17*1*1q$92","performance":"5*1*5j$5p,9*10*-1$n,10*0*1d,14*1*a2$dq,15*1*49$73,19*10*-1$1o","performing":"7*0*2d,11*0*el","perfrom":"17*0*22","period":"8*0*4u,14*2*au$bs$c6","permissions":"13*0*3s","personalized":"5*0*1q","physical":"14*1*b6$bh","picker":"2*0*7m","piecing":"19*0*2s","pipeline":"2*0*bg","place":"13*0*8f","placeholders":"18*10*-1$r","planning":"10*0*14","platform":"19*20*-1$-1$d$1h","platforms":"11*0*bn,15*0*b5","plot":"16*1*2o$32","plugin":"2*1*1d$1j,3*1*14$1a,5*13*-1$b$2l$7n$7v,6*1*1i$1o,7*46*-1$2$5$h$1k$2u$3k$46$76$7i,9*1*2c$2i,11*54*-1$4$a$k$54$5e$5q$66$7e$b2$bv$dq$e5$eg$g3$hl$i5$ib,12*10*-1$f,14*0*16,15*19*-1$h$2s$3c$8i$an$b3$br$cn$dd$ds,16*12*-1$k$3m$4l,17*61*-1$-1$4$a$k$14$1k$1t$2c$3j$3u$4m$5v$8r$9d$a8$ca,19*11*-1$u$1v","plugin's":"17*0*3i","plugins":"11*11*20$29$4c$4g$4o$6v$9f$a7$ab$co$d8$e0,17*5*35$78$80$84$b0$bg","pluginurl":"11*1*6d$7a,17*2*2j$3g$40","points":"1*0*23","port":"3*2*1g$45$4b,6*4*5p$5v$61$65$6j,13*1*6u$84","port_number":"3*1*44$4a","powerful":"18*10*-1$9","practice":"3*0*7k,10*0*l","pre":"5*0*1d","pre-configured":"5*0*1c","precise":"16*0*15","prerequisite":"13*0*v","prerequisites":"6*1*13$16,9*1*20$22,13*40*-1$0$6$n","preselected":"3*0*3h","present":"2*10*-1$e,8*0*3b","presentation":"5*0*7c","presented":"2*0*6t,3*0*7d","prevent":"7*0*2k,8*0*b1","preview":"2*0*8g","privatekey":"8*0*a9","problem":"7*10*-1$v","problems":"7*0*5i,16*0*2f","proc":"5*0*45","procedure":"0*9*16,2*9*28,3*9*1j,6*9*1q,11*9*1p,17*9*24"}; +return {"exclude":"3*0*4l","exclusive":"14*1*83$8f","executing":"14*0*i","execution":"5*1*4m$4s,15*1*8b$8e","existing":"2*0*7a,17*0*4o","exp":"8*0*5s","expect":"8*0*5b","expect_claims":"8*0*5a","experience":"10*0*38,15*0*7l","explains":"15*0*c2","explore":"19*10*-1$k","extended":"10*0*3i","facility":"5*1*4c$4j,7*0*6l,9*40*-1$6$d$l,13*1*2f$8v,14*2*4c$bc$e4,15*3*85$89$c0$fh,19*10*-1$15","false":"8*4*29$7b$7p$aq$c7","familiar":"11*0*1m","faster":"8*0*50,10*1*2h$37","feature":"1*10*-1$6,10*0*31","features":"3*0*ai,5*0*8n,13*0*1j,15*10*-1$7,17*0*9s,19*0*22","february":"15*0*ak","fetch":"0*0*30,11*0*ip,19*0*3t","fetched":"10*0*2s","fetching":"14*10*-1$b","field":"2*0*49,3*3*2u$3v$59$95,6*4*33$37$4t$60$63,14*1*3r$de","fields":"3*3*3l$3o$8i$8m,15*0*5b","file":"7*0*55,8*5*3q$46$96$9c$a0$ci,11*7*2e$2m$2t$39$3g$f2$f4$ga,12*10*-1$j,13*4*8e$9u$af$ar$b2,15*0*4o","files":"13*2*5e$67$6n,17*0*4p","filter":"14*3*5q$5r$6b$cb,18*22*3k$3o$3t$7e$7j$85$8k","filters":"14*0*v","find":"8*10*-1$8,11*0*i8,12*10*-1$6,14*0*dm,16*1*14$1i,17*0*a1","first":"5*0*2m,15*0*eh","fix":"16*0*2e","fixed":"15*12*1s$2a$3m$40$48$63$6o$7m$ao$b0$bf$dt$e9","flat":"15*0*27","flexible":"5*0*10","flows":"9*0*1k","focus":"14*0*5t","follow":"11*0*fk","following":"0*0*2j,2*2*15$2k$4v,3*0*3k,5*1*35$7d,6*2*u$2m$75,7*2*1u$6o$7m,8*1*k$ck,9*0*1g,10*0*3s,11*8*13$4u$63$7m$85$aq$c5$em$gq,13*1*r$8g,14*3*20$5d$69$af,15*4*7q$9p$bo$ep$f6,16*0*25,17*5*29$50$5h$5s$8j$93,19*0*21","follows":"11*1*3a$f5,13*1*6r$as,14*1*32$cl,18*1*3u$7k","format":"2*10*-1$j,3*1*40$72,13*0*6o","forwarded":"8*0*2t","found":"10*0*2q,15*8*2c$42$4a$65$6q$7o$bh$dv$eb","frame":"8*0*bs","freedom":"19*0*36","friendly":"14*0*1a","from":"0*13*-1$b$1u$2a$32,2*4*3v$55$5p$6l$7d,3*0*60,5*2*1v$7h$8g,6*13*-1$h$2f$59$7h,7*1*3e$7a,8*2*44$4l$b3,9*11*-1$13$1n,10*1*2l$2v,11*1*gh$ir,14*13*-1$e$1n$25$51,15*2*22$34$c9,16*0*3e,18*8*18$43$5d$5p$67$6k$71$7p$8b,19*1*3v$5e","function":"13*2*4v$5j$8q","functionalities":"17*10*-1$q","functionality":"11*0*1b","functioning":"7*0*2o","functions":"3*0*51","fundamental":"13*0*1c","further":"16*0*23","gather":"16*0*1r","general":"5*1*4v$55,15*1*8g$8j,18*1*3p$7f","gf":"11*2*4b$9d$a6,17*1*76$7v","gf_plugins_allow_loading_unsigned_plugins":"11*1*4a$a5,17*0*7u","github":"11*3*6g$9h$f8$gk,15*1*eq$eu,17*2*2m$43$7a","given":"14*0*75","global":"14*0*aj","go":"2*0*3q,3*0*1k,11*1*7j$cm,17*1*4t$au","gpg":"11*4*ej$ev$fq$gu$hp","gpm":"7*0*6f","grafana":"0*44*-1$1$4$9$u$14$1p$29,1*13*-1$4$h$1e$25,2*11*1c$1k$1p$3j$5m$8d$9o$aa$ao$b4$bh$bt,3*14*-1$d$13$1b$2l$5b,5*15*-1$a$t$2c$2k$7m$8r,6*62*-1$-1$1$4$9$g$18$1h$1p$2r$2v$4k$58$5s$6r$79$7m$7q,7*16*-1$g$1j$2t$3j$45$75$7h,8*51*-1$0$3$j$v$1g$6q$76$8f$8t$aj$bm$cd$cm$cs,9*49*-1$0$7$11$1c$1m$24$2d$2j$2l$2q$2t$30,10*11*-1$6$22,11*80*-1$5$b$j$1h$1o$2h$34$3r$3s$43$44$5f$5s$68$6a$6o$6s$7h$7r$82$8g$8l$91$96$9p$9t$b6$c0$cb$ci$d0$dp$e2$ef$fe$g2$g7$ge$h4$ha$hk$i4$j7,12*11*-1$e$o,13*73*-1$2$8$h$2j$2n$2u$33$37$3l$45$5t$95$99$a4$aj$al$bd$be$bl$bm,14*13*-1$8$15$1i$ec,15*22*-1$g$t$4k$54$ac$at$bq$c8$dj$en$fd$fs$fv,16*13*-1$j$3f$3l$4k,17*65*-1$5$b$j$1f$1l$1u$26$2e$2g$2u$32$4b$4f$4r$59$5d$5q$69$6e$6q$6v$7i$7m$8v$aj$aq$b8$c9,18*2*3e$90$94,19*63*-1$-1$-1$5$b$c$t$1g$1u$3k$4k","grafana's":"18*0*3d","graphs":"15*0*29,19*0*29","greater":"3*0*99","grep":"7*0*7u","guidance":"15*0*cn","guide":"11*1*fs$hr,12*41*-1$1$3$h$q,13*1*2h$91,14*0*4f,15*0*4r","guides":"16*10*-1$5","h2":"8*1*9i$a6","hard":"18*10*-1$k","hard-coded":"18*10*-1$j","has":"7*1*27$34,15*5*v$1q$2l$71$7g$a0","have":"0*1*s$27,2*2*13$96$9g,3*1*u$9t,6*1*s$6p,8*0*73,10*0*1t,11*1*11$hu,14*0*9n,15*1*6g$f5,17*0*c3,18*1*1m$2k,19*0*35","header":"2*0*41,8*2*1v$2c$2i,13*0*9e","header's":"8*0*2h","header_name":"8*0*2b","health":"10*0*1e,19*10*-1$1n","help":"4*20*2,7*11*-1$r$4t,15*0*d5,19*0*2d","helps":"14*0*5s,19*0*3r","hi":"14*1*7p$8g","higher":"11*0*1f,14*0*73","highest":"14*0*7s","highly":"5*0*v","historical":"10*43*-1$0$3$a$i$s$16","holds":"8*0*2k","home":"15*0*ba","host":"6*2*4g$4p$4u,10*0*3r","hosted":"6*0*5u,8*0*ai","hostname":"3*3*1f$43$49$7g,11*0*8i,13*1*6t$7t,17*0*6b,18*3*5h$5t$6o$75","how":"16*10*-1$6,18*0*8p","however":"3*1*4p$7j,13*0*1g","hsm":"5*0*5c","html":"8*0*bq","http":"3*3*3m$42$62$6l,8*1*4m$92,13*0*9d,15*0*32","https":"3*0*48,6*0*5j,8*6*84$8c$8j$93$9h$a5$am,11*3*6f$9g$f7$gj,13*2*6s$7b$7i,15*0*et,17*2*2l$42$79","https://abc.com:12345":"13*0*7a","https://abc.com:12345/jwt/ibm/api/zosmfbuilder/jwk":"13*0*7h","https://github.com/ibm/rmf":"15*0*es","https://github.com/ibm/rmf/blob/main/grafana/rmf-app/public_key.asc":"11*0*f6","https://github.com/ibm/rmf/releases":"11*0*gi","https://github.com/ibm/rmf/releases/download/ibm-rmf-grafana/v1.0.3/ibm-rmf-grafana-1.0.3.zip":"17*0*41","https://github.com/ibm/rmf/releases/download/ibm-rmf-grafana/v/ibm-rmf-grafana-.zip":"11*0*6e,17*0*2k","hub":"11*0*bq","iat":"8*0*5u","ibm":"0*0*2p,2*2*18$24$5e,3*1*1m$28,5*12*-1$6$32$7i,6*0*1d,7*16*-1$c$1f$2p$3f$41$71$7d,9*40*-1$2$9$h,11*39*-1$f$21$23$26$6i$6m$6q$72$9j$9n$9r$a1$ac$ae$ah$bh$db$dl$du$ed$fa$fu$g5$gc$gm$h2$h8$hg$i0$i9,12*11*-1$a$k,13*1*70$7n,14*31*0$4$11,15*23*-1$c$p$4g$50$5c$5k$b4$bc$bs$df$ej$f0$f9$fo,16*14*-1$f$1e$21$3h$4g,17*26*-1$f$2o$2s$30$38$45$49$4d$7c$7g$7k$7q$85$87$8a$bj$c5,19*11*-1$p$1q","ibm-rmf":"11*1*71$a0,17*1*37$7p","ibm-rmf-grafana-x.y.z.zip":"11*1*g4$h7","ibm-rmf-grafana-x.y.z.zip.asc":"11*1*gb$h1","icon":"2*1*4p$88,5*1*85$8e","id":"7*1*4r$57,8*0*6t","identical":"6*0*4d,18*0*1o","identifies":"1*0*14","identify":"2*0*29,7*12*-1$t$4v$5p,8*0*35","iframe":"8*0*bu","ignored":"3*0*6d","iii":"0*10*-1$k,3*10*-1$b,11*10*-1$p,14*3*2h$2q$44$dt,19*40*-1$3$9$1c","iip":"14*0*bk","image":"2*0*50,5*2*59$5g$7e,11*2*ak$b4$b7,14*2*bn$c1$ek,15*1*8m$8q,17*2*8d$8t$90,18*0*8n","images":"11*2*bd$bg$bk","immediately":"7*0*2f","import":"5*0*82,15*0*9e,17*4*99$9j$ae$bs$bv","importance":"10*0*q","important":"3*0*4e,18*1*2d$2f","imported":"5*0*2q","importing":"11*0*fm","improve":"15*0*7j","improved":"15*0*61","improves":"15*0*3d","incidents":"1*0*1s","include":"15*1*9o$bn","included":"15*0*ae","including":"6*0*3k,19*0*3d","incoming":"1*0*o","index":"5*1*5k$5q,15*0*8t","indicative":"7*0*3l","individual":"13*0*aa","information":"1*0*1u,2*1*a1$am,3*0*ac,5*1*26$8k,7*12*-1$q$3p$3q,8*13*-1$9$53$5n$ca,9*0*1s,11*5*hn$j6,13*3*2a$2s$40$8m,14*1*3h$d4,15*1*ag$cm,16*2*p$16$1u","informs":"7*0*3s","ini":"11*5*2l$2s$31$3n$3t$45,13*3*ad$b9$bf$bn","insights":"10*0*1a","install":"5*0*2g,9*0*28,11*15*-1$e$50$65$70$9e$dk,13*11*2i$2m$a3,17*3*1e$36$3q$77","installation":"11*0*2i,15*0*ch","installed":"2*1*17$3m,3*1*v$2o,6*0*1c,11*5*15$1g$7f$b3$d3$hv,13*0*1b,17*0*bb","installing":"2*0*1f,3*0*16,6*0*1k,9*0*2e,11*32*0$6$5a$5m,13*1*15$32,15*0*co,17*10*-1$10","instance":"8*1*ak$ce","instead":"18*0*1r","instructions":"11*0*fl,13*0*31,15*0*c6","integer":"14*3*7q$7u$86$8a","integration":"19*0*3m","interactive":"14*0*dp,18*10*-1$d,19*10*-1$n","interacts":"5*0*1t","interest":"14*0*60","interface":"2*0*3f,3*0*2h,5*0*76,11*0*cs,15*0*7d,17*0*b4","internally":"15*8*2b$41$49$64$6p$7n$bg$du$ea","interval":"10*0*43","introduction":"1*30*0$2","invalid":"11*0*e4","investigate":"0*10*-1$h","investigation":"16*0*24","involves":"14*0*l","ioq":"5*0*5m","ip":"6*2*4i$4r$50","iss":"8*1*6a$6e","issue":"7*1*52$79,15*0*b3,16*0*1l","issued":"7*0*66","issues":"1*11*-1$d$16,7*12*-1$9$19$5q,15*13*-1$b$aq$da$e7,16*43*-1$1$3$a$s$29$2g","it's":"7*0*4d,18*0*2e","its":"3*0*ah,13*1*1i$34,14*0*1f,17*10*-1$o,19*0*3e","jes":"5*0*5v","job":"10*0*45,14*0*b2","json":"8*3*3v$45$4a$5l,13*14*48$4n$6f$8d$8l$9n","json-encoded":"8*0*5k","jti":"8*0*6d","june":"15*0*78","jwk":"8*0*3o,13*3*66$6m$73$7q","jwk_set_file":"8*0*3n","jwks":"8*0*49,13*2*8c$8k$9r","jwks.json":"13*0*8b","jwksuri":"13*3*6a$6p$7g$8a","jwt":"8*18*-1$h$t$19$1e$2q$3c$3g$7j$cp,13*28*4b$4q$4u$58$5i$5n$6v$7m$8p$93$9b$ah","keep":"1*0*m","key":"8*3*41$9p$9v$aa,11*4*ek$et$f1$fi$fo,13*1*6h$9p","know":"3*0*1e","known":"15*10*-1$a","label":"18*6*4e$5c$5o$66$6j$70$8a","language":"2*0*64","languages":"2*1*21$27,14*30*3$7","later":"11*0*1j,13*0*2q,15*0*g1","latest":"15*0*9h,16*0*o,17*10*-1$12","lax":"8*0*bb","lb":"14*0*6p","lead":"1*0*1q","learn":"18*0*8o","least":"2*11*-1$o$2u","level":"3*1*69$6g,11*0*1c,14*0*5m","leverage":"17*10*-1$n","lib":"11*0*95,17*0*6u","limited":"18*1*4d$4g","line":"15*0*28","link":"12*10*-1$7","linux":"11*0*3o,13*0*ba","linuxone":"11*0*bi","list":"0*0*22,2*4*5t$6m$7j$7q$bq,6*1*2k$5g,14*10*55$63$6n$70$7g$7v$8b$8p$90$97$9e,18*2*1c$2s$31,19*0*5i","listed":"3*0*7h,11*0*ic","lists":"5*0*37,8*0*m,9*0*1i","lo":"14*1*84$85","loaded":"8*0*43","loading":"11*3*1u$4e$4m$a9,17*0*82","local":"11*0*41,13*1*9t$bj","location":"11*1*37$f3,13*0*ap","locksp":"5*0*67","locksu":"5*0*6g","log":"0*0*1d,6*0*21,7*0*54","logged":"0*0*1i,6*0*26","login":"8*2*1p$24$7f","logs":"7*1*7c$7p","longer":"5*0*89,15*0*5r","looking":"7*0*5r","lower":"7*0*5c,14*2*6s$76$7j","lowest":"14*0*88","macos":"11*0*3u,13*0*bg","made":"2*1*97$9c","main":"11*0*fd","maintenance":"3*1*68$6f,18*0*1j","make":"3*0*32,18*0*u","making":"10*0*11","manage":"18*0*8s","management":"9*40*-1$5$c$k,13*3*2e$3i$43$8u,15*0*bv","managing":"5*0*29","mandatory":"8*0*39","manual":"1*0*1k","many":"13*0*24","master":"3*1*a9$af,5*43*-1$1$4$i$3k$7f$8h","match":"14*0*6k","maximizes":"14*0*1e","may":"7*1*1b$6t,10*0*3m,15*1*l$db,16*11*-1$b$t","mb":"3*0*91","means":"3*0*5r,10*0*23","measurement":"7*0*6k,14*1*4b$e3,15*0*fg,19*10*-1$14","measures":"7*0*2j","meet":"5*0*1k","megabytes":"15*0*6m","mention":"8*0*3e","mentioned":"17*0*4k","menu":"2*0*59,6*0*7g","message":"3*0*9m,7*2*3d$3r$84,11*0*e8","messages":"7*15*-1$n$12$65$6e$6m$6r","met":"19*0*4v","methods":"11*1*4s$58,17*0*1h","metric":"10*1*1m$3a,14*14*2a$2s$30$37$4h$4k$4v,18*10*-1$n","metric_description":"14*1*36$4g","metrics":"0*10*-1$l,1*0*p,3*10*-1$c,10*0*27,11*10*-1$q,14*0*2i,16*0*2q,19*40*-1$4$a$1d","might":"3*0*4q","minimum":"8*0*n","minutes":"8*0*58","missing":"15*0*3p","model":"14*0*46","modifications":"7*0*64","modify":"6*0*77,15*0*5i,16*0*4s","modifying":"8*0*cf,13*0*5a","monitor":"0*10*-1$j,3*10*-1$a,9*10*-1$m,11*10*-1$o,14*3*2g$2p$43$ds,16*0*2p,19*50*-1$-1$2$8$1b$1l","monitoring":"0*11*-1$d$1n,1*1*i$1l,6*10*-1$j,19*10*-1$e","more":"1*0*1t,2*1*a0$al,3*0*4s,5*2*15$25$8j,8*0*c9,9*0*1r,11*0*hm,13*2*29$2r$3v,14*1*6h$a4,15*0*c3,18*10*-1$c","most":"17*0*9o","multiple":"2*3*6e$76$at$b2,18*0*1n","must":"0*0*r,2*11*-1$m$12,3*3*t$1d$4k$98,6*13*-1$7$r$39$3u,8*1*q$64,9*0*17,11*16*-1$d$10$1d$1l$76$an$c3,13*5*1l$2l$3e$4g$87$97,14*2*3k$6j$d7,15*1*9b$f4,17*12*-1$d$3c$8g","mutually":"14*1*82$8e","mvs":"14*2*bm$c0$ej,18*0*8m","mvs_image":"14*2*bl$bv$ei,18*0*8l","na":"14*2*8i$8n$cd","name":"2*0*46,3*1*2q$2t,6*8*2u$32$35$3c$3e$41$4h$4q$4v,7*0*7s,8*1*2d$2j,11*0*8d,14*9*4j$5i$5n$5o$6l$bt$c9$cs$dh$di,15*0*ds,16*0*4b,17*1*5e$66,18*11*42$4c$4u$53$6a$6d$6q$77$7o$7v$8e$8h","names":"6*0*47,14*4*8q$8r$91$92$do","nature":"7*0*33","navigating":"0*0*2n,5*0*30,16*0*1d","navigation":"2*0*3d,3*0*2f,11*0*cq,17*0*b2","nbf":"8*0*5t","nd":"14*1*8j$8u","necessary":"7*0*2i,13*0*6k,16*0*47","need":"1*0*1j,3*10*-1$f,7*0*48,13*11*-1$p$3p,15*0*5s,16*0*18,17*0*ab","needs":"8*0*3a","network":"3*0*4n,16*1*38$4q","new":"3*1*24$3c,5*0*7t,15*22*-1$6$k$2i$75$a4,17*0*9e","next":"0*9*2f,2*10*9n$be,3*9*a4,6*9*71,11*9*ii","nn":"14*2*8m$9j$9u","note":"2*3*3c$68$6v$92,3*3*2e$38$7s$8j,6*1*3s$3v,11*3*46$b9$cp$dh,14*0*e7,15*0*99,17*1*3a$b1,18*1*2g$49","notes":"15*30*1$3","notification":"2*0*4o","notifications":"1*0*19,19*0*4n","november":"15*2*44$e1$ed","now":"15*2*4e$56$6f","nucleus":"13*0*1p","number":"3*2*1h$46$4c,6*2*5q$66$6k,11*2*7d$b1$hf,13*0*85,14*1*6q$7a,15*0*1m,17*1*3l$8q","numerous":"19*0*3n","oa67541":"3*0*6a","object":"8*0*c2","occur":"7*0*1n,15*0*dc","occurs":"7*0*4n","october":"15*0*4s","off":"3*2*6k$6q$83,13*0*51","offer":"18*10*-1$g","offers":"5*0*77,13*0*28","ok":"0*0*24,6*0*6m","once":"13*0*5g","one":"2*13*-1$p$2h$2v$52,3*0*37,5*0*14,11*0*4r,14*2*68$6g$ae,18*0*25","only":"3*0*8o,8*0*5r,14*4*6v$7f$7r$87$ee,18*0*4i","opd":"5*0*6q","open":"11*0*dt,16*0*1b","opening":"16*0*1p","operating":"3*0*67,11*0*3b,13*1*1e$at","optimize":"15*0*12","option":"3*4*5n$6p$78$81$87,5*0*7r,11*1*7b$av,15*2*2j$2s$6h,17*1*3h$8o","optional":"2*5*8n,3*11*2v$4i$73,11*5*ea,13*0*1u,14*0*57","optionally":"2*0*4a","options":"2*3*6q$7v$a6$ah,5*0*7a,11*0*ar,17*0*8k,19*0*28","ord":"14*2*8h$9t$cc","order":"14*4*8t$94$9b$9i$9p,18*0*32","organizations":"10*0*n","os":"2*2*1b$1i$5h,3*1*12$19,5*12*-1$9$2j$7l,6*1*1g$1n,7*17*-1$f$1i$2s$3i$44$6i$74$7g,9*52*-1$-1$4$b$j$p$2b$2h,11*49*-1$3$9$i$18$53$5d$5p$bu$do$g1$hj$i3,12*11*-1$d$n,13*2*17$2d$8t,14*3*14$41$49$e1,15*22*-1$f$s$4j$53$aa$bu$cf$cr$di$em$fc$fj$fr,16*12*-1$i$3k$4j,17*41*-1$3$9$i$c8,19*31*-1$-1$-1$s$17$1a$1t","osmf":"0*14*-1$g$11$1a$1f$2c,6*23*-1$-1$e$m$1b$1u$23,8*4*16$6v$81$89$bp,9*13*-1$15$1f$1p$27,13*67*-1$5$b$l$13$19$1o$27$4e$4j$53$60$65$77$80,15*0*cb","other":"8*2*5h$68$b6,10*0*20,11*0*bl,18*0*4l,19*0*4q","outages":"1*0*1o","over":"8*3*83$8b$8i$al,10*0*3h","overall":"5*1*58$5f,15*1*8l$8p","override":"11*0*4j","overview":"5*1*4d$4k,15*1*86$8a","page":"0*10*-1$e,6*11*-1$k$7k,11*2*cl$d9$e1,15*0*be,17*1*at$bh","panel":"2*18*-1$l$30$3o$43$47$4g$4n$4s$ag,15*0*1f,18*10*-1$p,19*0*39","panels":"2*12*-1$9$2p$a5,3*0*3d,5*12*-1$e$17$1f,14*0*1j,15*0*1j,19*1*2b$2v","parameter":"8*17*1c$21$2f$34$3s$4f$4o$5e$6l$7h$7u$98$9f$9r$a3$ag$b0$bh,13*2*6b$6c$6q,14*0*58","parameters":"8*43*-1$2$5$b$o$11$cg,13*1*ab$an","part":"14*0*6m","particular":"10*0*2o","particularly":"18*0*1k","partition":"14*0*b9","pass":"13*0*a7","passed":"2*0*bd","password":"3*1*8h$8l,11*0*ch,15*0*60,17*0*ap","pat":"14*0*6d","path":"3*2*47$4d$4h,8*4*48$9a$9k$9t$a8,11*0*3e,13*1*8j$b0,18*1*5m$6u","pattern":"14*0*6e","patterns":"14*0*6i,19*0*2k","pcie":"5*0*72","pdf":"12*40*-1$0$2$i,15*1*4n$4q","per":"15*1*74$a3","percentage":"10*1*3v$4h","perform":"0*0*2i,2*2*2g$2s$33,6*1*2l$74,11*2*5k$60$c4,17*1*1q$92","performance":"5*1*5j$5p,9*10*-1$n,10*0*1d,14*1*a2$dq,15*1*62$8s,19*10*-1$1o","performing":"7*0*2d,11*0*el","perfrom":"17*0*22","period":"8*0*4u,14*2*au$bs$c6","permissions":"13*0*3s","personalized":"5*0*1q","physical":"14*1*b6$bh","picker":"2*0*7m","piecing":"19*0*2s","pipeline":"2*0*bg","place":"13*0*8f","placeholders":"18*10*-1$r","planning":"10*0*14","platform":"19*20*-1$-1$d$1h","platforms":"11*0*bn,15*0*cu","plot":"16*1*2o$32","plugin":"2*1*1d$1j,3*1*14$1a,5*13*-1$b$2l$7n$7v,6*1*1i$1o,7*46*-1$2$5$h$1k$2u$3k$46$76$7i,9*1*2c$2i,11*54*-1$4$a$k$54$5e$5q$66$7e$b2$bv$dq$e5$eg$g3$hl$i5$ib,12*10*-1$f,14*0*16,15*20*-1$h$u$4l$55$ab$cg$cs$dk$eo$fe$ft,16*12*-1$k$3m$4l,17*61*-1$-1$4$a$k$14$1k$1t$2c$3j$3u$4m$5v$8r$9d$a8$ca,19*11*-1$u$1v","plugin's":"17*0*3i","plugins":"11*11*20$29$4c$4g$4o$6v$9f$a7$ab$co$d8$e0,17*5*35$78$80$84$b0$bg","pluginurl":"11*1*6d$7a,17*2*2j$3g$40","points":"1*0*23,15*1*1o$20","port":"3*2*1g$45$4b,6*4*5p$5v$61$65$6j,13*1*6u$84","port_number":"3*1*44$4a","powerful":"18*10*-1$9","practice":"3*0*7k,10*0*l","pre":"5*0*1d","pre-configured":"5*0*1c","precise":"16*0*15","prerequisite":"13*0*v","prerequisites":"6*1*13$16,9*1*20$22,13*40*-1$0$6$n","preselected":"3*0*3h","present":"2*10*-1$e,8*0*3b","presentation":"5*0*7c","presented":"2*0*6t,3*0*7d","prevent":"7*0*2k,8*0*b1","preview":"2*0*8g","privatekey":"8*0*a9","problem":"7*10*-1$v","problems":"7*0*5i,16*0*2f","proc":"5*0*45","procedure":"0*9*16,2*9*28,3*9*1j,6*9*1q,11*9*1p,17*9*24","procedures":"17*0*18"}; }); \ No newline at end of file diff --git a/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-3.js b/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-3.js index 28363a6f..a0ffca93 100644 --- a/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-3.js +++ b/docs/grafana/rmf-app/oxygen-webhelp/app/search/index/index-3.js @@ -1,4 +1,4 @@ define(function () { // Auto generated index for searching. -return {"procedures":"17*0*18","process":"14*0*k,15*1*12$8q","processor":"10*1*48$4k,14*0*bd","procu":"5*0*4g","produces":"2*0*ba","profiles":"8*1*6p$75","programmer":"14*0*4e","programmer's":"14*0*4d","protocol":"8*2*7s$9e$a2","provide":"2*0*4e,6*0*3a,10*0*36,15*1*8m$ar,16*0*1v","provided":"3*0*65,6*0*12,9*0*1v,13*0*3k,15*0*bb","provides":"1*10*-1$7,2*2*8e$9p$bi,5*11*-1$c$u,8*0*22,10*0*18,14*0*17,19*11*-1$v$20","proxy":"3*0*54,8*0*1u,16*2*34$45$4t","public":"11*3*es$f0$fh$fn","public_key.asc":"11*0*er","publish":"11*0*98,17*0*71","purposes":"10*0*p,18*0*4m","qualifications":"14*1*39$56","qualify":"14*0*a0","queries":"2*0*6f,5*0*1h,10*0*1o,14*12*-1$9$1s$22,18*10*-1$o,19*0*3i","query":"2*18*-1$q$20$26$5v$62$63$6c$89$8i,10*0*2a,14*56*2$6$j$1c$2b$2d$2k$2m$2t$31$cg$ck,18*51*2$6$3h$3m$3r$7d$7i","quickly":"7*1*15$4u","range":"2*1*7u$9q,10*0*4o","ranges":"2*0*84,10*11*-1$g$3k","re":"5*0*81,15*1*45$7k,17*4*98$9i$ad$br$bu","re-enter":"15*0*44","re-import":"5*0*80,15*0*7j,17*4*97$9h$ac$bq$bt","real":"1*10*-1$e","receiving":"7*0*3b","recommended":"8*0*8d","refer":"1*0*24,2*2*a9$an$bs,3*0*a7,5*1*2b$8q,8*0*cj,11*0*ho,13*3*2b$2t$41$8r,18*0*93","referring":"7*0*53,17*0*a6","refresh":"2*0*86","regularly":"16*0*m","related":"11*5*j5,15*0*92","relative":"2*0*7s,10*11*-1$e$4m","release":"15*31*0$2$ch,17*0*a5","releases":"11*2*6k$9l$go,17*2*2q$47$7e","relevant":"14*0*u","reliable":"1*10*-1$8","remember":"3*0*96,11*1*74$al,17*0*8e","remove":"5*0*8f,6*0*78,17*0*5j","rename":"11*0*2u","replace":"11*1*77$ao,17*1*3d$8h,18*10*-1$i","replaces":"17*0*4n","report":"2*0*5d,10*0*42,11*1*28$aj,14*21*2j$b0$bq$c4$cf$cj$cp$cr$dg$dj$dn$e5$en$eq,15*0*3l,17*0*8c","report_name":"14*1*cq$df","reporting":"5*12*-1$o$3d$3q,7*30*1$4","reports":"0*10*-1$m,11*10*-1$r,14*1*2r$eb,16*0*2u,19*11*-1$1e$2c","repository":"15*0*cq","request":"14*0*a1,15*0*18","requested":"14*1*3i$d5","requesting":"14*0*62","requests":"3*0*5u,10*0*26","require":"2*10*-1$n,10*0*3n","required":"3*0*4r,5*0*8a,6*1*36$62,11*0*bm,14*0*al,16*0*1t","requirements":"2*0*ak,5*0*1m,11*0*57,15*20*-1$9$b8$d1,19*0*3c","research":"10*0*12","resolutions":"16*1*2a$2i","resolve":"15*0*bf","resolved":"7*0*37,15*0*c8","resource":"0*11*-1$c$1m,6*14*-1$i$31$34$3d$40,7*0*6j,14*16*34$3c$3f$3p$3t$45$4a$4m$4q$5j$5p$cn$cv$d2$dc$e2$ef,15*0*de,18*11*44$4f$4h$5e$5q$68$6c$6l$72$7q$8c$8g,19*10*-1$13","resource_name":"18*1*6b$8f","resource_type":"14*5*33$3b$3o$cm$cu$db","resources":"10*1*1g$3q","respond":"1*10*-1$b","response":"5*1*5s$62,7*0*4c,15*1*76$79","restart":"11*1*7g$8p,17*1*4q$6i","result":"2*0*bb","resulting":"3*0*6r","results":"0*9*25,2*9*8j$9e,3*9*9r,6*9*6n,11*9*de$hs,17*9*bm$c1","retrieval":"8*0*52,15*0*1i","retrieve":"14*4*s$1k$23$2e$2n","retrieved":"8*0*4k","returned":"14*3*78$7o$81$8d","reverse":"3*0*53","review":"13*0*3f","rm":"17*0*5n","rmf":"0*13*-1$i$2q$2t$39,2*50*-1$2$6$g$19$1g$1m$1s$22$25$5f$65$8a$9j,3*59*-1$-1$1$5$9$m$10$17$1n$1p$29$5t$9v$a8$ae,5*90*-1$-1$-1$-1$-1$0$3$7$f$l$n$p$2h$33$3a$3c$3e$3j$3m$3p$3s$7j,6*1*1e$1l,7*16*-1$d$1g$2q$3g$42$72$7e,9*1*29$2f,11*91*-1$-1$1$7$g$n$16$22$24$27$51$5b$5n$6j$6n$6r$73$81$8f$8k$90$9k$9o$9s$a2$ad$af$ai$bs$d5$dc$dm$dv$ee$fb$ff$fv$g6$gd$gn$h3$h9$hh$i1$ia$im$j2,12*11*-1$b$l,14*47*-1$1$5$f$12$1b$1o$27$2f$2o$42,15*28*-1$d$15$1q$2o$38$3k$3s$55$84$8f$9c$9k$ak$b0$bn$cj$d0$d9$do,16*15*-1$g$2j$2t$2v$3i$4h,17*63*-1$1$7$g$2p$2t$31$39$46$4a$4e$58$5c$5p$68$6d$6p$7d$7h$7l$7r$86$88$8b$bd$bk$c6,18*32*0$4$3f$7h,19*53*-1$-1$1$7$q$18$1r$4i$56","rmf-grafana":"11*1*8e$8j,17*4*57$5b$5o$67$6c","rmf-grafana-data":"11*1*80$8v,17*0*6o","root":"7*0*50","row":"2*0*6s","rows":"5*0*16","rs2":"14*0*ca","rs21":"14*1*bu$c8","run":"7*0*7l,11*6*62$7l$84$88$8b$gp$jb,17*4*28$4v$5g$5r$64","running":"13*0*79,17*0*61","runs":"13*0*82","same":"10*0*29","samesite":"8*0*au","save":"2*1*90$99,3*0*9h,10*0*33,13*0*88,15*0*3v","scenarios":"15*0*1v","seamlessly":"5*0*1s","search":"3*0*27,11*1*d6$dd,16*0*11,17*1*be$bl","seconds":"3*0*58","section":"3*0*3n,6*0*14,8*0*10,11*2*2a$fp$if,13*0*44,15*0*ap,16*10*-1$4","sections":"8*0*cl,13*0*s","secure":"3*0*7m,6*0*5m,8*1*8l$ae","security":"8*0*ab,15*0*c9","see":"0*1*12$37,2*2*1e$1q$23,3*0*15,6*2*15$1j$7o,11*0*j0,13*0*ak,15*1*1o$30","select":"0*0*1o,2*3*51$6j$79$7r,6*1*57$5h,18*7*3v$5b$5n$65$6i$6v$7l$89","selected":"14*0*4l","selecting":"18*0*16,19*0*5c","sends":"1*0*18","sensitive":"4*20*1,6*0*43","separate":"18*0*1t","separated":"14*0*5f","sequentially":"2*0*b7","series":"5*12*-1$r$3g$3u,15*0*25,16*1*2l$3p","server":"0*3*v$15$1q$35,3*10*-1$j,5*0*23,6*46*-1$2$5$a$2s$30$4l$5t$6s$7a,7*2*5l$69$6d,8*3*1h$77$7r$8u,9*0*2r,11*1*7i$iu,13*7*38$3m$4k$54$5c$61$78$81,15*2*1e$aj$dm,16*0*3g,17*2*1g$27$4s,19*0*43","server's":"13*0*5b","servers":"9*0*2m","service":"10*1*2j$2t,13*0*6i,14*1*ap$as","services":"13*0*1v","set":"2*1*80$bc,3*3*30$74$82$84,6*0*67,8*14*1k$28$2o$3k$3p$42$56$7a$7o$91$9g$a4$ap$ba$c6,11*0*1q,13*0*9q,19*0*4a","setting":"3*1*6c$6n","settings":"13*0*3j,15*0*99,16*2*35$46$4v,18*1*2u$3a","setup":"15*0*ac","setups":"3*0*4u","several":"2*0*bj,5*0*78","severe":"7*0*24","severity":"7*0*1p","share":"19*10*-1$l","shared":"14*0*bj","sharing":"8*0*b4","should":"8*0*3d","shown":"2*0*4u,7*0*82","shows":"10*0*3u","sign":"8*0*6i,11*0*ck,17*0*as","sign-in":"11*0*cj,17*0*ar","signature":"11*3*e6$ec$g9$gt","signed":"11*0*ei","significant":"1*0*1r,2*10*-1$s,10*0*u","similar":"6*0*46","similarly":"5*0*86,10*0*4c,11*0*bj","simplifies":"18*0*1i","simply":"18*0*15,19*0*5b","size":"3*1*8v$94,15*0*4s,19*0*3g","skip":"3*1*75$7u","smooth":"7*0*2n","so":"17*10*-1$u","socket":"16*1*3c$3u","sockets":"16*1*42$4a","software":"15*0*d6","solution":"1*10*-1$9","solutions":"16*0*1k","solving":"16*0*r","some":"13*11*-1$m$a9","sort":"14*3*8o$8v$96$9d","source":"0*0*2v,2*3*1o$67$7f$8c,3*20*-1$o$1r$26$2c$2s$35$3g$8a$93$9k$a1,5*10*-1$h,11*0*io,14*1*o$29,15*3*10$17$3u$9e,18*0*21","sources":"0*0*3b,2*1*1u$7c,3*31*3$7$22,10*0*1q,11*0*j4,14*11*-1$h$1q,15*2*1s$57$86,18*0*1q,19*0*3p","spaced":"5*0*4q","spaceg":"5*0*53","spaces":"14*0*a8,15*0*c1","special":"6*0*3q","specific":"1*0*v,7*0*5u,15*1*90$b7,19*0*4e","specified":"8*0*4t,14*0*26","specifies":"13*0*6d,14*2*6f$6r$7b","specify":"3*1*56$8u,6*0*6i,8*2*2g$99$9s,14*0*9s,15*0*4p","specifying":"10*1*49$4l,14*0*p","stand":"11*0*5h,17*0*1n","stand-alone":"11*0*5g,17*0*1m","start":"13*10*-1$f","starting":"13*0*36","state":"11*0*7s","status":"6*1*2b$7j,10*0*1b","stay":"7*0*4f","step":"2*4*2m$2o$2t$34$3r,11*1*59$7k,17*1*1i$4u","steps":"2*0*2i,6*0*2n,11*3*5l$61$c8$ep,17*2*1r$23$96","stop":"17*2*25$52$56","stopped":"11*0*8s,17*0*6l","stor":"5*0*5d","storage":"5*3*41$48$6n$6u,15*1*65$69","storc":"5*0*5n","storcr":"5*0*60","store":"2*0*9a,8*0*4r","stored":"13*0*9s","storf":"5*0*68","storing":"11*0*7q","storm":"5*0*6h","storr":"5*0*6r","stors":"5*0*73","streams":"16*0*3n","sub":"8*3*37$3l$3m$6b,11*1*c7$eo,17*0*95","sub-steps":"11*1*c6$en,17*0*94","subject":"8*0*3f","succeeds":"3*0*9q","successful":"8*0*1s","sufficient":"7*10*-1$p","support":"13*9*4c,15*1*93$c0,16*1*1f$22","supports":"19*0*3l","syntax":"14*20*2u$2v$ch$ci,18*51*3$7$3i$3l$3q$7c$7g","sys1":"6*1*4a$4b","sysinfo":"5*0*46","sysplex":"14*3*b4$eh$em$ep,18*1*6f$8j","sysplexes":"9*10*-1$q","sysrg":"5*0*4h","syssum":"5*0*4r","system":"1*13*-1$c$t$13$1n,6*15*-1$c$2a$4e$5b$6u$7i,10*1*3l$44,13*3*1f$1r$3a$9v,15*10*-1$8","systems":"9*0*2o,11*0*3c,13*0*au","tab":"2*1*60$6i","table":"2*0*2l,5*1*36$3i,7*0*1v,8*0*l,9*0*1h,11*0*4v,16*0*26","tailor":"5*0*1i","take":"7*1*2h$49,13*0*22","target":"6*12*-1$b$5a$6t,9*0*2n","task":"7*0*2a,9*0*1j,17*9*16","tasks":"0*0*2k,2*0*16,6*2*v$11$76,9*2*1a$1q$1u,11*0*14","terminate":"7*0*2e","test":"3*0*9i","testing":"3*0*7q","than":"3*0*9a,10*0*2i,14*1*74$7k","them":"2*0*b6","thereby":"19*10*-1$1i","therefore":"6*0*44","thresholds":"19*0*4g","through":"1*0*g,9*31*1$8$1d,13*11*-1$j$5u,15*0*a2,16*1*12$3s","time":"1*10*-1$f,2*2*7l$7t$83,5*15*-1$q$2n$3f$3t$5t$63,10*16*-1$f$35$3j$40$4b$4i$4n,15*2*24$77$7a,16*1*2k$3o","timeline":"5*8*4a$4l$4u$57$5i$5r$6c$6l$70,15*7*67$6e$6k$6p$6v$75$78$7d","timeout":"3*0*55","timestamp":"10*2*1r$2c$2p","tip":"6*0*69,7*0*77,17*0*9u","title":"2*1*48$4t","titles":"18*10*-1$q","tls":"3*1*76$7v","together":"19*0*2t","token":"8*4*1q$25$2l$2v$3u,13*12*4a$4p$9c$9k","token's":"13*0*9j","tokens":"13*1*4r$5o","tool":"17*0*4i,18*10*-1$a","top":"18*0*1d,19*0*5j","topic":"3*0*ab,7*0*6g,9*0*21,14*0*47,15*4*53$82$8k$a8$ba","total":"14*1*b5$bg","track":"1*0*n","transfer":"8*0*8n,15*0*1n","transferred":"3*0*70","transform":"2*0*bn","transformation":"2*6*6h$6k$6p$74$au$b9$bf","transformations":"2*2*77$b3$br,14*0*10","transforming":"14*10*-1$c","transient":"7*0*32","trends":"19*0*2j","trigger":"19*0*4m","troubleshoot":"7*11*-1$u$17","troubleshooting":"15*0*b9,16*30*0$2","true":"8*6*1l$1m$2a$7c$7q$ar$c8","tso":"8*0*6s","ttl":"8*0*4d","turn":"3*0*6j,13*0*57","turned":"13*0*50","type":"3*0*2d,6*0*5c,7*0*20,14*10*35$3d$3e$3q$4n$4r$5k$co$d0$d1$dd,18*9*4r$50$57$5j$5v$6e$6r$78$83$8i","types":"2*1*54$5o,7*0*1s,14*2*21$3u$eg","typical":"2*0*a7,16*10*-1$9","typically":"3*0*7n","ub":"14*0*79","ui":"11*1*c1$e3,15*1*5d$8c","ulq":"14*1*5h$c7,18*6*4p$55$5g$5s$6n$74$81","unblocking":"16*0*40","uncompressed":"3*0*71","under":"11*0*id","understand":"19*0*2f","understood":"2*0*1v","unified":"19*0*46","unique":"6*0*3b,7*1*4p$7v,14*0*1g,19*0*32","unless":"11*0*8r,17*0*6k","unless-stopped":"11*0*8q,17*0*6j","unsigned":"11*3*1v$4f$4n$aa,17*0*83","up":"1*0*1c,6*2*3h$54$6f,7*0*4h,8*0*6j,17*11*-1$l$9q,19*0*4b","up-down":"6*0*6e","up-to-date":"7*0*4g,17*0*9p","updated":"15*3*5a$63$89$aq,16*0*n,17*1*a2$c4","updates":"7*1*40$4k,15*1*7s$9r","upgrade":"15*0*8p,17*2*17$2b$5u","upgraded":"17*1*3m$8s","upgrading":"15*0*8e,17*43*-1$0$6$11$1j$1s$9c","upon":"2*0*6n,8*0*1r","upper":"7*0*5d,14*2*5l$7c$7m","uri":"16*0*4d","url":"0*0*18,3*3*3r$3t$41$4g,6*0*1s,8*1*7e$7l,11*0*ca,13*0*6e,17*0*ai","url_login":"8*0*7d","usage":"2*0*a8,5*0*54,10*0*1c","use":"2*0*9u,5*0*1a,6*1*5i$6d,8*24*-1$e$1b$2e$33$3r$4e$5d$6k$7g$7t$97$9q$af$av$bg,9*10*-1$g,10*0*r,11*0*49,13*3*1h$4m$5m$69,14*4*1v$2c$2l$67$ad,15*0*d7,18*0*27","used":"3*0*7o,11*0*b8,17*1*1d$91,18*0*4k","user":"2*0*3e,3*2*2g$8g$8k,7*0*39,8*5*23$36$4q$6o$74$8q,10*1*21$25,11*2*cr$fr$hq,12*11*-1$g$p,13*12*3b$3h$42$5r,14*0*19,15*1*5j$5r,17*0*b3","user's":"8*0*8p","user-friendly":"14*0*18","username":"8*0*31,11*0*cg,17*0*ao","username_claim":"8*0*30","users":"7*0*3t,8*0*70,13*0*3u,15*0*bd,19*10*-1$i","using":"5*1*64$6a,7*12*-1$b$1e$70,8*1*67$6r,10*10*-1$c,11*0*67,13*0*9m,15*0*bl,16*10*-1$e,17*0*2d,18*1*1e$3c","usr":"11*0*40,13*0*bi","utilization":"14*2*b7$be$bi","utilize":"15*0*7n","utilized":"3*0*64","utilizing":"17*0*9n","v1":"15*10*o$2e$36$4h$5i$7u$8u$9t$bv$c7$cf,17*1*3s$4c","v1.0.0":"15*0*ce","v1.0.1":"15*0*c6","v1.0.2":"15*0*bu","v1.0.3":"15*1*8t$9s,17*0*3r","v1.0.4":"15*1*5h$7t","v1.0.5":"15*0*4g","v1.0.6":"15*0*35","v1.0.7":"15*0*2d","v1.0.8":"15*0*n","v10":"15*0*96","v10.x.x":"15*0*95","v9":"13*0*2p","v9.5.1":"13*0*2o","va":"14*1*8k$95","validate":"8*0*65","validation":"8*1*20$5q","validity":"8*0*5g,13*0*9l","valuable":"10*0*19","value":"3*2*5k$97$9e,8*10*1j$27$2n$3i$55$79$7n$90$ao$b9$c5,11*1*1r$78,13*0*7f,14*3*3n$6u$7e$da,17*1*3e$3v,18*12*17$2m$4q$4s$4v$51$54$56$58$80$82$84$86,19*0*5d","values":"8*0*13,11*0*ap,13*0*a8,14*8*64$6a$72$7i$98$99$9f$9g$ag,17*0*8i,18*20*-1$-1$m$s","var":"11*0*94,17*0*6t","variable":"11*0*4i,18*34*1$5$2o$30$38$3g,19*0*54","variables":"18*16*-1$8$t$1f$28$2h$3b$8t","variances":"19*0*2l","various":"5*0*1b,10*1*o$1f,19*2*26$2u$40","vary":"7*0*1o","vd":"14*1*8l$9c","velocity":"5*1*4n$4t,15*1*6j$6m","verify":"3*1*77$80,8*1*3t$5f,11*2*eb$gs$h0,13*0*9i","version":"2*0*3k,3*0*2m,5*0*7u,11*10*6p$6t$79$7c$9q$9u$at$b0$b5$d1$he,17*23*-1$13$2v$33$3f$3k$3t$4l$7j$7n$8m$8p$8u$9f$b9","via":"14*0*1r,15*0*9g,19*0*4o","view":"0*0*2l,2*0*8q,5*0*2u,7*10*-1$k,10*11*-1$9$3f,12*10*-1$8,14*0*ea","viewed":"10*0*1v","viewing":"7*0*10,10*0*h,18*0*2c","visible":"3*0*8n","visual":"2*10*-1$i","visualization":"2*48*-1$1$5$t$2f$37$39$3u$53$5n$8m$9i,5*0*1j,14*0*1m,19*42*-1$0$6$12$27$33","visualizations":"2*0*9r,15*1*26$3m","visualize":"11*10*-1$m","visualizing":"19*10*-1$f","volume":"11*3*7p$7u$8u$je,17*0*6n","wait":"3*0*5d","waiting":"10*0*47","want":"0*0*1s,2*0*2d,6*0*4n,14*0*9m,17*0*3p","warning":"7*1*3a$3c,11*0*e7","way":"18*10*-1$h","ways":"2*0*bk","web":"0*0*1b,6*0*1v,8*2*40$8r$bj,11*0*cd,13*12*49$4o$6g$9o,16*3*3b$3t$41$49,17*0*al","websites":"8*0*b7","what":"0*9*2d,2*9*9l,3*9*a2,6*9*6v,11*9*ig,15*9*j,18*0*2a","what's":"15*9*i","when":"1*0*12,2*1*4j$b1,3*3*39$4v$5s$8p,5*1*2e$7s,7*0*4l,8*3*5o$85$9d$a1,9*10*-1$e,10*0*3d,11*0*dr,13*2*14$62$a1,14*0*61,15*0*4i,16*10*-1$d,19*0*4t","whenever":"7*10*-1$6","where":"6*0*5r,11*0*hc,13*1*7r$7u,14*1*3a$ct,17*0*5a,18*9*45$4n$5f$5r$69$6m$73$7r$7t$8d","whereas":"16*0*2s","which":"2*0*2b,3*1*5a$5q,7*0*60,11*0*eh,13*0*6j,14*2*3g$d3$du,15*0*1j,19*0*3q","while":"7*12*-1$a$1d$6v,15*0*bk","who":"8*0*71","windows":"11*0*3h,13*0*b3","within":"7*0*3n,8*0*bn,11*0*5t,15*0*22,17*0*1v,19*10*-1$1f","without":"7*0*62,18*10*3j$3n$3s","wlm":"14*6*a9$am$ao$ar$av$bp$c3","work":"8*2*82$8a$8h,16*0*4e","workflow":"14*0*c2","working":"3*0*9l,11*1*1n$3j,13*11*-1$g$b5","working_dir/conf/defaults.ini":"11*0*3i,13*0*b4","workload":"14*0*an","workscope":"14*3*9v$ah$ak$ce","ws":"16*0*4c","x-forwarded-access-token":"8*0*2s","x-jwt-assertion":"8*0*2p","x.y.z":"11*0*hd","xcf":"5*1*6d$6j,15*1*7b$7e","xcfgroup":"5*0*5e","xcfovw":"5*0*5o","xcfpath":"5*0*61","xcfsys":"5*0*69","you":"0*24*-1$6$o$q$1g$1r$26$2g,1*2*k$1b$1g,2*33*-1$b$v$11$2c$4b$4h$4k$5a$69$70$8f$95$9f$ac$aq$bl,3*29*-1$e$q$s$1c$1t$3a$4j$6h$79$8q$9s$a5,5*5*18$1o$2f$2s$7o$8b,6*27*-1$6$o$q$24$38$3t$4m$6b$6o$72,7*37*-1$-1$-1$7$i$s$13$1a$2b$47$5n$6s$7j,8*25*-1$-1$6$c$p$63$66$86$ah,9*21*-1$-1$f$t$16,10*14*-1$7$1h$34$3e$4d,11*31*-1$c$t$v$1k$2n$47$75$am$c2$dj$ds$ht$i6$ij,12*10*-1$4,13*33*-1$-1$d$o$1k$21$2k$3d$3o$4f$55$5l$86$96$9f$a2$a5,14*9*1t$3j$4s$65$9k$9q$ab$d6$dk$e8,15*5*2j$3o$41$4l$7h$d2,16*6*v$17$19$1g$1m$2b$4m,17*28*-1$-1$c$r$1c$3b$3o$8f$9m$9v$a9$c2,18*4*1l$22$2b$34$91,19*17*-1$1j$23$2e$2m$34$3s$48$50","your":"2*15*-1$f$3a$8h$8r$aj$av,5*0*1l,9*10*-1$r,11*3*2b$33$56$cc,13*2*1q$39$75,14*0*5v,16*1*37$4p,17*0*ak,18*2*13$1g$8u,19*3*2g$3b$4h$59","z/os":"2*2*1a$1h$5g,3*1*11$18,5*12*-1$8$2i$7k,6*1*1f$1m,7*17*-1$e$1h$2r$3h$43$6h$73$7f,9*52*-1$-1$3$a$i$o$2a$2g,11*49*-1$2$8$h$17$52$5c$5o$bt$dn$g0$hi$i2,12*11*-1$c$m,13*2*16$2c$8s,14*3*13$40$48$e0,15*21*-1$e$2p$39$8g$a4$al$b1$bo$ck$da$dh$dp,16*12*-1$h$3j$4i,17*41*-1$2$8$h$c7,19*31*-1$-1$-1$r$16$19$1s","z/osmf":"0*14*-1$f$10$19$1e$2b,6*23*-1$-1$d$l$1a$1t$22,8*4*15$6u$80$88$bo,9*13*-1$14$1e$1o$26,13*67*-1$4$a$k$12$18$1n$26$4d$4i$52$5v$64$76$7v,15*0*ah","zcx":"11*0*bb","zcx/zlinux":"11*0*ba","zfsfs":"5*0*6i","zfskn":"5*0*6s","zfsovw":"5*0*74","zip":"11*5*6u$9v$g8$gf$h5$hb,17*2*34$4g$7o","zlinux":"11*0*bc","zosmf":"8*0*6f","zosmfbuilder":"13*1*72$7p"}; +return {"process":"14*0*k,15*1*2r$aj","processor":"10*1*48$4k,14*0*bd","procu":"5*0*4g","produces":"2*0*ba","profiles":"8*1*6p$75","programmer":"14*0*4e","programmer's":"14*0*4d","protocol":"8*2*7s$9e$a2","provide":"2*0*4e,6*0*3a,10*0*36,15*1*af$ck,16*0*1v","provided":"3*0*65,6*0*12,9*0*1v,13*0*3k,15*0*d4","provides":"1*10*-1$7,2*2*8e$9p$bi,5*11*-1$c$u,8*0*22,10*0*18,14*0*17,19*11*-1$v$20","proxy":"3*0*54,8*0*1u,16*2*34$45$4t","public":"11*3*es$f0$fh$fn","public_key.asc":"11*0*er","publish":"11*0*98,17*0*71","purposes":"10*0*p,18*0*4m","qualifications":"14*1*39$56","qualify":"14*0*a0","queries":"2*0*6f,5*0*1h,10*0*1o,14*12*-1$9$1s$22,18*10*-1$o,19*0*3i","query":"2*18*-1$q$20$26$5v$62$63$6c$89$8i,10*0*2a,14*56*2$6$j$1c$2b$2d$2k$2m$2t$31$cg$ck,18*51*2$6$3h$3m$3r$7d$7i","querying":"15*0*16","quickly":"7*1*15$4u","range":"2*1*7u$9q,10*0*4o,15*0*1e","ranges":"2*0*84,10*11*-1$g$3k","re":"5*0*81,15*1*5u$9d,17*4*98$9i$ad$br$bu","re-enter":"15*0*5t","re-import":"5*0*80,15*0*9c,17*4*97$9h$ac$bq$bt","real":"1*10*-1$e","receiving":"7*0*3b","recommended":"8*0*8d","refer":"1*0*24,2*2*a9$an$bs,3*0*a7,5*1*2b$8q,8*0*cj,11*0*ho,13*3*2b$2t$41$8r,18*0*93","referring":"7*0*53,17*0*a6","refresh":"2*0*86","regularly":"16*0*m","related":"11*5*j5,15*0*ar","relative":"2*0*7s,10*11*-1$e$4m","release":"15*31*0$2$ei,17*0*a5","releases":"11*2*6k$9l$go,17*2*2q$47$7e","relevant":"14*0*u","reliable":"1*10*-1$8","remember":"3*0*96,11*1*74$al,17*0*8e","remove":"5*0*8f,6*0*78,17*0*5j","rename":"11*0*2u","replace":"11*1*77$ao,17*1*3d$8h,18*10*-1$i","replaces":"17*0*4n","report":"2*0*5d,10*0*42,11*1*28$aj,14*21*2j$b0$bq$c4$cf$cj$cp$cr$dg$dj$dn$e5$en$eq,15*0*5e,17*0*8c","report_name":"14*1*cq$df","reporting":"5*12*-1$o$3d$3q,7*30*1$4","reports":"0*10*-1$m,11*10*-1$r,14*1*2r$eb,16*0*2u,19*11*-1$1e$2c","repository":"15*0*er","request":"14*0*a1,15*0*31","requested":"14*1*3i$d5","requesting":"14*0*62","requests":"3*0*5u,10*0*26","require":"2*10*-1$n,10*0*3n","required":"3*0*4r,5*0*8a,6*1*36$62,11*0*bm,14*0*al,15*0*1l,16*0*1t","requirements":"2*0*ak,5*0*1m,11*0*57,15*20*-1$9$d1$f2,19*0*3c","research":"10*0*12","resolutions":"16*1*2a$2i","resolve":"15*0*d8","resolved":"7*0*37,15*0*e5","resource":"0*11*-1$c$1m,6*14*-1$i$31$34$3d$40,7*0*6j,14*16*34$3c$3f$3p$3t$45$4a$4m$4q$5j$5p$cn$cv$d2$dc$e2$ef,15*0*ff,18*11*44$4f$4h$5e$5q$68$6c$6l$72$7q$8c$8g,19*10*-1$13","resource_name":"18*1*6b$8f","resource_type":"14*5*33$3b$3o$cm$cu$db","resources":"10*1*1g$3q","respond":"1*10*-1$b","response":"5*1*5s$62,7*0*4c,15*1*8v$92","restart":"11*1*7g$8p,17*1*4q$6i","result":"2*0*bb","resulting":"3*0*6r,15*0*26","results":"0*9*25,2*9*8j$9e,3*9*9r,6*9*6n,11*9*de$hs,17*9*bm$c1","retrieval":"8*0*52,15*0*3b","retrieve":"14*4*s$1k$23$2e$2n","retrieved":"8*0*4k","returned":"14*3*78$7o$81$8d","reverse":"3*0*53","review":"13*0*3f","rm":"17*0*5n","rmf":"0*13*-1$i$2q$2t$39,2*50*-1$2$6$g$19$1g$1m$1s$22$25$5f$65$8a$9j,3*59*-1$-1$1$5$9$m$10$17$1n$1p$29$5t$9v$a8$ae,5*90*-1$-1$-1$-1$-1$0$3$7$f$l$n$p$2h$33$3a$3c$3e$3j$3m$3p$3s$7j,6*1*1e$1l,7*16*-1$d$1g$2q$3g$42$72$7e,9*1*29$2f,11*91*-1$-1$1$7$g$n$16$22$24$27$51$5b$5n$6j$6n$6r$73$81$8f$8k$90$9k$9o$9s$a2$ad$af$ai$bs$d5$dc$dm$dv$ee$fb$ff$fv$g6$gd$gn$h3$h9$hh$i1$ia$im$j2,12*11*-1$b$l,14*47*-1$1$5$f$12$1b$1o$27$2f$2o$42,15*29*-1$d$q$2u$3j$4h$51$5d$5l$6u$9t$a8$b5$bd$cd$cp$dg$ek$f1$fa$fp,16*15*-1$g$2j$2t$2v$3i$4h,17*63*-1$1$7$g$2p$2t$31$39$46$4a$4e$58$5c$5p$68$6d$6p$7d$7h$7l$7r$86$88$8b$bd$bk$c6,18*32*0$4$3f$7h,19*53*-1$-1$1$7$q$18$1r$4i$56","rmf-grafana":"11*1*8e$8j,17*4*57$5b$5o$67$6c","rmf-grafana-data":"11*1*80$8v,17*0*6o","root":"7*0*50","row":"2*0*6s","rows":"5*0*16","rs2":"14*0*ca","rs21":"14*1*bu$c8","run":"7*0*7l,11*6*62$7l$84$88$8b$gp$jb,17*4*28$4v$5g$5r$64","running":"13*0*79,17*0*61","runs":"13*0*82","same":"10*0*29","samesite":"8*0*au","save":"2*1*90$99,3*0*9h,10*0*33,13*0*88,15*0*5o","scenarios":"15*0*3o","seamlessly":"5*0*1s","search":"3*0*27,11*1*d6$dd,16*0*11,17*1*be$bl","seconds":"3*0*58","section":"3*0*3n,6*0*14,8*0*10,11*2*2a$fp$if,13*0*44,15*0*ci,16*10*-1$4","sections":"8*0*cl,13*0*s","secure":"3*0*7m,6*0*5m,8*1*8l$ae","security":"8*0*ab,15*0*e6","see":"0*1*12$37,2*2*1e$1q$23,3*0*15,6*2*15$1j$7o,11*0*j0,13*0*ak,15*1*3h$4p","select":"0*0*1o,2*3*51$6j$79$7r,6*1*57$5h,18*7*3v$5b$5n$65$6i$6v$7l$89","selected":"14*0*4l,15*0*1c","selecting":"18*0*16,19*0*5c","sends":"1*0*18","sensitive":"4*20*1,6*0*43","separate":"18*0*1t","separated":"14*0*5f","sequentially":"2*0*b7","series":"5*12*-1$r$3g$3u,15*2*19$24$3u,16*1*2l$3p","server":"0*3*v$15$1q$35,3*10*-1$j,5*0*23,6*46*-1$2$5$a$2s$30$4l$5t$6s$7a,7*2*5l$69$6d,8*3*1h$77$7r$8u,9*0*2r,11*1*7i$iu,13*7*38$3m$4k$54$5c$61$78$81,15*2*37$cc$fn,16*0*3g,17*2*1g$27$4s,19*0*43","server's":"13*0*5b","servers":"9*0*2m","service":"10*1*2j$2t,13*0*6i,14*1*ap$as","services":"13*0*1v","set":"2*1*80$bc,3*3*30$74$82$84,6*0*67,8*14*1k$28$2o$3k$3p$42$56$7a$7o$91$9g$a4$ap$ba$c6,11*0*1q,13*0*9q,19*0*4a","setting":"3*1*6c$6n","settings":"13*0*3j,15*0*b2,16*2*35$46$4v,18*1*2u$3a","setup":"15*0*c5","setups":"3*0*4u","several":"2*0*bj,5*0*78","severe":"7*0*24","severity":"7*0*1p","share":"19*10*-1$l","shared":"14*0*bj","sharing":"8*0*b4","should":"8*0*3d","shown":"2*0*4u,7*0*82","shows":"10*0*3u","sign":"8*0*6i,11*0*ck,17*0*as","sign-in":"11*0*cj,17*0*ar","signature":"11*3*e6$ec$g9$gt","signed":"11*0*ei","significant":"1*0*1r,2*10*-1$s,10*0*u","similar":"6*0*46","similarly":"5*0*86,10*0*4c,11*0*bj","simplifies":"18*0*1i","simply":"18*0*15,19*0*5b","size":"3*1*8v$94,15*2*14$1g$6l,19*0*3g","skip":"3*1*75$7u","smooth":"7*0*2n","so":"17*10*-1$u","socket":"16*1*3c$3u","sockets":"16*1*42$4a","software":"15*0*f7","solution":"1*10*-1$9","solutions":"16*0*1k","solving":"16*0*r","some":"13*11*-1$m$a9","sort":"14*3*8o$8v$96$9d","source":"0*0*2v,2*3*1o$67$7f$8c,3*20*-1$o$1r$26$2c$2s$35$3g$8a$93$9k$a1,5*10*-1$h,11*0*io,14*1*o$29,15*3*2p$30$5n$b7,18*0*21","sources":"0*0*3b,2*1*1u$7c,3*31*3$7$22,10*0*1q,11*0*j4,14*11*-1$h$1q,15*2*3l$70$9v,18*0*1q,19*0*3p","spaced":"5*0*4q","spaceg":"5*0*53","spaces":"14*0*a8,15*0*dq","special":"6*0*3q","specific":"1*0*v,7*0*5u,15*2*1u$ap$d0,19*0*4e","specified":"8*0*4t,14*0*26","specifies":"13*0*6d,14*2*6f$6r$7b","specify":"3*1*56$8u,6*0*6i,8*2*2g$99$9s,14*0*9s,15*0*6i","specifying":"10*1*49$4l,14*0*p","stand":"11*0*5h,17*0*1n","stand-alone":"11*0*5g,17*0*1m","start":"13*10*-1$f","starting":"13*0*36","state":"11*0*7s","status":"6*1*2b$7j,10*0*1b","stay":"7*0*4f","step":"2*4*2m$2o$2t$34$3r,11*1*59$7k,15*0*13,17*1*1i$4u","steps":"2*0*2i,6*0*2n,11*3*5l$61$c8$ep,17*2*1r$23$96","stop":"17*2*25$52$56","stopped":"11*0*8s,17*0*6l","stor":"5*0*5d","storage":"5*3*41$48$6n$6u,15*1*7u$82","storc":"5*0*5n","storcr":"5*0*60","store":"2*0*9a,8*0*4r","stored":"13*0*9s","storf":"5*0*68","storing":"11*0*7q","storm":"5*0*6h","storr":"5*0*6r","stors":"5*0*73","streams":"16*0*3n","sub":"8*3*37$3l$3m$6b,11*1*c7$eo,17*0*95","sub-steps":"11*1*c6$en,17*0*94","subject":"8*0*3f","succeeds":"3*0*9q","successful":"8*0*1s","sufficient":"7*10*-1$p","support":"13*9*4c,15*1*as$dp,16*1*1f$22","supports":"19*0*3l","syntax":"14*20*2u$2v$ch$ci,18*51*3$7$3i$3l$3q$7c$7g","sys1":"6*1*4a$4b","sysinfo":"5*0*46","sysplex":"14*3*b4$eh$em$ep,18*1*6f$8j","sysplexes":"9*10*-1$q","sysrg":"5*0*4h","syssum":"5*0*4r","system":"1*13*-1$c$t$13$1n,6*15*-1$c$2a$4e$5b$6u$7i,10*1*3l$44,13*3*1f$1r$3a$9v,15*10*-1$8","systems":"9*0*2o,11*0*3c,13*0*au","tab":"2*1*60$6i","table":"2*0*2l,5*1*36$3i,7*0*1v,8*0*l,9*0*1h,11*0*4v,16*0*26","tailor":"5*0*1i","take":"7*1*2h$49,13*0*22","target":"6*12*-1$b$5a$6t,9*0*2n","task":"7*0*2a,9*0*1j,17*9*16","tasks":"0*0*2k,2*0*16,6*2*v$11$76,9*2*1a$1q$1u,11*0*14","terminate":"7*0*2e","test":"3*0*9i","testing":"3*0*7q","than":"3*0*9a,10*0*2i,14*1*74$7k","them":"2*0*b6","thereby":"19*10*-1$1i","therefore":"6*0*44","thresholds":"19*0*4g","through":"1*0*g,9*31*1$8$1d,13*11*-1$j$5u,15*0*br,16*1*12$3s","time":"1*10*-1$f,2*2*7l$7t$83,5*15*-1$q$2n$3f$3t$5t$63,10*16*-1$f$35$3j$40$4b$4i$4n,15*5*18$1d$23$3t$90$93,16*1*2k$3o","timeline":"5*8*4a$4l$4u$57$5i$5r$6c$6l$70,15*7*80$87$8d$8i$8o$8u$91$96","timeout":"3*0*55","timestamp":"10*2*1r$2c$2p","tip":"6*0*69,7*0*77,17*0*9u","title":"2*1*48$4t","titles":"18*10*-1$q","tls":"3*1*76$7v","together":"19*0*2t","token":"8*4*1q$25$2l$2v$3u,13*12*4a$4p$9c$9k","token's":"13*0*9j","tokens":"13*1*4r$5o","tool":"17*0*4i,18*10*-1$a","top":"18*0*1d,19*0*5j","topic":"3*0*ab,7*0*6g,9*0*21,14*0*47,15*4*6s$9r$ad$c1$d3","total":"14*1*b5$bg","track":"1*0*n","transfer":"8*0*8n,15*0*3g","transferred":"3*0*70","transform":"2*0*bn","transformation":"2*6*6h$6k$6p$74$au$b9$bf","transformations":"2*2*77$b3$br,14*0*10","transforming":"14*10*-1$c","transient":"7*0*32","trends":"19*0*2j","trigger":"19*0*4m","troubleshoot":"7*11*-1$u$17","troubleshooting":"15*0*d2,16*30*0$2","true":"8*6*1l$1m$2a$7c$7q$ar$c8","tso":"8*0*6s","ttl":"8*0*4d","turn":"3*0*6j,13*0*57","turned":"13*0*50","type":"3*0*2d,6*0*5c,7*0*20,14*10*35$3d$3e$3q$4n$4r$5k$co$d0$d1$dd,18*9*4r$50$57$5j$5v$6e$6r$78$83$8i","types":"2*1*54$5o,7*0*1s,14*2*21$3u$eg","typical":"2*0*a7,16*10*-1$9","typically":"3*0*7n","ub":"14*0*79","ui":"11*1*c1$e3,15*1*76$a5","ulq":"14*1*5h$c7,18*6*4p$55$5g$5s$6n$74$81","unblocking":"16*0*40","uncompressed":"3*0*71","under":"11*0*id","understand":"19*0*2f","understood":"2*0*1v","unified":"19*0*46","unique":"6*0*3b,7*1*4p$7v,14*0*1g,19*0*32","unless":"11*0*8r,17*0*6k","unless-stopped":"11*0*8q,17*0*6j","unsigned":"11*3*1v$4f$4n$aa,17*0*83","up":"1*0*1c,6*2*3h$54$6f,7*0*4h,8*0*6j,17*11*-1$l$9q,19*0*4b","up-down":"6*0*6e","up-to-date":"7*0*4g,17*0*9p","updated":"15*3*73$7s$a2$cj,16*0*n,17*1*a2$c4","updates":"7*1*40$4k,15*1*9l$bk","upgrade":"15*0*ai,17*2*17$2b$5u","upgraded":"17*1*3m$8s","upgrading":"15*0*a7,17*43*-1$0$6$11$1j$1s$9c","upon":"2*0*6n,8*0*1r","upper":"7*0*5d,14*2*5l$7c$7m","uri":"16*0*4d","url":"0*0*18,3*3*3r$3t$41$4g,6*0*1s,8*1*7e$7l,11*0*ca,13*0*6e,17*0*ai","url_login":"8*0*7d","usage":"2*0*a8,5*0*54,10*0*1c","use":"2*0*9u,5*0*1a,6*1*5i$6d,8*24*-1$e$1b$2e$33$3r$4e$5d$6k$7g$7t$97$9q$af$av$bg,9*10*-1$g,10*0*r,11*0*49,13*3*1h$4m$5m$69,14*4*1v$2c$2l$67$ad,15*0*f8,18*0*27","used":"3*0*7o,11*0*b8,17*1*1d$91,18*0*4k","user":"2*0*3e,3*2*2g$8g$8k,7*0*39,8*5*23$36$4q$6o$74$8q,10*1*21$25,11*2*cr$fr$hq,12*11*-1$g$p,13*12*3b$3h$42$5r,14*0*19,15*1*7c$7k,17*0*b3","user's":"8*0*8p","user-friendly":"14*0*18","username":"8*0*31,11*0*cg,17*0*ao","username_claim":"8*0*30","users":"7*0*3t,8*0*70,13*0*3u,15*0*d6,19*10*-1$i","using":"5*1*64$6a,7*12*-1$b$1e$70,8*1*67$6r,10*10*-1$c,11*0*67,13*0*9m,15*0*de,16*10*-1$e,17*0*2d,18*1*1e$3c","usr":"11*0*40,13*0*bi","utilization":"14*2*b7$be$bi","utilize":"15*0*9g","utilized":"3*0*64","utilizing":"17*0*9n","v1":"15*11*o$2h$47$4v$6a$7b$9n$an$bm$do$e4$eg,17*1*3s$4c","v1.0.0":"15*0*ef","v1.0.1":"15*0*e3","v1.0.2":"15*0*dn","v1.0.3":"15*1*am$bl,17*0*3r","v1.0.4":"15*1*7a$9m","v1.0.5":"15*0*69","v1.0.6":"15*0*4u","v1.0.7":"15*0*46","v1.0.8":"15*0*2g","v1.0.9":"15*0*n","v10":"15*0*av","v10.x.x":"15*0*au","v9":"13*0*2p","v9.5.1":"13*0*2o","va":"14*1*8k$95","validate":"8*0*65","validation":"8*1*20$5q","validity":"8*0*5g,13*0*9l","valuable":"10*0*19","value":"3*2*5k$97$9e,8*10*1j$27$2n$3i$55$79$7n$90$ao$b9$c5,11*1*1r$78,13*0*7f,14*3*3n$6u$7e$da,17*1*3e$3v,18*12*17$2m$4q$4s$4v$51$54$56$58$80$82$84$86,19*0*5d","values":"8*0*13,11*0*ap,13*0*a8,14*8*64$6a$72$7i$98$99$9f$9g$ag,17*0*8i,18*20*-1$-1$m$s","var":"11*0*94,17*0*6t","variable":"11*0*4i,18*34*1$5$2o$30$38$3g,19*0*54","variables":"18*16*-1$8$t$1f$28$2h$3b$8t","variances":"19*0*2l","various":"5*0*1b,10*1*o$1f,19*2*26$2u$40","vary":"7*0*1o","vd":"14*1*8l$9c","velocity":"5*1*4n$4t,15*1*8c$8f","verify":"3*1*77$80,8*1*3t$5f,11*2*eb$gs$h0,13*0*9i","version":"2*0*3k,3*0*2m,5*0*7u,11*10*6p$6t$79$7c$9q$9u$at$b0$b5$d1$he,17*23*-1$13$2v$33$3f$3k$3t$4l$7j$7n$8m$8p$8u$9f$b9","via":"14*0*1r,15*0*b9,19*0*4o","view":"0*0*2l,2*0*8q,5*0*2u,7*10*-1$k,10*11*-1$9$3f,12*10*-1$8,14*0*ea","viewed":"10*0*1v","viewing":"7*0*10,10*0*h,18*0*2c","views":"15*0*25","visible":"3*0*8n","visual":"2*10*-1$i","visualization":"2*48*-1$1$5$t$2f$37$39$3u$53$5n$8m$9i,5*0*1j,14*0*1m,19*42*-1$0$6$12$27$33","visualizations":"2*0*9r,15*1*3v$5f","visualize":"11*10*-1$m","visualizing":"19*10*-1$f","volume":"11*3*7p$7u$8u$je,17*0*6n","wait":"3*0*5d","waiting":"10*0*47","want":"0*0*1s,2*0*2d,6*0*4n,14*0*9m,17*0*3p","warning":"7*1*3a$3c,11*0*e7","way":"18*10*-1$h","ways":"2*0*bk","web":"0*0*1b,6*0*1v,8*2*40$8r$bj,11*0*cd,13*12*49$4o$6g$9o,16*3*3b$3t$41$49,17*0*al","websites":"8*0*b7","what":"0*9*2d,2*9*9l,3*9*a2,6*9*6v,11*9*ig,15*9*j,18*0*2a","what's":"15*9*i","when":"1*0*12,2*1*4j$b1,3*3*39$4v$5s$8p,5*1*2e$7s,7*0*4l,8*3*5o$85$9d$a1,9*10*-1$e,10*0*3d,11*0*dr,13*2*14$62$a1,14*0*61,15*1*15$6b,16*10*-1$d,19*0*4t","whenever":"7*10*-1$6","where":"6*0*5r,11*0*hc,13*1*7r$7u,14*1*3a$ct,17*0*5a,18*9*45$4n$5f$5r$69$6m$73$7r$7t$8d","whereas":"16*0*2s","which":"2*0*2b,3*1*5a$5q,7*0*60,11*0*eh,13*0*6j,14*2*3g$d3$du,15*0*3c,19*0*3q","while":"7*12*-1$a$1d$6v,15*0*dd","who":"8*0*71","windows":"11*0*3h,13*0*b3","within":"7*0*3n,8*0*bn,11*0*5t,15*0*3r,17*0*1v,19*10*-1$1f","without":"7*0*62,18*10*3j$3n$3s","wlm":"14*6*a9$am$ao$ar$av$bp$c3","work":"8*2*82$8a$8h,16*0*4e","workflow":"14*0*c2","working":"3*0*9l,11*1*1n$3j,13*11*-1$g$b5","working_dir/conf/defaults.ini":"11*0*3i,13*0*b4","workload":"14*0*an","workscope":"14*3*9v$ah$ak$ce","ws":"16*0*4c","x-forwarded-access-token":"8*0*2s","x-jwt-assertion":"8*0*2p","x.y.z":"11*0*hd","xcf":"5*1*6d$6j,15*1*94$97","xcfgroup":"5*0*5e","xcfovw":"5*0*5o","xcfpath":"5*0*61","xcfsys":"5*0*69","you":"0*24*-1$6$o$q$1g$1r$26$2g,1*2*k$1b$1g,2*33*-1$b$v$11$2c$4b$4h$4k$5a$69$70$8f$95$9f$ac$aq$bl,3*29*-1$e$q$s$1c$1t$3a$4j$6h$79$8q$9s$a5,5*5*18$1o$2f$2s$7o$8b,6*27*-1$6$o$q$24$38$3t$4m$6b$6o$72,7*37*-1$-1$-1$7$i$s$13$1a$2b$47$5n$6s$7j,8*25*-1$-1$6$c$p$63$66$86$ah,9*21*-1$-1$f$t$16,10*14*-1$7$1h$34$3e$4d,11*31*-1$c$t$v$1k$2n$47$75$am$c2$dj$ds$ht$i6$ij,12*10*-1$4,13*33*-1$-1$d$o$1k$21$2k$3d$3o$4f$55$5l$86$96$9f$a2$a5,14*9*1t$3j$4s$65$9k$9q$ab$d6$dk$e8,15*5*4c$5h$5q$6e$9a$f3,16*6*v$17$19$1g$1m$2b$4m,17*28*-1$-1$c$r$1c$3b$3o$8f$9m$9v$a9$c2,18*4*1l$22$2b$34$91,19*17*-1$1j$23$2e$2m$34$3s$48$50","your":"2*15*-1$f$3a$8h$8r$aj$av,5*0*1l,9*10*-1$r,11*3*2b$33$56$cc,13*2*1q$39$75,14*0*5v,16*1*37$4p,17*0*ak,18*2*13$1g$8u,19*3*2g$3b$4h$59","z/os":"2*2*1a$1h$5g,3*1*11$18,5*12*-1$8$2i$7k,6*1*1f$1m,7*17*-1$e$1h$2r$3h$43$6h$73$7f,9*52*-1$-1$3$a$i$o$2a$2g,11*49*-1$2$8$h$17$52$5c$5o$bt$dn$g0$hi$i2,12*11*-1$c$m,13*2*16$2c$8s,14*3*13$40$48$e0,15*22*-1$e$r$4i$52$a9$bt$ce$cq$dh$el$fb$fi$fq,16*12*-1$h$3j$4i,17*41*-1$2$8$h$c7,19*31*-1$-1$-1$r$16$19$1s","z/osmf":"0*14*-1$f$10$19$1e$2b,6*23*-1$-1$d$l$1a$1t$22,8*4*15$6u$80$88$bo,9*13*-1$14$1e$1o$26,13*67*-1$4$a$k$12$18$1n$26$4d$4i$52$5v$64$76$7v,15*0*ca","zcx":"11*0*bb","zcx/zlinux":"11*0*ba","zfsfs":"5*0*6i","zfskn":"5*0*6s","zfsovw":"5*0*74","zip":"11*5*6u$9v$g8$gf$h5$hb,17*2*34$4g$7o","zlinux":"11*0*bc","zosmf":"8*0*6f","zosmfbuilder":"13*1*72$7p"}; }); \ No newline at end of file diff --git a/docs/grafana/rmf-app/pdf/rmf_grafana.pdf b/docs/grafana/rmf-app/pdf/rmf_grafana.pdf index 4e4cd1f0..171c79a4 100644 Binary files a/docs/grafana/rmf-app/pdf/rmf_grafana.pdf and b/docs/grafana/rmf-app/pdf/rmf_grafana.pdf differ diff --git a/docs/grafana/rmf-app/rn.html b/docs/grafana/rmf-app/rn.html index a935e842..2e7db3fe 100644 --- a/docs/grafana/rmf-app/rn.html +++ b/docs/grafana/rmf-app/rn.html @@ -148,40 +148,86 @@

Release notes

+
May 2025 v1.0.9
+
+
    +
  • +

    IBM RMF for z/OS Grafana plugin has been + enhanced to optimize the step size when querying and displaying + time series data, based on the selected time range and panel + size. This enhancement ensures that panels display the required + number of data points.

    +
  • +
  • +

    A bug has been fixed that was causing specific data points to be + dropped from time series views, resulting in a flat line in the + graphs.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+ + + +
+
+
April 2025 v1.0.8
    -
  • A new option, Compression, has been added to - the data source creation process. This option enables the RMF data - source to request HTTP compression from the Data Distributed Server - (DDS) during data retrieval, which improves the efficiency of data - transfer. See Creating RMF data sources.
  • -
  • Fixed certain scenarios of missing data within dashboards for time - series visualizations.
  • -
  • Fixed internally found defects.
  • +
  • +

    A new option, Compression, has been added + to the data source creation process. This option enables the RMF + data source to request HTTP compression from the Data + Distributed Server (DDS) during data retrieval, which improves + the efficiency of data transfer. See Creating RMF data sources.

    +
  • +
  • +

    Fixed certain scenarios of missing data within dashboards for + time series visualizations.

    +
  • +
  • +

    Fixed internally found defects.

    +
November 2024 v1.0.7
-
    -
  • Fixed internally found defects.
  • -
  • You can now download IBM RMF for z/OS Grafana - plugin documentation as a PDF file. See PDF Guide.
  • -
+
+ +
    +
  • +

    Fixed internally found defects.

    +
  • +
  • +

    You can now download IBM RMF for z/OS Grafana plugin documentation as a PDF file. See PDF Guide.

    +
  • +
+
October 2024 v1.0.6
    -
  • The IBM RMF for z/OS Grafana plugin now allows - customizing banner and caption fields in IBM RMF Report - visualizations.
  • -
  • After you modify any IBM RMF data source - and save the changes, you no longer need to re-enter the - password.
  • -
  • Improved performance.
  • -
  • Fixed internally found defects.
  • +
  • +

    The IBM RMF for z/OS Grafana plugin now + allows customizing banner and caption fields in IBM RMF Report + visualizations.

    +
  • +
  • +

    After you modify any IBM RMF data + source and save the changes, you no longer need to re-enter the + password.

    +
  • +
  • +

    Improved performance.

    +
  • +
  • +

    Fixed internally found defects.

    +
@@ -193,11 +239,17 @@

Release notes

August 2024 v1.0.5
    -
  • When creating the datasource, you now have the option to specify the - desired cache size in megabytes for the datasource.
  • -
  • Fixed internally found defects.
  • -
  • The topic of Creating RMF data sources has been updated - per the new UI changes.
  • +
  • +

    When creating the datasource, you now have the option to specify + the desired cache size in megabytes for the datasource.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +

    The topic of Creating RMF data sources has been + updated per the new UI changes.

    +
@@ -205,38 +257,48 @@

Release notes

June 2024 v1.0.4
    -
  • The user interface for creating the datasource has been enhanced to - improve the user experience.
  • -
  • Fixed internally found defects.
  • -
  • The following dashboards are updated:
      -
    • Common Storage Activity (Timeline)
    • -
    • Common Storage Activity
    • -
    • Coupling Facility Overview (Timeline)
    • -
    • Coupling Facility Overview
    • -
    • Execution Velocity (Timeline)
    • -
    • Execution Velocity
    • -
    • General Activity (Timeline)
    • -
    • General Activity
    • -
    • Overall Image Activity (Timeline)
    • -
    • Overall Image Activity
    • -
    • Performance Index (Timeline)
    • -
    • Response Time (Timeline)
    • -
    • Response Time
    • -
    • XCF Activity (Timeline)
    • -
    • XCF Activity
    • -
    • -
      Note: You must re-import the - dashboards to utilize the latest enhancements in the - dashboards.
      -
    • -
  • -
  • The documentation updates for v1.0.4 include the following - changes:
  • +
  • +

    The user interface for creating the datasource has been enhanced + to improve the user experience.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +
    The following dashboards are updated:
      +
    • Common Storage Activity (Timeline)
    • +
    • Common Storage Activity
    • +
    • Coupling Facility Overview (Timeline)
    • +
    • Coupling Facility Overview
    • +
    • Execution Velocity (Timeline)
    • +
    • Execution Velocity
    • +
    • General Activity (Timeline)
    • +
    • General Activity
    • +
    • Overall Image Activity (Timeline)
    • +
    • Overall Image Activity
    • +
    • Performance Index (Timeline)
    • +
    • Response Time (Timeline)
    • +
    • Response Time
    • +
    • XCF Activity (Timeline)
    • +
    • XCF Activity
    • +
    Note: You must re-import the + dashboards to utilize the latest enhancements in the + dashboards.
    +
  • +
  • +
    The documentation updates for v1.0.4 include the following + changes:
    +
@@ -244,40 +306,76 @@

Release notes

February 2024 v1.0.3
    -
  • Fixed specific issues related to the support of Grafana - v10.x.x.
  • -
  • Fixed empty settings issue for IBM RMF data source defined via - Home / Apps / IBM RMF page.
  • -
  • Fixed internally found defects.
  • -
  • The documentation updates for v1.0.3 include the following - changes:
      -
    • The Grafana through IBM - z/OS Management Facility topic explains more - detailed setup instructions to access Grafana from the - z/OSMF server.
    • -
    • The RMF for z/OS plugin - installation section is updated to provide clear - information and guidance on installing the RMF for z/OS plugin on - different platforms based on specific requirements.
    • -
    • The troubleshooting topic - is provided to help users analyze and resolve common issues - that may occur while using the IBM RMF for z/OS Grafana plugin.
    • -
  • +
  • +

    Fixed specific issues related to the support of Grafana + v10.x.x.

    +
  • +
  • +

    Fixed empty settings issue for IBM RMF data source defined via + Home / Apps / IBM RMF page.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +
    The documentation updates for v1.0.3 include the following + changes:
      +
    • +

      The Grafana + through IBM z/OS Management Facility topic + explains more detailed setup instructions to access + Grafana from the z/OSMF server.

      +
    • +
    • +

      The RMF for z/OS plugin + installation section is updated to provide + clear information and guidance on installing the RMF for z/OS plugin on + different platforms based on specific + requirements.

      +
    • +
    • +

      The troubleshooting topic is provided to help + users analyze and resolve common issues that may + occur while using the IBM RMF for z/OS Grafana + plugin.

      +
    • +
    +
December 2023 v1.0.2
-
Support spaces in Datasource name.
+
+
    +
  • +

    Support spaces in Datasource name.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
November 2023 v1.0.1
-
Resolved security issues in dependencies.
+
+
    +
  • +

    Resolved security issues in dependencies.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
November 2023 v1.0.0
-
The first release of the IBM RMF for z/OS Grafana - plugin is in the following GitHub repository: https://github.com/IBM/RMF.
+
+

The first release of the IBM RMF for z/OS Grafana + plugin is in the following GitHub repository: https://github.com/IBM/RMF.

+
diff --git a/docs/grafana/rmf-app/sitemap.xml b/docs/grafana/rmf-app/sitemap.xml index f6d6c65a..647cfc21 100644 --- a/docs/grafana/rmf-app/sitemap.xml +++ b/docs/grafana/rmf-app/sitemap.xml @@ -2,78 +2,78 @@ visual_grafana.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z rn.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z install_grafana_plugin.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z update_plugin.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z create_datasources.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z db_ovw.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z apply_visualize.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z query_lang.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z variables.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z alerts.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z historical_data.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z error_reports.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z ts_issues.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z grafana_via_zosmf.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z prereq_zosmf.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z grafana_config_parms.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z define_grafana_zosmf.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z access_grafana_zosmf.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z pdf_guide.html - 2025-04-04T10:38:00Z + 2025-05-13T12:20:14Z diff --git a/grafana/rmf-app/CHANGELOG.md b/grafana/rmf-app/CHANGELOG.md index b5ab5f5a..44a4f5de 100644 --- a/grafana/rmf-app/CHANGELOG.md +++ b/grafana/rmf-app/CHANGELOG.md @@ -1,5 +1,11 @@ # Change Log +## 1.0.9 (2025-05-22) + +- IBM RMF for z/OS Grafana plugin has been enhanced to optimize the step size when querying and displaying time series data, based on the selected time range and panel size. This enhancement ensures that panels display the required number of data points. +- A bug has been fixed that was causing specific data points to be dropped from time series views, resulting in a flat line in the graphs. +- Fixed internally found defects. + ## 1.0.8 (2025-04-04) - A new option, Compression, has been added to the data source creation process. This option enables the RMF data source to request HTTP compression from the Data Distributed Server (DDS) during data retrieval, which improves the efficiency of data transfer. diff --git a/grafana/rmf-app/doc/src/conref.dita b/grafana/rmf-app/doc/src/conref.dita index a5d41628..7cf2cb80 100644 --- a/grafana/rmf-app/doc/src/conref.dita +++ b/grafana/rmf-app/doc/src/conref.dita @@ -5,6 +5,7 @@

IBM RMF for z/OS Grafana

+

RMF for z/OS Grafana

RMF for z/OS

Resource Measurement Facility for z/OS

Distributed Data Server

@@ -54,6 +55,7 @@ Verify the server’s certificate chain/hostname option is also enabled.

+

Fixed internally found defects.

diff --git a/grafana/rmf-app/doc/src/pdf/rmf_grafana.fo b/grafana/rmf-app/doc/src/pdf/rmf_grafana.fo new file mode 100644 index 00000000..29b6fbf0 --- /dev/null +++ b/grafana/rmf-app/doc/src/pdf/rmf_grafana.fo @@ -0,0 +1,2200 @@ +IBM RMF for z/OS Grafana Plugin User GuideoXygen PDF Chemistry Version 24.1 Build 2022-11-03T09:51:41ZtrueIBM RMF for z/OS Grafana Plugin User GuideContents1. IBM RMF for z/OS Grafana Plugin1.1. Overview1.2. Release notesWhat's newRequirements1.3. Installing the plugin1.4. Upgrading the plugin1.5. Creating RMF data sources1.6. RMF master dashboard1.7. Applying visualization to RMF data1.8. IBM RMF query languagesMetric query syntaxReport query syntax1.9. RMF Variable Query syntaxSyntax of the query without a filterSyntax of the query with a filter1.10. Alerts1.11. Historical data1.12. Error types1.13. Troubleshooting issues1.14. Grafana through z/OSMF1.14.1. PrerequisitesConfigure z/OSMFInstall GrafanaUser administrationConfigure JSON Web Token (JWT) support on z/OSMFConfigure JWT authentication on Grafana1.14.1.1. Grafana configuration parameters1.14.2. Defining the Grafana server1.14.3. Accessing the Grafana dashboard + + + + + + + + IBM RMF for z/OS Grafana Plugin User GuideIBM + RMF for z/OS Grafana Plugin User Guide + + | | + ContentsContents + + + 1. IBM RMF for z/OS + Grafana + Plugin + + 1.1. Overview + + + 1.2. Release + notes + + + 1.3. Installing the + plugin + + + 1.4. Upgrading the + plugin + + + 1.5. Creating RMF data + sources + + + 1.6. RMF master + dashboard + + + 1.7. Applying visualization to RMF + data + + + 1.8. IBM RMF query + languages + + + 1.9. RMF Variable Query + syntax + + + 1.10. Alerts + + + 1.11. Historical + data + + + 1.12. Error + types + + + 1.13. Troubleshooting + issues + + + 1.14. Grafana through + z/OSMF + + 1.14.1. Prerequisites + + + + 1.14.2. Defining + the Grafana + server + + + 1.14.3. Accessing + the Grafana + dashboard + + + + + Page Page + 1 - IBM RMF for z/OS Grafana Plugin | 1 - IBM RMF for z/OS Grafana Plugin1. IBM RMF for z/OS Grafana Plugin + + | 1.1 - Visualization of RMF Monitor III metrics in Grafana1.1. Visualization of RMF Monitor III + metrics in Grafana + + + Grafana is a + platform for monitoring and visualizing data. It enables + users to create, explore, and share dashboards that are + interactive and customizable. The IBM® RMF for z/OS + Grafana plugin provides effortless analysis and + visualization of Resource Measurement Facility for + z/OS (RMF for z/OS) Monitor III + metrics and reports within the Grafana platform. Thereby, + you can monitor and analyze the health and performance of + applications. + The IBM RMF for z/OS Grafana + plugin provides the following features: + You + can choose various visualization options, such as + graphs, charts, panels, and reports, to help you + understand your data's trends, patterns, and + variances. + You + can create dynamic and engaging dashboards by + piecing together various panels, each displaying a + unique visualization. + You + have the freedom to customize each panel based on + your requirements, including its appearance, size, + and the data queries it displays. + Grafana supports integration with numerous data + sources, which helps you fetch data from various + Distributed Data Servers (DDS) and display it in a unified + dashboard. + You + can set up alerts based on specific conditions or + thresholds in your RMF data. Grafana can trigger + notifications via email or other communication + channels when these conditions are met. + You + can define a dashboard variable to change the RMF + data displayed in your dashboard simply by selecting + a value from the drop-down list at the top. + + + + + | 1.2 - Release notes1.2. Release notes + + This article + covers the new features, system requirements, and known + issues of the IBM® RMF for z/OS Grafana plugin. + + What's + new + + May 2025 v1.0.9 + + + + IBM RMF + for z/OS Grafana plugin has been enhanced + to optimize the step size when querying and + displaying time series data, based on the selected + time range and panel size. This enhancement + ensures that panels display the required number of + data points. + + + A bug + has been fixed that was causing specific data + points to be dropped from time series views, + resulting in a flat line in the graphs. + + + Fixed + internally found defects. + + + + + + + + April 2025 v1.0.8 + + + + A new + option, Compression, has been added to the data + source creation process. This option enables the + RMF data source to request HTTP compression from + the Data Distributed Server (DDS) during data + retrieval, which improves the efficiency of data + transfer. See Creating RMF data + sources (on page ). + + + Fixed + certain scenarios of missing data within + dashboards for time series visualizations. + + + Fixed + internally found defects. + + + + November 2024 v1.0.7 + + Fixed internally found + defects. + + October 2024 v1.0.6 + + + + The + IBM RMF for z/OS Grafana plugin now allows + customizing banner and caption fields in IBM RMF + Report visualizations. + + + After + you modify any IBM + RMF data source and save the changes, you + no longer need to re-enter the password. + + + Improved + performance. + + + Fixed + internally found defects. + + + + + + + + August 2024 v1.0.5 + + + + When + creating the datasource, you now have the option + to specify the desired cache size in megabytes for + the datasource. + + + Fixed + internally found defects. + + + The + topic of Creating RMF data + sources (on page ) + has been updated per the new UI changes. + + + + June 2024 v1.0.4 + + + + The user + interface for creating the datasource has been + enhanced to improve the user experience. + + + Fixed + internally found defects. + + + The following dashboards are + updated: + Common Storage Activity (Timeline) + Common Storage Activity + Coupling Facility Overview (Timeline) + Coupling Facility Overview + Execution Velocity (Timeline) + Execution Velocity + General Activity (Timeline) + General Activity + Overall Image Activity (Timeline) + Overall Image Activity + Performance Index (Timeline) + Response Time (Timeline) + Response Time + XCF Activity (Timeline) + XCF Activity + Note: You must + re-import the dashboards to utilize the latest + enhancements in the dashboards. + + + The documentation updates for + v1.0.4 include the following changes: + + The + topic of Creating RMF data + sources (on page ) + has been updated as per the new UI changes. + + + The Upgrading the RMF for z/OS plugin on + Grafana (on page ) + topic is included to provide information about the + upgrade process. + + + + + + February 2024 v1.0.3 + + + + Fixed + specific issues related to the support of Grafana + v10.x.x. + + + Fixed + empty settings issue for IBM RMF data source + defined via Home / Apps / IBM RMF page. + + + Fixed + internally found defects. + + + The documentation updates for + v1.0.3 include the following changes: + + The Grafana through IBM z/OS Management + Facility (on page ) + topic explains more detailed setup instructions to + access Grafana from the z/OSMF server. + + + The RMF for z/OS plugin + installation (on page ) + section is updated to provide clear information + and guidance on installing the RMF for + z/OS plugin on different platforms based on + specific requirements. + + + The troubleshooting (on page ) + topic is provided to help users analyze and + resolve common issues that may occur while using + the IBM RMF for z/OS + Grafana plugin. + + + + + + December 2023 v1.0.2 + + + + Support + spaces in Datasource name. + + + Fixed + internally found defects. + + + + November 2023 v1.0.1 + + + + Resolved + security issues in dependencies. + + + Fixed + internally found defects. + + + + November 2023 v1.0.0 + + The + first release of the IBM RMF for z/OS + Grafana plugin is in the following GitHub + repository: https://github.com/IBM/RMF. + + + + + Requirements + You must have the following + software to use the IBM RMF for z/OS Grafana + plugin: + Resource Measurement Facility for z/OS + 3.1 + Distributed Data Server + IBM RMF for z/OS Grafana plugin 1.0.x + Grafana 9.5.1 or later + + + + + + | 1.3 - Installing the RMF for z/OS plugin on Grafana1.3. Installing the RMF for z/OS plugin on + Grafana + + + You must install + the IBM® RMF for z/OS Grafana plugin to + analyze and visualize RMF Monitor III metrics and + reports. + + + Before you begin + + You must have completed the + following tasks: + Installed RMF for z/OS + 3.1 + DDS and the functionality level must be + 3650 or higher. + Installed Grafana 9.5.1 or later. + You must be familiar working with Grafana. + + + + Procedure + + + 1. + Set the value of allow_loading_unsigned_plugins to ibm-rmf,ibm-rmf-datasource,ibm-rmf-report + in the [plugins] section of your custom + configuration file. + + The default configurations + for a Grafana installation are in the defaults.ini file. You can copy the default.ini file and rename it to custom.ini for customizing your Grafana + configuration. + The default location of the configuration file is as follows: + + + Operating systems + Default path to the + configuration file + + + + Windows® + WORKING_DIR/conf/defaults.ini + + + Linux® + /etc/grafana/grafana.ini + + + macOS® + /usr/local/etc/grafana/grafana.ini + + + + Note: You can + use the GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS + environment variable to override allow_loading_unsigned_plugins. + + + 2. + Choose any one of the methods + described in the following table to install the + RMF for z/OS plugin based on your + requirements: + + + + + Methods + Step # + + + + Installing the RMF for z/OS plugin in + the Grafana stand-alone application. + Perform steps 3 (on page ) + and 4 (on page ). + + + Installing the RMF for z/OS plugin + along with Grafana within the Docker + environment. + Perform steps 5 (on page ) + and 6 (on page ). + + + + + + 3. + Run the following command to + install the plugin by using Grafana CLI: + + grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf + Remember: You + must replace the value of <version> for the pluginURL option to version number of the + plugin to be installed. + + + 4. + Restart the Grafana server, + and then go to step 7 (on page ). + + 5. + Run the following command to + create a volume for storing the Grafana + state: + + docker volume create rmf-grafana-data + + + 6. + Run the following command to + create and run a container: + + docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image> + Remember: You + must replace the values of the following options + in the command: + <version> for the env option to the version number of the + plugin to be installed. + <image> to the version of the Grafana + image to be used. + + Note: + zCX/zLinux images are available at Container Images for IBM Z and + LinuxONE. + Similarly, images of other required platforms are + available at Docker + Hub. + + + 7. + To enable the RMF for + z/OS plugin on the Grafana UI, you must + perform the following sub-steps: + + a. + Enter the URL of Grafana in + your web browser. + + b. + Enter the username and + password of Grafana on the sign-in page. + + c. + Go to Administration > + Plugins. + + Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed. + + + d. + Enter RMF in the Search bar on the Plugins page. + + e. + Click IBM + RMF in the search results. + + f. + Click Enable. + + Note: After + you install the IBM RMF for z/OS + Grafana plugin, when you open IBM RMF on + the Plugins page of Grafana UI, an Invalid plugin + signature warning message is + displayed. + + + + + 8. Optional: + Verify the signature of the + IBM RMF Grafana plugin, which is signed with the + GPG key, by performing the following + sub-steps: + + a. + Download the PUBLIC_KEY.asc (GPG public key) + file. + The location of the file is as + follows:https://github.com/IBM/RMF/blob/main/grafana/rmf-app/PUBLIC_KEY.asc + + b. + Follow the instructions in + the Importing a public + key + section of the GPG user guide. + + c. + Download the IBM RMF + for z/OS Grafana plugin (ibm-rmf-grafana-x.y.z.zip) and signature + file (ibm-rmf-grafana-x.y.z.zip.asc) from https://github.com/IBM/RMF/releases. + + d. + Run the following command to + verify the signature: + + gpg --verify ibm-rmf-grafana-x.y.z.zip.asc ibm-rmf-grafana-x.y.z.zip + Where + x.y.z is the version number of the + IBM RMF for z/OS Grafana plugin. + For more + information, refer to the GPG + user guide. + + + + + + + + Results + You have installed the IBM RMF for + z/OS Grafana plugin. You can find the IBM + RMF plugin listed under the Apps + section. + + What to do next + You can add an RMF data source to fetch data from + Distributed Data Servers + (DDS). See Creating RMF data + sources (on page ). + + + + + Related + information + + Grafana CLI + documentation + docker run + command + docker volume create + command + + + + + + + | 1.4 - Upgrading the RMF for z/OS plugin on Grafana1.4. Upgrading the RMF for z/OS plugin on + Grafana + + + You must ensure + that the IBM RMF for z/OS Grafana plugin is up to date to + leverage its enhanced functionalities. You can do so by + either installing or upgrading to the latest version of the + plugin. + + About this task + The upgrade procedures differ based on the environment + you used to install the Grafana server. + + + Methods + Step # + + + + Upgrading the plugin in the Grafana stand-alone + application. + Perform steps 1 (on page ) + to 3 (on page ). + + + Upgrading the plugin in the Grafana within the + Docker environment. + Perfrom steps 4 (on page ) + to 7 (on page ). + + + + + + Procedure + + + 1. + Stop the Grafana + server. + + 2. + Run the following command to + upgrade the plugin by using Grafana CLI: + + grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf + Note: You must + replace the value of <version> for the pluginURL option with the plugin's version + number to be upgraded. + For example, if you want to install the v1.0.3 version of the plugin, the value of pluginURL is https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v1.0.3/ibm-rmf-grafana-1.0.3.zip. + + The CLI tool downloads the + mentioned version of the plugin and replaces the + existing files. + + 3. + Restart the Grafana server, + and then go to step 7 (on page ). + + 4. + Run the following command to + stop the docker container: + + docker stop rmf-grafana + Where + rmf-grafana is the name of the + container. + + + 5. + Run the following command to + remove the docker container: + + docker rm rmf-grafana + + + 6. + Run the following command to + upgrade the plugin by creating and running a + container: + + docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image> + Remember: You + must replace the values of the following options + in the command: + <version> for the env option to the version number of the + plugin to be upgraded. + <image> to the version of the Grafana + image used. + + + + 7. + Perform the following + sub-steps to re-import the dashboards. + After upgrading the plugin to + a new version, it is essential to re-import the + dashboard. This ensures that you are utilizing the + most up-to-date features in the dashboards.Tip: You can + find the updated dashboards for each release by + referring to the CHANGELOG + of the plugin. You do not need to re-import all + the dashboards. + + a. + Enter the URL of Grafana in + your web browser. + + b. + Enter the username and + password of Grafana on the sign-in page. + + c. + Go to Administration > + Plugins. + + Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed. + + + d. + Enter RMF in the Search bar on the Plugins page. + + e. + Click IBM + RMF in the search results. + + f. + Click Dashboards, and then click Re-import to re-import the + dashboards. + + + + + + + Results + You have updated the IBM RMF for + z/OS Grafana plugin. + + + + | 1.5 - Creating RMF data sources1.5. Creating RMF data sources + + To access RMF + Monitor III metrics in Grafana, you need to connect to the + Distributed Data Server (DDS) + by adding an RMF data source. + + + Before you begin + + + You + must have installed the RMF for z/OS Grafana plugin. + See Installing the RMF for z/OS plugin on + Grafana (on page ). + You + must know the hostname and port number of DDS. + + + + + Procedure + + + 1. + Go to Apps > + IBM + RMF > + Add + RMF Data Source. + Alternatively, you can click + Administration > + Data + sources > + + Add + new data source, then search for the + IBM RMF to choose a data source type.Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed. + + 2. + Enter a name for the data + source in the Name field. + + 3. Optional: + Set Default + + to ON to make the + added data source the default one. + + Note: When you + create new panels, the default data source is + preselected. + + + 4. + Enter the details for the + following fields in the HTTP section: + + + + + Fields + Action + + + + DDS + URL + Enter the URL of the DDS in this field.The + format of the URL is http://hostname:port_number[/path] or https://hostname:port_number[/path]Important: In + the DDS URL, the /path is optional, and you must + exclude it in the default network configuration. + However, it might be required in more advanced + setups, such as when DDS functions behind a + reverse proxy. + + + Timeout + Specify the duration, in seconds in this field, + for which Grafana is allowed to wait for a + connection to the DDS before it closes + the connection.The default value is 60. + + + Compression + This option is enabled by default, which means + that when RMF requests data from DDS, HTTP compression is utilized, + provided that the DDS is operating on a + maintenance level OA67541. The compression setting + is ignored if DDS is not at this + maintenance level.You can turn off HTTP + compression by setting the Compression option to OFF, resulting in + DDS data being always transferred in an + uncompressed format. + + + + + + 5. Optional: + Set the Skip + TLS Verify option to ON if you are + accepting any certificate presented by the DDS and + any hostname listed in that certificate. However, + this practice is not considered secure and is + typically used in development or testing + environments. + + Note: By + default, the Skip + TLS Verify option is set to OFF. + + + 6. + Set the Basic + Auth option to ON to create the + data source with basic authentication. + + 7. + Enter the credentials of the + DDS in the User and Password fields. + + Note: The + User and Password fields are visible only when you + enable the basic authentication. + + + 8. + Specify the size of the cache + (in MB) for the data source in the Size field. + + Remember: The + value must be greater than or equal to 128. The default + value is 1024. + + + 9. + Click Save + & test. + The Data source is + working message is displayed if the + connection to DDS succeeds. + + + + + Results + You have added the RMF data source. + + + What to do next + + You can refer + to the RMF master + dashboard (on page ) + topic for information about RMF master dashboard and its + features. + + + + + | 1.6 - RMF master dashboard1.6. RMF master dashboard + + IBM® RMF for z/OS + Grafana is a plugin provides custom panels for the RMF data + source and master dashboard that consists of RMF Charts, RMF + Reporting, and RMF Time Series dashboards. + Grafana provides a + highly flexible and customizable dashboard consisting of one + or more rows and panels. You can use various pre-configured + panels to construct queries and tailor the visualization to + meet your requirements. This enables you to create a + personalized dashboard that seamlessly interacts with data + from a configured Distributed Data Server + (DDS). For more information about creating and + managing dashboards, refer to the Grafana + documentation. + When you install the RMF for z/OS + Grafana plugin for the first time, all the dashboards are + imported automatically. You can view the dashboards by + navigating to Apps > + IBM + RMF > + Dashboards. The following table lists + the dashboards available in RMF Charts, RMF Reporting, and + RMF Time Series dashboards: + Table 1. RMF master + dashboardTable 1. RMF master + dashboard (continued) + + RMF Charts Dashboard + RMF + Reporting Dashboards + RMF Time Series Dashboards + + + + Common Storage + Activity + CACHDET + DSND + PROC + SYSINFO + Common Storage Activity + (Timeline) + + + Coupling Facility + Overview + CACHSUM + EADM + PROCU + SYSRG + Coupling Facility + Overview (Timeline) + + + Execution Velocity + CFACT + ENCLAVE + SPACED + SYSSUM + Execution Velocity + (Timeline) + + + General Activity + CFOVER + ENQ + SPACEG + USAGE + General Activity + (Timeline) + + + Overall Image + Activity + CFSYS + HSM + STOR + XCFGROUP + Overall Image Activity + (Timeline) + + + Performance Index + CHANNEL + IOQ + STORC + XCFOVW + Performance Index + (Timeline) + + + Response Time + CPC + JES + STORCR + XCFPATH + Response Time + + + Using & Delays + CRYOVW + LOCKSP + STORF + XCFSYS + Using & Delays + (Timeline) + + + XCF Activity + DELAY + LOCKSU + STORM + ZFSFS + XCF Activity + (Timeline) + + + Common Storage + Activity + DEV + OPD + STORR + ZFSKN + Common Storage Activity + (Timeline) + + + + DEVR + PCIE + STORS + ZFSOVW + + + + + The dashboard + interface offers several customization options for data + presentation. The following is the image of the master + dashboard from the IBM RMF for z/OS Grafana + plugin: + + You can click the + + option when there is a new version of the plugin, and then + re-import the dashboard by clicking the + icon. Similarly, if any of the dashboards is no longer + required, you can click the + icon to remove it from the master dashboard. + For more + information about available features in the Dashboard and + their descriptions, refer to the Grafana + documentation. + + + + | 1.7 - Applying visualization to RMF data1.7. Applying visualization to RMF + data + + By adding panels + to dashboards, you can effectively present your RMF data in + a visual format. Each panel must require at least one query + to display a significant visualization. + + Before you begin + You must have completed the + following tasks: + Installed the IBM RMF for z/OS + Grafana plugin. See Installing the RMF for z/OS plugin on + Grafana (on page ). + Added + a RMF data source in Grafana. See Creating RMF data + sources (on page ). + Understood query languages of the RMF. See IBM RMF query + languages (on page ). + + + + Procedure + + + 1. + Identify the dashboard for + which you want to add visualization. + + 2. + Perform one of the steps + described in the following table: + + + + + Step description + Step # + + + + If there are no panels added to the + dashboard + Perform step 3 (on page ). + + + If at least one panel is added to the + dashboard + Perform step 5 (on page ). + + + + + + 3. + Click + Add + visualization to add visualization to your + data. + + Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed. + + The Edit + panel is displayed. + + 4. + Go to step 6 (on page ). + + 5. + Click Add > + Visualization from the dashboard + header. + + + + The Edit + panel is displayed. + + 6. + Enter a name for the panel in + the Title field. + Optionally you can also + provide a description for the panel that you are + creating.When you add the description + for the panel, a notification icon + is displayed after the Panel title, as shown in the following + image: + + 7. + Select one of the + visualization types from the drop-down + menu: + + + You can + choose Report + for IBM RMF for z/OS or built-in Bar + chart Grafana visualization types from the + drop-down list. + + + 8. + Click the Query tab, and then enter a query in the + query language of the RMF data source. + + Note: You can + click + + Query to add multiple queries. + + + 9. + Click the Transformation tab, and then select a + transformation from the list. + Upon accessing the + transformation options, a dedicated row is + presented for configuration.Note: You can + click + Add + Transformation to add multiple + transformations to data. + + 10. + Select the existing data + sources from the Data + source drop-down list. + + 11. + Click the Time + Picker drop-down list to select relative + time range options and set custom absolute time + ranges. + + + + + 12. + Click the Refresh dashboard + + icon to query the RMF data source. + Grafana provides you with a + preview of your query results along with the + corresponding visualization. + + 13. Optional: + Click Apply to view your changes applied to the + dashboard. + + 14. + Click Save, and then enter a note describing the + changes you have made. + + 15. + Click Save to store the changes made to the + dashboard. + + + + + Results + You have applied visualization to the RMF + data. + + + What to do next + + Grafana + provides a range of visualizations that cater to + different use cases. For more information about the + built-in panels, options, and typical usage, refer to + the Grafana + documentation. + You can also + configure the panel options based on your requirements. + For more information refer to the Grafana + documentation. + You can add + multiple transformation to your data. When there are + multiple transformations, Grafana applies them + sequentially. Each transformation produces a result set + that is passed on to the next transformation in the + pipeline. Grafana provides several ways that you can + transform data. For entire list of transformations, + refer to the Grafana + documentation. + + + + + | 1.8 - IBM RMF query languages1.8. IBM RMF query languages + + In Grafana, + queries are essential for fetching and transforming data + from RMF data sources. + Executing a query + is a process that involves defining the data source, + specifying the desired data to retrieve, and applying + relevant filters or transformations. IBM RMF for + z/OS Grafana plugin provides a user-friendly RMF + query editor that maximizes its unique capabilities. Grafana + panels retrieve data for visualization from RMF data sources + via queries. + You can use the + following types of queries to retrieve data from the + specified RMF data source: + + Metric + query – Use this query to retrieve RMF Monitor III + metrics. + Report + query – Use this query to retrieve RMF Monitor III + reports. + + + Metric + query syntax + The syntax of + the Metric query is as follows: + resource_type.metric_description {qualifications} + Where: + resource_type is the type of + resource for which information is requested. You + must enter the appropriate value in the resource_type field.The + available resource types are documented in the z/OS RMF Monitor III resource + model + topic in the z/OS + Resource Measurement Facility Programmer's + Guide. + metric_description is the name of + the metric for the selected resource type.After + entering the resource type, you can choose the + metric description from the drop-down + list. + qualifications is an optional + parameter and can contain any or all the following + attributes separated by a comma: + ulq: The name of the resource type + at the upper level. + name: The name of the resource. + filter: The filter helps to focus on + the data of your interest when requesting a list + of values. You can + use one of the following values for the filter attribute: + PAT=< pattern> + Specifies one or more patterns that must match + the name part of a list element. + LB=<number> + Specifies a lower bound value. Only list elements + with values higher than the given lower bound are + returned. + UB=<number> + Specifies an upper bound value. Only list + elements with values lower than the established + upper bound are returned. + HI=<integer> + Only + the highest <integer> list elements are + returned (mutually exclusive with LO). + LO=<integer> + Only + the lowest <integer> list elements are + returned (mutually exclusive with HI). + ORD=< NA | ND | VA | VD | NN> + + + NA - Sort the list of names by their names in + ascending order. + ND – Sort the list of names by their names in + descending order. + VA – Sort the list of values by their values in + ascending order. + VD – Sort the list of values by their values in + descending order. + NN - If you do not want to have any order, you + can specify ORD=NN. + + + + workscope: To qualify a request for + performance data in more detail about address + spaces and WLM entities. You can use one of the + following values for the workscope attribute: + G - Global (no workscope required) + W - WLM workload + S - WLM service class + P - WLM service class period + R - WLM report class + J - Job + + + + Examples: + SYSPLEX.% total physical utilization (AAP) by partition + COUPLING_FACILITY.% processor utilization + CPC.% total physical utilization (shared IIP) + MVS_IMAGE.% delay by WLM report class period {name=RS21} + MVS_IMAGE.% workflow by WLM report class period {ulq=RS21,name=RS2*,filter=ORD=NA,workscope=,,G} + + + Report + query syntax + The syntax of + the Report query is as follows: + resource_type.REPORT.report_name + Where: + resource_type is the type of + resource for which information is requested. You + must enter the appropriate value in the resource_type field. + report_name is the name of the + report.You can + find the report names in the Interactive performance analysis with Monitor + III, + which is documented in the z/OS Resource Measurement + Facility Report Analysis.Note: You can + view reports on the Grafana dashboard only for the + resource types SYSPLEX and MVS_IMAGE. + + Examples: + SYSPLEX.REPORT.CACHSUM + SYSPLEX.REPORT.CPC + + + + + | 1.9 - RMF Variable Query syntax1.9. RMF Variable Query syntax + + Variables are a + powerful tool to create more interactive and dynamic + dashboards. They offer a way to replace hard-coded values in + metric queries and panel titles with placeholders for + values. + Variables make it easy to change the + data displayed in your dashboard simply by selecting a value + from the drop-down list at the top. Using variables in your + dashboard simplifies maintenance, particularly if you have + multiple identical data sources. Instead of creating + separate dashboards for each data source, you can create one + dashboard and use variables to change what you are + viewing.Important: It's + important to note that variables don't have a default + value. Each variable drop-down list in Dashboard + settings displays the variable list in the order it + appears. + You can define a + dashboard variable in Dashboard Settings > + Variables using Grafana's RMF + Variable Query syntax with and without a filter. + Syntax + of the query without a filterThe general syntax of the query + without a filter is as follows:SELECT <COLUMN_NAME> FROM RESOURCE WHERE condition1 or condition2 or condition3Note: The <COLUMN_NAME> is limited to label + and RESOURCE is limited to resource + only and cannot be used for other purposes.Where: + condition1: ULQ=Value + and + TYPE=Value + condition2: Name=Value + and + TYPE=Value + condition3: Name=Value + and + ULQ=Value + and + TYPE=Value + Examples for condition1: + select label from resource + where ulq="hostname of the DDS" and type="CHANNEL_PATH" + select label from resource + where ulq="hostname of the DDS" and type="ALL_CHANNELS" + Examples for condition2:select label from resource where + name="resource_name" and type="SYSPLEX"Examples for condition3: + select label from resource + where ulq="hostname of the DDS" and name="*" and type="CHANNEL_PATH" + select label from resource + where ulq="hostname of the DDS" and name="*" and type="ALL_CHANNELS" + + + Syntax + of the query with a filter + The general + syntax of the RMF query with a filter is as follows: + SELECT <COLUMN_NAME> FROM RESOURCE WHERE condition + Where condition is Name=Value and ULQ=Value and TYPE=Value and Filter= + Value + Examples for condition: + select label from resource where name="resource_name" and type="SYSPLEX" and filter="MVS_IMAGE" + + + To learn how + to effectively add and manage variables of your choice + in Grafana, you can refer to the Grafana + documentation. + + + + + | 1.10 - Introduction to Alerts1.10. Introduction to Alerts + + + Grafana Alerting + feature provides a reliable solution to detect and respond + to system issues in real time. + Through Grafana + monitoring capabilities, you can keep track of incoming + metrics data and configure the alerting system to detect + specific events or circumstances. When the system identifies + any issues, it automatically sends notifications to ensure + that you are up to date. With Grafana Alerting, you can + eliminate the need for manual monitoring and control system + outages that could lead to significant incidents. + For more + information about configuration of alerts and contact + points, refer to the Grafana + documentation. + + + + | 1.11 - Historical data collection1.11. Historical data collection + + + In Grafana, you + can view historical data using absolute and relative time + ranges. + + Viewing + historical data is a common practice across + organizations for various purposes. The importance and + use of historical data are significant in + decision-making, research, analysis, and planning. + Analyzing historical data provides valuable insights + into the status, usage, performance, and health of + various resources. + You can also + access cached metric data for queries, data sources, and + timestamp combinations that have already viewed by other + user on Grafana. This means that if any user requests + metrics data for the same query, datasource, and + timestamp, the cached data can be displayed faster than + a service call from DDS. If data for a particular + timestamp is not found in the cache, it will be fetched + by a service call from DDS. This feature can save you + time and provide a faster experience accessing metric + data. + CAUTION: When + you view data over extended time ranges, the system may + require considerable CPU resources on the host. + + + + + | 1.12 - Error reporting in the plugin1.12. Error reporting in the + plugin + + + Whenever you + encounter issues while using the IBM RMF for z/OS Grafana + plugin, you can view detailed error messages that contain + sufficient information to help you identify and troubleshoot + the problem. + By viewing these + error messages, you can quickly and efficiently troubleshoot + any issues you may encounter while using the IBM RMF for + z/OS Grafana plugin. + The errors that can occur vary in + severity and are classified into different types as + described in the following table: + + + Type + Error Code + Description + + + + Severe + S + A + critical error has arisen that will cause the task + you are currently performing to terminate + immediately.It is essential to take + necessary measures to prevent such errors to + ensure the smooth functioning of the IBM RMF + for z/OS Grafana plugin. + + + Eventual Action + E + An error of a transient nature has arisen but can + be resolved with an action by the user. + + + Warning + W + Receiving a warning message from the IBM RMF + for z/OS Grafana plugin is not indicative + of an error within the application. + + + Information + I + An information message informs the users about + changes or updates in the IBM RMF + for z/OS Grafana plugin.You need + not take any action in response, but it's + essential to stay up-to-date and be aware of these + updates. + + + + When an error + occurs, it is assigned a unique Error ID that can help + quickly identify the root cause of the issue by referring to + the log file. The Error ID is a combination of 10 characters + comprising lower and upper case alphabets. + In case of any + problems with the Distributed Data Server + (DDS), you can identify the issues by looking + into DDS-specific errors, which will be displayed + without any modifications. The messages issued by the Distributed + Data Server are documented in the Distributed Data Server messages - + GPM + topic in the z/OS + Resource Measurement Facility Messages and + Codes. + The following are + the examples of error messages that you may encounter while + using the IBM RMF for z/OS Grafana plugin: + + + Tip: To diagnose the + issue from the docker logs of the IBM RMF for + z/OS Grafana plugin, you can run the following + command: + docker logs <container_name> 2>&1 | grep "<unique error code shown in the error message>" + + + + | 1.13 - Troubleshooting issues1.13. Troubleshooting issues + + This section + guides how to analyze and address typical issues that may + arise when using the IBM® RMF for z/OS Grafana plugin. + + This article + is regularly updated with the latest information on + discovering and solving issues that may arise. You can + search through the article to find the precise + information you need. + You can open a + case by navigating to IBM + support + if you cannot find any solutions for the issue you + encountered. Before opening a case, gather all the + required information and provide the details to IBM + support for further investigation. + The following + table describes the details of issues and the + resolutions you can apply to fix the problems: + + + + Issues + Cause + Resolutions + + + + RMF Time Series + dashboards do not plot the Monitor 3 metrics data, + whereas RMF Reports and RMF Charts dashboards plot + correctly. + The proxy settings + configured by your network administrator block web + socket connections from the Grafana server. + The IBM RMF for z/OS Grafana plugin streams time series data to the clients through web socket connections. + Unblocking web sockets + and configuring the appropriate proxy settings is + necessary to ensure that web sockets with the name + "ws" in the URI work + correctly with the IBM RMF for z/OS + Grafana + plugin.You can contact your network administrator to modify the proxy configuration settings. + + + + + + + + | 1.14 - Grafana through IBM z/OS Management Facility1.14. Grafana through IBM z/OS + Management Facility + + + When you use + IBM® z/OS Management Facility to monitor + the performance of the z/OS sysplexes in your environment, + you can also access Grafana dashboards from z/OSMF. + You must complete certain tasks to + access Grafana through z/OSMF. The following table + lists the task flows to access Grafana from z/OSMF: + + + Tasks + More + information + + + + Complete the tasks + provided in the Prerequisites topic. + Prerequisites for accessing Grafana dashboards on + z/OSMF (on page ) + + + Install the RMF for z/OS + plugin on Grafana. + Installing the RMF for z/OS plugin on + Grafana (on page ) + + + Define Grafana servers as + target systems. + Defining the Grafana + server (on page ) + + + Access Grafana + dashboards + Accessing the Grafana + dashboard (on page ) + + + + + + 1.14.1. Prerequisites for accessing Grafana + dashboards on z/OSMF + + + Before you + can start working with Grafana dashboards through z/OSMF, there are some prerequisites that + you need to complete. + The following + sections describe each prerequisite in detail: + + Configure + z/OSMF + When + installing z/OS, z/OSMF is + automatically installed as a fundamental component + of the operating system. However, to use its + features, you must configure the z/OSMF nucleus on your system and add core + and optional services. This enables you to take + advantage of the many benefits that z/OSMF offers. For more information, refer + to the z/OS Management Facility + Configuration + Guide. + + + Install + Grafana + You must + install Grafana v9.5.1 or later. + For more + information, refer to the Grafana + documentation for detailed instructions on + installing Grafana and its dependencies and starting + the Grafana server on your system. + + + User + administration + You must + review the default user management settings provided + by the Grafana server to determine if you need any + additional permissions to be added for the + users. + For more + information, refer to the User + Management + section of the Grafana documentation. + + + Configure + JSON Web Token (JWT) support on z/OSMF + You must + configure the z/OSMF server to build + and use JSON Web Token (JWT) tokens. Because, by + default, the JWT function is turned off on the z/OSMF server. You can turn on the JWT + authentication by modifying the server's + configuration files directly. Once enabled, the JWT + function allows you to use JWT tokens to + authenticate and authorize user access to the + Grafana through the z/OSMF server. + When + configuring z/OSMF JWK files, it + is essential to use the jwksUri parameter. This parameter + specifies a URL for the JSON Web Key service, which + is necessary for building the JWK files. + The format + of the jwksUri parameter is as follows: + https://${hostname}:${port}/jwt/ibm/api/zOSMFBuilder/jwk + For + example, if your z/OSMF server is + running on https://abc.com:12345, + then the value of jwksUri is: + https://abc.com:12345/jwt/ibm/api/zOSMFBuilder/jwk + Where, + abc is the hostname where the z/OSMF server runs. + 12345 is the port number. + + You must + save the content of jwksUri as the jwks.json file and place it in the + following directory: + /PATH/TO/jwks.json + For + information about enabling the JWT function, refer + to the z/OS Management Facility + Configuration + Guide. + + + Configure + JWT authentication on Grafana + You must + configure Grafana to accept a JWT token in the HTTP + header. You can also verify the token's validity + using a JSON Web Key Set (JWKS) stored in a local + file. + As a + system administrator, when you install Grafana, you + can pass values for some of the individual + parameters in the .ini configuration file to configure JWT + authentication on Grafana. See Grafana configuration + parameters (on page ). + The default location of the + configuration file is as follows: + + + Operating systems + Default path to the + configuration file + + + + Windows® + WORKING_DIR/conf/defaults.ini + + + Linux® + /etc/grafana/grafana.ini + + + macOS® + /usr/local/etc/grafana/grafana.ini + + + + + + + 1.14.1.1. Grafana configuration + parameters + + You can find the information + about parameters you can use during the + configuration of JWT authentication on Grafana. + The + following table lists the minimum parameters that + you must configure to enable JWT authentication on + Grafana: + + + + Section + Parameters + Description + Values to + be configured for z/OSMF + + + + [auth.jwt] + enabled + Use this parameter to + allow JWT to authenticate on the Grafana + server.The default value is set to true. + true + + + enable_login_token + Upon successful + authentication proxy header validation, this + parameter provides the user with a login + token.The default value is set to false. + true + + + header_name + Use this parameter to + specify the header's name that holds a + token.The default value is set to X-JWT-Assertion. + X-Forwarded-Access-Token + + + username_claim + Use this parameter to + identify the user. + The sub claim is mandatory and needs to be present in a JWT, and it should mention the subject of the JWT.The default value is also set to sub. + sub + + + jwk_set_file + Use this parameter to + verify the token with a JSON Web Key Set loaded + from a JSON file. + /PATH/TO/jwks.json + + + cache_ttl + Use this parameter to + establish the duration for caching data retrieved + from the HTTP endpoint. + This parameter enables the user to store the data for a specified period, allowing for faster access and retrieval of information.The default value is set to 60m (minutes). + 60m + + + expect_claims + Use this parameter to + verify the validity of other claims that contain + JSON-encoded information. + When it comes to validation, only the exp, nbf, and iat claims are automatically checked by default.You must validate if you are using other claims such as iss, sub, aud, and jti. + {"iss": + "zOSMF"} + + + auto_sign_up + Use this parameter to + automatically create user profiles in Grafana + using the TSO ID of z/OSMF for users who do not have user + profiles in the Grafana + server.The default value is set to false. + true + + + url_login + Use this parameter to + enable JWT authentication in the URL. + The default value is set to false. + true + + + [server] + protocol + Use this parameter to + configure z/OSMF to work over + HTTPS.When you configure z/OSMF to work over HTTPS, it is recommended to configure Grafana to also work over HTTPS. This ensures the secure data transfer between the user's web browser and the Grafana server.The default value is set to http. + https + + + cert_file + Use this parameter to + specify the path to the certificate file when the + protocol parameter is set to https or h2. + /PATH/TO/certificate.crt + + + cert_key + Use this parameter to + specify the path to the certificate key file when + the protocol parameter is set to https or h2. + /PATH/TO/privateKey.key + + + [Security] + cookie_secure + Use this parameter if you + hosted the Grafana instance over + HTTPS.The default value is set to false. + true + + + cookie_samesite + Use this parameter to + prevent the browser from sharing cookies with + other + websites.The default value is set to lax. + disabled + + + allow_embedding + Use this parameter to + enable web browsers to display Grafana within + z/OSMF HTML <frame>, <iframe>, + <embed>, or <object> element. + The default value is set to false. + true + + + + For more + information about customizing the Grafana instance + by modifying the parameters in the configuration + file, refer to the following sections in the Grafana + documentation. + + Configure JWT + authentication + Configure + Grafana + + + + + + 1.14.2. Defining the Grafana + server + + You must + define the Grafana server as a target system in z/OSMF to access Grafana from the Resource + Monitoring page of z/OSMF. + + Before + you begin + You must have completed the + following tasks: + Completed the tasks provided in the Prerequisites + section. See Prerequisites for accessing Grafana dashboards on + z/OSMF (on page ). + Installed the IBM RMF for z/OS + Grafana plugin. See Installing the RMF for z/OS plugin on + Grafana (on page ). + + + + Procedure + + + 1. + Enter the URL of z/OSMF in a web browser. + + 2. + Log in to z/OSMF if you are not already logged + in. + + 3. + Double-click System + Status. + + 4. + Click Add + Entry from the Actions drop-down list. + + 5. + Perform the following steps + to add details about the Grafana server: + + a. + Enter a name for the Grafana + server in the Resource name field. + The Resource name is the required field, and + you must provide a unique name. The Resource name can contain up to 24 characters + including alphanumeric characters (A-Z, a-z, and 0-9) and special + characters (@ # $). Note: You must + note that the Resource name is not case sensitive. + Therefore, the entries with similar names but + different capitalization, such as SYS1 and Sys1 are considered + as identical by the system. + + b. + Enter the host name or IP + address of the Grafana server that you want to + access in the Host + name or IP address field. + The host name or IP address + can contain up to 4000 + characters. + + c. + Select Grafana from the Target + system type drop-down list. + + d. + Select the Use + HTTPS checkbox to enable secure + communication. + + e. + Enter the port number where + the Grafana server is hosted in the Port field. + + The + Port is the required field, and the + default port number is set to 3000. + Tip: + Alternatively, you can use up-down controls to specify the port + number. + + + + + 6. + Click OK. + + + + + Results + You have defined the Grafana server as the target + system. + + What + to do next + You can perform the following + tasks: + Modify or Remove the Grafana server by clicking + the Action drop-down menu from the System + Status page. + Access Grafana dashboards. See Accessing the Grafana + dashboard (on page ). + + + + + 1.14.3. Accessing the Grafana + dashboard + + You can + access the Grafana dashboard from the Resource + Monitoring page of z/OSMF to investigate the RMF Monitor III + metrics and reports. + + Before + you begin + You must have defined the Grafana server in z/OSMF. See Defining the Grafana + server (on page ). + + + Procedure + + + 1. + Enter the URL of z/OSMF in a web browser. + + 2. + Log in to z/OSMF if you are not already logged + in. + + 3. + Double-click Resource Monitoring. + + 4. + Select the Grafana server + that you want to access from the drop-down + list. + + 5. + Click OK. + + + + + Results + You have accessed Grafana from z/OSMF. + + What + to do next + You can perform the following + tasks: + View the dashboards by navigating to Apps > + IBM + RMF > + Dashboards. + Add a RMF data source to fetch data from Distributed Data Servers (DDS). See Creating RMF data + sources (on page ). + + + + + + + + + + + \ No newline at end of file diff --git a/grafana/rmf-app/doc/src/pdf/rmf_grafana.merged.html b/grafana/rmf-app/doc/src/pdf/rmf_grafana.merged.html new file mode 100644 index 00000000..c6b4a80c --- /dev/null +++ b/grafana/rmf-app/doc/src/pdf/rmf_grafana.merged.html @@ -0,0 +1,1582 @@ + + + + + + +IBM RMF for z/OS Grafana Plugin User Guide
IBM RMF for z/OS Grafana Plugin User Guide
+
IBM RMF for z/OS Grafana Plugin User Guide
+
Grafana is a platform for monitoring and visualizing data. It enables users to create, explore, and share dashboards that are interactive and customizable. The
IBM
RMF for z/OS Grafana plugin provides effortless analysis and visualization of
Resource Measurement Facility for z/OS
(
RMF for z/OS
) Monitor III metrics and reports within the Grafana platform. Thereby, you can monitor and analyze the health and performance of applications.
This article covers the new features, system requirements, and known issues of the
IBM
RMF for z/OS Grafana plugin.
You must install the
IBM
RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports.
You must ensure that the
IBM RMF for z/OS Grafana
plugin is up to date to leverage its enhanced functionalities. You can do so by either installing or upgrading to the latest version of the plugin.
To access RMF Monitor III metrics in Grafana, you need to connect to the
Distributed Data Server
(
DDS
) by adding an RMF data source.
IBM
RMF for z/OS Grafana is a plugin provides custom panels for the RMF data source and master dashboard that consists of RMF Charts, RMF Reporting, and RMF Time Series dashboards.
By adding panels to dashboards, you can effectively present your RMF data in a visual format. Each panel must require at least one query to display a significant visualization.
In Grafana, queries are essential for fetching and transforming data from RMF data sources.
Variables are a powerful tool to create more interactive and dynamic dashboards. They offer a way to replace hard-coded values in metric queries and panel titles with placeholders for values.
Grafana Alerting feature provides a reliable solution to detect and respond to system issues in real time.
In Grafana, you can view historical data using absolute and relative time ranges.
Whenever you encounter issues while using the
IBM RMF for z/OS Grafana
plugin, you can view detailed error messages that contain sufficient information to help you identify and troubleshoot the problem.
This section guides how to analyze and address typical issues that may arise when using the
IBM
RMF for z/OS Grafana plugin.
When you use
IBM
z/OS Management Facility to monitor the performance of the z/OS sysplexes in your environment, you can also access Grafana dashboards from
z/OSMF
.
Before you can start working with Grafana dashboards through
z/OSMF
, there are some prerequisites that you need to complete.
You can find the information about parameters you can use during the configuration of JWT authentication on Grafana.
You must define the Grafana server as a target system in
z/OSMF
to access Grafana from the
Resource Monitoring
page of
z/OSMF
.
You can access the Grafana dashboard from the
Resource Monitoring
page of
z/OSMF
to investigate the RMF Monitor III metrics and reports.
+

IBM RMF for z/OS Grafana Plugin

+

Visualization of RMF Monitor III metrics in Grafana

+
+ +
+ +

Grafana is a platform for monitoring and visualizing data. It enables users to + create, explore, and share dashboards that are interactive and customizable. The IBM® RMF for z/OS Grafana plugin provides effortless analysis and + visualization of Resource Measurement Facility for z/OS (RMF for z/OS) Monitor III metrics and reports within the + Grafana platform. Thereby, you can monitor and analyze the health and performance of + applications.

+
The IBM RMF for z/OS Grafana plugin provides the following + features:
    +
  • You can choose various visualization options, such as graphs, charts, panels, + and reports, to help you understand your data's trends, patterns, and + variances.
  • + +
  • You can create dynamic and engaging dashboards by piecing together various + panels, each displaying a unique visualization.
  • +
  • You have the freedom to customize each panel based on your requirements, + including its appearance, size, and the data queries it displays.
  • +
  • Grafana supports integration with numerous data sources, which helps you fetch + data from various Distributed Data Servers (DDS) and display it in a unified + dashboard.
  • +
  • You can set up alerts based on specific conditions or thresholds in your RMF + data. Grafana can trigger notifications via email or other communication + channels when these conditions are met.
  • +
  • You can define a dashboard variable to change the RMF data displayed in your + dashboard simply by selecting a value from the drop-down list at the top.
  • +
+
+
+

Release notes

+ +

This article covers the new features, system requirements, and known issues of the + IBM® RMF for z/OS Grafana plugin.

+

What's new

+ +
+ +
May 2025 v1.0.9
+
+
    +
  • +

    IBM RMF for z/OS Grafana plugin has been + enhanced to optimize the step size when querying and displaying + time series data, based on the selected time range and panel + size. This enhancement ensures that panels display the required + number of data points.

    +
  • +
  • +

    A bug has been fixed that was causing specific data points to be + dropped from time series views, resulting in a flat line in the + graphs.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+ +
+
+
+
+ +
April 2025 v1.0.8
+
+
    +
  • +

    A new option, Compression, has been added + to the data source creation process. This option enables the RMF + data source to request HTTP compression from the Data + Distributed Server (DDS) during data retrieval, which improves + the efficiency of data transfer. See Creating RMF data sources.

    +
  • +
  • +

    Fixed certain scenarios of missing data within dashboards for + time series visualizations.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+ + +
November 2024 v1.0.7
+
+

Fixed internally found defects.

+ +
+ + +
October 2024 v1.0.6
+
+
    +
  • +

    The IBM RMF for z/OS Grafana plugin now + allows customizing banner and caption fields in IBM RMF Report + visualizations.

    +
  • +
  • +

    After you modify any IBM RMF data + source and save the changes, you no longer need to re-enter the + password.

    +
  • +
  • +

    Improved performance.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+ +
+
+
+
+ +
August 2024 v1.0.5
+
+
    +
  • +

    When creating the datasource, you now have the option to specify + the desired cache size in megabytes for the datasource.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +

    The topic of Creating RMF data sources has been + updated per the new UI changes.

    +
  • +
+
+ + +
June 2024 v1.0.4
+
+
    +
  • +

    The user interface for creating the datasource has been enhanced + to improve the user experience.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +
    The following dashboards are updated:
      +
    • Common Storage Activity (Timeline)
    • +
    • Common Storage Activity
    • +
    • Coupling Facility Overview (Timeline)
    • +
    • Coupling Facility Overview
    • +
    • Execution Velocity (Timeline)
    • +
    • Execution Velocity
    • +
    • General Activity (Timeline)
    • +
    • General Activity
    • +
    • Overall Image Activity (Timeline)
    • +
    • Overall Image Activity
    • +
    • Performance Index (Timeline)
    • +
    • Response Time (Timeline)
    • +
    • Response Time
    • +
    • XCF Activity (Timeline)
    • +
    • XCF Activity
    • +
    Note: You must re-import the + dashboards to utilize the latest enhancements in the + dashboards.
    +
  • +
  • +
    The documentation updates for v1.0.4 include the following + changes:
    +
  • +
+
+ + +
February 2024 v1.0.3
+
+
    +
  • +

    Fixed specific issues related to the support of Grafana + v10.x.x.

    +
  • +
  • +

    Fixed empty settings issue for IBM RMF data source defined via + Home / Apps / IBM RMF page.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +
    The documentation updates for v1.0.3 include the following + changes:
      +
    • +

      The Grafana + through IBM z/OS Management Facility topic + explains more detailed setup instructions to access + Grafana from the z/OSMF server.

      +
    • +
    • +

      The RMF for z/OS plugin + installation section is updated to provide + clear information and guidance on installing the RMF for z/OS plugin on + different platforms based on specific + requirements.

      +
    • +
    • +

      The troubleshooting topic is provided to help + users analyze and resolve common issues that may + occur while using the IBM RMF for z/OS Grafana + plugin.

      +
    • +
    +
  • +
+
+ + +
December 2023 v1.0.2
+
+
    +
  • +

    Support spaces in Datasource name.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+ + +
November 2023 v1.0.1
+
+
    +
  • +

    Resolved security issues in dependencies.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+ + +
November 2023 v1.0.0
+
+

The first release of the IBM RMF for z/OS Grafana + plugin is in the following GitHub repository: https://github.com/IBM/RMF.

+
+ +
+
+

Requirements

+ +
You must have the following software to use the IBM RMF for z/OS Grafana plugin:
    +
  • Resource Measurement Facility for z/OS + 3.1
  • +
  • Distributed Data Server
  • +
  • IBM RMF for z/OS Grafana plugin 1.0.x
  • +
  • Grafana 9.5.1 or later
  • +
+
+ +
+
+

Installing the RMF for z/OS plugin on Grafana

+
+ +
+ +

You must install the IBM® RMF for z/OS Grafana plugin to analyze + and visualize RMF Monitor III metrics and reports.

+

Before you begin

+
You must have completed the following tasks:
    +
  • Installed RMF for z/OS + 3.1 + DDS and the functionality level must + be 3650 or higher.
  • +
  • Installed Grafana 9.5.1 or later.
  • +
You must be familiar working with Grafana.
+
+

Procedure

  1. + Set the value of allow_loading_unsigned_plugins to + ibm-rmf,ibm-rmf-datasource,ibm-rmf-report in the + [plugins] section of your custom configuration + file. +
    +
    The default configurations for a Grafana installation are in the + defaults.ini file. You can copy the + default.ini file and rename it to + custom.ini for customizing your Grafana + configuration. +

    The default location of the configuration file is as follows:

    + + + + + + + + + + + +
    Operating systemsDefault path to the configuration file
    Windows®WORKING_DIR/conf/defaults.ini
    Linux®/etc/grafana/grafana.ini
    macOS®/usr/local/etc/grafana/grafana.ini
    +
    Note: You can use the + GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS + environment variable to override + allow_loading_unsigned_plugins.
    +
    +
  2. + Choose any one of the methods described in the following table to install the + RMF for z/OS plugin based on your requirements: +
    +
    + + + + + + + + +
    MethodsStep #
    Installing the RMF for z/OS + plugin in the Grafana stand-alone application.Perform steps 3 and 4.
    Installing the RMF for z/OS + plugin along with Grafana within the Docker environment.Perform steps 5 and 6.
    +
    +
  3. + Run the following command to install the plugin by using Grafana CLI: +
    +
    grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf
    +
    Remember: You must replace the value of + <version> for the pluginURL + option to version number of the plugin to be installed.
    +
    +
  4. + Restart the Grafana server, and then go to step 7. +
  5. + Run the following command to create a volume for storing the Grafana + state: +
    +
    docker volume create rmf-grafana-data
    +
    +
  6. + Run the following command to create and run a container: +
    +
    docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image>
    +
    Remember: You must replace the values of the + following options in the command:
      +
    • <version> for the env + option to the version number of the plugin to be installed.
    • +
    • <image> to the version of the Grafana image to + be used.
    • +
    +
    Note: zCX/zLinux images are available at Container Images for IBM Z and LinuxONE. + Similarly, images of other required platforms are available at Docker + Hub.
    +
    +
  7. + To enable the RMF for z/OS plugin on the Grafana + UI, you must perform the following sub-steps: +
      +
    1. + Enter the URL of Grafana in your web browser. +
    2. +
    3. + Enter the username and password of Grafana on the + sign-in page. +
    4. +
    5. + Go to Administration > Plugins. +
      +
      Note: The navigation of the user interface can differ based on the + Grafana version that is currently installed.
      +
      +
    6. +
    7. + Enter RMF in the Search bar + on the Plugins page. +
    8. +
    9. + Click IBM RMF in + the search results. +
    10. +
    11. + Click Enable. +
      +
      Note: After you install the IBM RMF for z/OS Grafana plugin, when you open + IBM RMF on the Plugins page of Grafana UI, an + Invalid plugin signature warning message is + displayed.
      +
      +
    12. +
    +
  8. Optional: + Verify the signature of the IBM RMF Grafana plugin, which is signed with the + GPG key, by performing the following sub-steps: +
      +
    1. + Download the PUBLIC_KEY.asc (GPG public key) + file. + +
    2. +
    3. + Follow the instructions in the Importing a public key section of the GPG + user guide. +
    4. +
    5. + Download the IBM RMF for z/OS Grafana plugin + (ibm-rmf-grafana-x.y.z.zip) and signature file + (ibm-rmf-grafana-x.y.z.zip.asc) from https://github.com/IBM/RMF/releases. +
    6. +
    7. + Run the following command to verify the signature: +
      +
      gpg --verify ibm-rmf-grafana-x.y.z.zip.asc ibm-rmf-grafana-x.y.z.zip
      +

      Where x.y.z is the version number + of the IBM RMF for z/OS Grafana plugin.

      +

      For more information, refer to the GPG user guide.

      +
      +
    8. +
    +
+

Results

You have installed the IBM RMF for z/OS Grafana plugin. You can find the IBM RMF plugin listed under the + Apps section.

+

What to do next

You can add an RMF data source to fetch data from Distributed Data Servers (DDS). See Creating RMF data sources.
+
+ +
+

Upgrading the RMF for z/OS plugin on Grafana

+
+ +
+ +

You must ensure that the IBM RMF for z/OS Grafana plugin is up + to date to leverage its enhanced functionalities. You can do so by either installing or + upgrading to the latest version of the plugin.

+

About this task

The upgrade procedures differ based on the environment you used to install the + Grafana server.
+ + + + + + + + +
MethodsStep #
Upgrading the plugin in the Grafana stand-alone application.Perform steps 1 to 3.
Upgrading the plugin in the Grafana within the Docker + environment.Perfrom steps 4 to 7.
+

Procedure

  1. + Stop the Grafana server. +
  2. + Run the following command to upgrade the plugin by using Grafana CLI: +
    +
    grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf
    +
    Note: You must replace the value of + <version> for the pluginURL + option with the plugin's version number to be upgraded. +

    For example, if you want to install the v1.0.3 version of the plugin, the value of pluginURL is https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v1.0.3/ibm-rmf-grafana-1.0.3.zip.

    +
    +
    The CLI tool downloads the mentioned version of the plugin and replaces + the existing files.
    +
  3. + Restart the Grafana server, and then go to step 7. +
  4. + Run the following command to stop the docker container: +
    +
    docker stop rmf-grafana
    +

    Where rmf-grafana is the name of the container.

    +
    +
  5. + Run the following command to remove the docker container: +
    +
    docker rm rmf-grafana
    +
    +
  6. + Run the following command to upgrade the plugin by creating and running a + container: +
    +
    docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image>
    +
    Remember: You must replace the values of the + following options in the command:
      +
    • <version> for the env + option to the version number of the plugin to be upgraded.
    • +
    • <image> to the version of the Grafana image + used.
    • +
    +
    +
  7. + Perform the following sub-steps to re-import the dashboards. +
    After upgrading the plugin to a new version, it is essential to re-import the + dashboard. This ensures that you are utilizing the most up-to-date features in + the dashboards.
    Tip: You can find the updated + dashboards for each release by referring to the CHANGELOG of the plugin. You do not need to + re-import all the dashboards.
    +
      +
    1. + Enter the URL of Grafana in your web browser. +
    2. +
    3. + Enter the username and password of Grafana on the + sign-in page. +
    4. +
    5. + Go to Administration > Plugins. +
      +
      Note: The navigation of the user interface can differ based on the + Grafana version that is currently installed.
      +
      +
    6. +
    7. + Enter RMF in the Search bar + on the Plugins page. +
    8. +
    9. + Click IBM RMF in + the search results. +
    10. +
    11. + Click Dashboards, and then click + Re-import to re-import the dashboards. +
    12. +
    +
+

Results

You have updated the IBM RMF for z/OS Grafana plugin.
+
+
+

Creating RMF data sources

+ +

To access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by + adding an RMF data source.

+

Before you begin

+ +
+

Procedure

  1. + Go to Apps > IBM RMF > Add RMF Data Source. +
    Alternatively, you can click Administration > Data sources > + Add new data source, then search for the IBM RMF to choose a data source type.
    Note: The navigation of the user interface can differ based on the + Grafana version that is currently installed.
    +
  2. + Enter a name for the data source in the Name + field. +
  3. Optional: + Set Default + to + ON to make the added data source the default + one. +
    +
    Note: When you create new panels, the default data source + is preselected.
    +
    +
  4. + Enter the details for the following fields in the HTTP + section: +
    +
    + + + + + + + + + + + +
    FieldsAction
    DDS URLEnter the URL of the DDS in this field.

    The format of the URL is + http://hostname:port_number[/path] + or + https://hostname:port_number[/path]

    Important: In the DDS URL, the + /path is + optional, and you must exclude it in the default network + configuration. However, it might be required in more advanced + setups, such as when DDS + functions behind a reverse proxy.
    TimeoutSpecify the duration, in seconds in this field, for which + Grafana is allowed to wait for a connection to the DDS before it closes the + connection.

    The default value is + 60.

    CompressionThis option is enabled by default, which means that when RMF + requests data from DDS, HTTP + compression is utilized, provided that the DDS is operating on a + maintenance level OA67541. The compression setting is ignored if DDS is not at this + maintenance level.

    You can turn off HTTP compression by setting + the Compression option to + OFF, resulting in DDS data being always + transferred in an uncompressed format.

    +
    +
  5. Optional: + Set the Skip TLS Verify option to + ON if you are accepting any certificate + presented by the DDS and any hostname listed in that certificate. However, this + practice is not considered secure and is typically used in development or + testing environments. +
    +
    Note: By default, the Skip TLS + Verify option is set to + OFF.
    +
    +
  6. + Set the Basic Auth option to + ON to create the data source with basic + authentication. +
  7. + Enter the credentials of the DDS in the + User and Password + fields. +
    +
    Note: The User and + Password fields are visible only when you enable + the basic authentication.
    +
    +
  8. + Specify the size of the cache (in MB) for the data source in the + Size field. +
    +
    Remember: The value must be greater than or + equal to 128. The default value is + 1024.
    +
    +
  9. + Click Save & test. +
    The Data source is working message is displayed if the + connection to DDS succeeds.
    +
+

Results

You have added the RMF data source.
+

What to do next

+

You can refer to the RMF master dashboard topic for information about RMF + master dashboard and its features.

+
+
+
+

RMF master dashboard

+ +

IBM® RMF for z/OS Grafana is a plugin provides custom panels for + the RMF data source and master dashboard that consists of RMF Charts, RMF Reporting, and RMF + Time Series dashboards.

+

Grafana provides a highly flexible and customizable dashboard consisting of one or more + rows and panels. You can use various pre-configured panels to construct queries and + tailor the visualization to meet your requirements. This enables you to create a + personalized dashboard that seamlessly interacts with data from a configured Distributed Data Server (DDS). For more information about creating and managing dashboards, refer to the Grafana documentation.

+
When you install the RMF for z/OS Grafana plugin for the first time, all the dashboards + are imported automatically. You can view the dashboards by navigating to Apps > IBM RMF > Dashboards. The following table lists the dashboards available in RMF Charts, RMF + Reporting, and RMF Time Series dashboards:
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. RMF master dashboard
RMF Charts DashboardRMF Reporting + DashboardsRMF Time Series Dashboards
Common Storage ActivityCACHDETDSNDPROCSYSINFOCommon Storage Activity (Timeline)
Coupling Facility OverviewCACHSUMEADMPROCUSYSRGCoupling Facility Overview (Timeline)
Execution VelocityCFACTENCLAVESPACEDSYSSUMExecution Velocity (Timeline)
General ActivityCFOVERENQSPACEGUSAGEGeneral Activity (Timeline)
Overall Image ActivityCFSYSHSMSTORXCFGROUPOverall Image Activity (Timeline)
Performance IndexCHANNELIOQSTORCXCFOVWPerformance Index (Timeline)
Response TimeCPCJESSTORCRXCFPATHResponse Time
Using & DelaysCRYOVWLOCKSPSTORFXCFSYSUsing & Delays (Timeline)
XCF ActivityDELAYLOCKSUSTORMZFSFSXCF Activity (Timeline)
Common Storage ActivityDEVOPDSTORRZFSKNCommon Storage Activity (Timeline)
DEVRPCIESTORSZFSOVW
+

The dashboard interface offers several customization options for data presentation. The + following is the image of the master dashboard from the IBM RMF for z/OS Grafana plugin:

+

default_dashboard_view

+

You can click the import_dashboard option when there is a new version of the plugin, and then re-import the + dashboard by clicking the reimport icon. Similarly, if any of the dashboards is no longer required, you can click + the icon to remove it + from the master dashboard.

+

For more information about available features in the Dashboard and their descriptions, + refer to the Grafana documentation.

+
+
+

Applying visualization to RMF data

+ +

By adding panels to dashboards, you can effectively present your RMF data in a visual + format. Each panel must require at least one query to display a significant + visualization.

+

Before you begin

You must have completed the following tasks:
+

Procedure

  1. + Identify the dashboard for which you want to add visualization. +
  2. + Perform one of the steps described in the following table: +
    +
    + + + + + + + + +
    Step descriptionStep #
    If there are no panels added to the dashboardPerform step 3.
    If at least one panel is added to the dashboardPerform step 5.
    +
    +
  3. + Click + Add visualization to add visualization to your + data. +
    +
    Note: The navigation of the user interface can differ based on the + Grafana version that is currently installed.
    +
    +
    The Edit panel is displayed.
    +
  4. + Go to step 6. +
  5. + Click Add > Visualization from the dashboard header. +
    +

    +
    +
    The Edit panel is displayed.
    +
  6. + Enter a name for the panel in the Title field. +
    Optionally you can also provide a description for the panel that you are + creating.

    When you add the description for the panel, a notification icon + is + displayed after the Panel title, as shown in the + following image:

    +
  7. + Select one of the visualization types from the drop-down menu: +
    +

    +

    You can choose Report for IBM RMF for z/OS or built-in + Bar chart Grafana visualization types from the + drop-down list.

    +
    +
  8. + Click the Query tab, and then enter a query in the query + language of the RMF data source. +
    +
    Note: You can click + Query to add + multiple queries.
    +
    +
  9. + Click the Transformation tab, and then select a + transformation from the list. +
    Upon accessing the transformation options, a dedicated row is presented for + configuration.
    Note: You can click + Add + Transformation to add multiple transformations to + data.
    +
  10. + Select the existing data sources from the Data source + drop-down list. +
  11. + Click the Time Picker drop-down list to select relative + time range options and set custom absolute time ranges. +
    +

    +
    +
  12. + Click the Refresh dashboard + icon to query the RMF + data source. +
    Grafana provides you with a preview of your query results along with the + corresponding visualization.
    +
  13. Optional: + Click Apply to view your changes applied to the + dashboard. +
  14. + Click Save, and then enter a note describing the changes + you have made. +
  15. + Click Save to store the changes made to the + dashboard. +
+

Results

You have applied visualization to the RMF data.
+

What to do next

+

Grafana provides a range of visualizations that cater to different use cases. For + more information about the built-in panels, options, and typical usage, refer to the + Grafana documentation.

+

You can also configure the panel options based on your requirements. For more + information refer to the Grafana documentation.

+

You can add multiple transformation to your data. When there are multiple + transformations, Grafana applies them sequentially. Each transformation produces a + result set that is passed on to the next transformation in the pipeline. Grafana + provides several ways that you can transform data. For entire list of + transformations, refer to the Grafana documentation.

+
+
+
+

IBM RMF query languages

+ +

In Grafana, queries are essential for fetching and transforming data from RMF data + sources.

+

Executing a query is a process that involves defining the data source, specifying the + desired data to retrieve, and applying relevant filters or transformations. IBM RMF for z/OS Grafana plugin provides a user-friendly RMF query + editor that maximizes its unique capabilities. Grafana panels retrieve data for + visualization from RMF data sources via queries.

+

You can use the following types of queries to retrieve data from the specified RMF data + source:

+
    +
  • Metric query – Use this query to retrieve RMF Monitor III metrics.
  • +
  • Report query – Use this query to retrieve RMF Monitor III reports.
  • +
+

Metric query syntax

+ +

The syntax of the Metric query is as follows:

+

resource_type.metric_description + {qualifications}

+
Where:
    +
  • resource_type is the type + of resource for which information is requested. You must enter the + appropriate value in the + resource_type field.

    The + available resource types are documented in the z/OS RMF Monitor III resource + model topic in the z/OS Resource Measurement Facility Programmer's + Guide.

  • +
  • metric_description is the name of the + metric for the selected resource type.

    After entering the resource type, + you can choose the metric description from the drop-down list.

  • +
  • qualifications is an optional parameter + and can contain any or all the following attributes separated by a comma:
      +
    • ulq: The name of the resource + type at the upper level.
    • +
    • name: The name of the + resource.
    • +
    • filter: The filter helps to + focus on the data of your interest when requesting a list of values. +
      You can use one of the following values for the + filter attribute:
      + +
      PAT=< pattern>
      +
      Specifies one or more patterns that must match the + name part of a list element.
      + + +
      LB=<number>
      +
      Specifies a lower bound value. Only list elements + with values higher than the given lower bound are + returned.
      + + +
      UB=<number>
      +
      Specifies an upper bound value. Only list elements + with values lower than the established upper bound + are returned.
      + + +
      HI=<integer>
      +
      Only the highest <integer> list elements are + returned (mutually exclusive with LO).
      + + +
      LO=<integer>
      +
      Only the lowest <integer> list elements are + returned (mutually exclusive with HI).
      + + +
      ORD=< NA | ND | VA | VD | NN>
      +
      +
        +
      • NA - Sort the list of names by their names in + ascending order.
      • +
      • ND – Sort the list of names by their names in + descending order.
      • +
      • VA – Sort the list of values by their values + in ascending order.
      • +
      • VD – Sort the list of values by their values + in descending order.
      • +
      • NN - If you do not want to have any order, you + can specify ORD=NN.
      • +
      +
      + +
    • +
    • workscope: To qualify a request + for performance data in more detail about address spaces and WLM + entities. You can use one of the following values for the workscope + attribute:
        +
      • G - Global (no workscope required)
      • +
      • W - WLM workload
      • +
      • S - WLM service class
      • +
      • P - WLM service class period
      • +
      • R - WLM report class
      • +
      • J - Job
      • +
    • +
  • +
+

Examples:

+
SYSPLEX.% total physical utilization (AAP) by partition
+
COUPLING_FACILITY.% processor utilization
+
CPC.% total physical utilization (shared IIP)
+
MVS_IMAGE.% delay by WLM report class period {name=RS21}
+ +
MVS_IMAGE.% workflow by WLM report class period {ulq=RS21,name=RS2*,filter=ORD=NA,workscope=,,G}
+
+

Report query syntax

+ +

The syntax of the Report query is as follows:

+

resource_type.REPORT.report_name

+
Where:
    +
  • resource_type is the type + of resource for which information is requested. You must enter the + appropriate value in the + resource_type field.
  • +
  • report_name is the name of the + report.

    You can find the report names in the Interactive performance analysis with + Monitor III, which is documented in the z/OS Resource Measurement Facility Report Analysis.

    Note: You can view reports on the Grafana dashboard only + for the resource types SYSPLEX and + MVS_IMAGE.
  • +
+

Examples:

+
SYSPLEX.REPORT.CACHSUM
+
SYSPLEX.REPORT.CPC
+
+
+
+

RMF Variable Query syntax

+ +

Variables are a powerful tool to create more interactive and dynamic dashboards. They + offer a way to replace hard-coded values in metric queries and panel titles with + placeholders for values.

+
Variables make it easy to change the data displayed in your dashboard simply by selecting + a value from the drop-down list at the top. Using variables in your dashboard simplifies + maintenance, particularly if you have multiple identical data sources. Instead of + creating separate dashboards for each data source, you can create one dashboard and use + variables to change what you are viewing.
Important: It's important to note that variables don't have a default value. Each variable + drop-down list in Dashboard settings displays the variable list in the order it + appears.
+

You can define a dashboard variable in Dashboard Settings > Variables using Grafana's RMF Variable Query syntax with and without a filter.

+

Syntax of the query without a filter

The + general syntax of the query without a filter is as follows:

SELECT + <COLUMN_NAME> FROM RESOURCE WHERE condition1 or + condition2 or + condition3

Note: The + <COLUMN_NAME> is limited to label and + RESOURCE is limited to resource only and cannot be used + for other purposes.
Where:
    +
  • condition1: + ULQ=Value + and + TYPE=Value
  • +
  • condition2: + Name=Value + and + TYPE=Value
  • +
  • condition3: + Name=Value + and + ULQ=Value + and + TYPE=Value
  • +
Examples for condition1:
    +
  • select label from resource where + ulq="hostname of the + DDS" and + type="CHANNEL_PATH"
  • +
  • select label from resource where + ulq="hostname of the + DDS" and + type="ALL_CHANNELS"
  • +

Examples for condition2:

select + label from resource where + name="resource_name" and + type="SYSPLEX"
Examples + for condition3:
    +
  • select label from resource where + ulq="hostname of the + DDS" and + name="*" and + type="CHANNEL_PATH"
  • +
  • select label from resource where + ulq="hostname of the + DDS" and + name="*" and + type="ALL_CHANNELS"
  • +
+

Syntax of the query with a filter

+ +

The general syntax of the RMF query with a filter is as follows:

+

SELECT <COLUMN_NAME> FROM RESOURCE WHERE + condition

+

Where condition is + Name=Value and + ULQ=Value and + TYPE=Value and + Filter= + Value

+

Examples for condition:

+

select label from resource where + name="resource_name" + and type="SYSPLEX" and + filter="MVS_IMAGE"

+
+
+

To learn how to effectively add and manage variables of your choice in Grafana, you + can refer to the Grafana documentation.

+
+
+
+

Introduction to Alerts

+
+ +
+ +

Grafana Alerting feature provides a reliable solution to detect and respond to system + issues in real time.

+

Through Grafana monitoring capabilities, you can keep track of incoming metrics data and + configure the alerting system to detect specific events or circumstances. When the + system identifies any issues, it automatically sends notifications to ensure that you + are up to date. With Grafana Alerting, you can eliminate the need for manual monitoring + and control system outages that could lead to significant incidents.

+

For more information about configuration of alerts and contact points, refer to the Grafana documentation.

+ +
+
+

Historical data collection

+
+ +
+ +

In Grafana, you can view historical data using absolute and relative time + ranges.

+
+

Viewing historical data is a common practice across organizations for various + purposes. The importance and use of historical data are significant in + decision-making, research, analysis, and planning. Analyzing historical data + provides valuable insights into the status, usage, performance, and health of + various resources.

+

You can also access cached metric data for queries, data sources, and timestamp + combinations that have already viewed by other user on Grafana. This means that if + any user requests metrics data for the same query, datasource, and timestamp, the + cached data can be displayed faster than a service call from DDS. If data for a + particular timestamp is not found in the cache, it will be fetched by a service call + from DDS. This feature can save you time and provide a faster experience accessing + metric data.

+
CAUTION: When you view data over extended time ranges, + the system may require considerable CPU resources on the host.
+ + + + +
+
+
+

Error reporting in the plugin

+
+ +
+ +

Whenever you encounter issues while using the IBM RMF for z/OS Grafana plugin, you can view detailed error messages + that contain sufficient information to help you identify and troubleshoot the + problem.

+

By viewing these error messages, you can quickly and efficiently troubleshoot any issues + you may encounter while using the IBM RMF for z/OS Grafana + plugin.

+
The errors that can occur vary in severity and are classified into different types as + described in the following table:
+ + + + + + + + + + + + + + + + + + + +
TypeError CodeDescription
SevereSA critical error has arisen that will cause the task you are currently + performing to terminate immediately.

It is essential to take necessary + measures to prevent such errors to ensure the smooth functioning of the + IBM RMF for z/OS Grafana plugin.

Eventual Action EAn error of a transient nature has arisen but can be resolved with an + action by the user.
WarningWReceiving a warning message from the IBM RMF for z/OS Grafana plugin is not indicative of an + error within the application.
InformationIAn information message informs the users about changes or updates in + the IBM RMF for z/OS Grafana plugin.

You need not + take any action in response, but it's essential to stay up-to-date and + be aware of these updates.

+

When an error occurs, it is assigned a unique Error ID that can help quickly identify the + root cause of the issue by referring to the log file. The Error ID is a combination of + 10 characters comprising lower and upper case alphabets.

+

In case of any problems with the Distributed Data Server (DDS), you can identify the issues by looking + into DDS-specific errors, which will be + displayed without any modifications. The messages issued by the Distributed Data Server are documented in the Distributed Data Server messages - GPM topic + in the z/OS Resource Measurement Facility Messages and Codes.

+

The following are the examples of error messages that you may encounter while using the + IBM RMF for z/OS Grafana plugin:

+

DDS_error

+

Error_plugin

+
Tip: To diagnose the issue from the docker logs of the IBM RMF for z/OS Grafana plugin, you can run the following command: +
docker logs <container_name> 2>&1 | grep "<unique error code shown in the error message>"
+
+
+

Troubleshooting issues

+ +

This section guides how to analyze and address typical issues that may arise when + using the IBM® RMF for z/OS Grafana plugin.

+
+

This article is regularly updated with the latest information on discovering and + solving issues that may arise. You can search through the article to find the + precise information you need.

+

You can open a case by navigating to IBM support if you cannot find any + solutions for the issue you encountered. Before opening a case, gather all the + required information and provide the details to IBM support for further + investigation.

+

The following table describes the details of issues and the resolutions you can apply + to fix the problems:

+
+ + + + + + + + + + + +
IssuesCauseResolutions
RMF Time Series dashboards do not plot the Monitor 3 metrics + data, whereas RMF Reports and RMF Charts dashboards plot + correctly.The proxy settings configured by your network administrator block + web socket connections from the Grafana server. +

The IBM RMF for z/OS Grafana plugin streams time series data to the clients through web socket connections.

Unblocking web sockets and configuring the appropriate proxy + settings is necessary to ensure that web sockets with the name + "ws" in the URI work correctly with + the IBM RMF for z/OS Grafana + plugin.

You can contact your network administrator to modify the proxy configuration settings.

+
+
+
+

Grafana through IBM z/OS Management Facility

+
+ +
+ +

When you use IBM® z/OS Management Facility to monitor the + performance of the z/OS sysplexes in your environment, you can also access Grafana + dashboards from z/OSMF.

+
You must complete certain tasks to access Grafana through z/OSMF. The following table lists the task flows + to access Grafana from z/OSMF:
+ + + + + + + + + + + + + + + + + + + + + +
TasksMore information
Complete the tasks provided in the Prerequisites topic.Prerequisites for accessing Grafana dashboards on z/OSMF
Install the RMF for z/OS plugin on Grafana.Installing the RMF for z/OS plugin on Grafana
Define Grafana servers as target systems.Defining the Grafana server
Access Grafana dashboardsAccessing the Grafana dashboard
+
+
+

Prerequisites for accessing Grafana dashboards on z/OSMF

+
+ +
+ +

Before you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to + complete.

+

The following sections describe each prerequisite in detail:

+

Configure z/OSMF

+ +

When installing z/OS, z/OSMF is automatically + installed as a fundamental component of the operating system. However, to use its + features, you must configure the z/OSMF + nucleus on your system and add core and optional services. This enables you to take + advantage of the many benefits that z/OSMF + offers. For more information, refer to the z/OS Management Facility Configuration Guide.

+
+

Install Grafana

+ +

You must install Grafana v9.5.1 or later.

+

For more information, refer to the Grafana documentation for detailed + instructions on installing Grafana and its dependencies and starting the Grafana + server on your system.

+
+

User administration

+ +

You must review the default user management settings provided by the Grafana server + to determine if you need any additional permissions to be added for the users.

+ +

For more information, refer to the User Management section of the Grafana + documentation.

+
+

Configure JSON Web Token (JWT) support on z/OSMF

+ +

You must configure the z/OSMF server to build + and use JSON Web Token (JWT) tokens. Because, by default, the JWT function is turned + off on the z/OSMF server. You can turn on the + JWT authentication by modifying the server's configuration files directly. Once + enabled, the JWT function allows you to use JWT tokens to authenticate and authorize + user access to the Grafana through the z/OSMF + server.

+

When configuring z/OSMF JWK files, it is + essential to use the jwksUri parameter. This parameter + specifies a URL for the JSON Web Key service, which is necessary for building the + JWK files.

+

The format of the jwksUri parameter is as follows:

+

https://${hostname}:${port}/jwt/ibm/api/zOSMFBuilder/jwk

+

For example, if your z/OSMF server is running + on https://abc.com:12345, then the value of jwksUri + is:

+

https://abc.com:12345/jwt/ibm/api/zOSMFBuilder/jwk

+
Where,
    +
  • abc is the hostname where the z/OSMF server runs.
  • +
  • 12345 is the port number.
  • +
+

You must save the content of jwksUri as the + jwks.json file and place it in the following directory:

+

/PATH/TO/jwks.json

+

For information about enabling the JWT function, refer to the z/OS Management Facility Configuration Guide.

+
+

Configure JWT authentication on Grafana

+ +

You must configure Grafana to accept a JWT token in the HTTP header. You can also + verify the token's validity using a JSON Web Key Set (JWKS) stored in a local + file.

+

As a system administrator, when you install Grafana, you can pass values for some of + the individual parameters in the .ini configuration file to + configure JWT authentication on Grafana. See Grafana configuration parameters.

+
The default location of the configuration file is as follows:
+ + + + + + + + + + + +
Operating systemsDefault path to the configuration file
Windows®WORKING_DIR/conf/defaults.ini
Linux®/etc/grafana/grafana.ini
macOS®/usr/local/etc/grafana/grafana.ini
+
+
+
+

Grafana configuration parameters

+ +

You can find the information about parameters you can use during the configuration of + JWT authentication on Grafana.

+

The following table lists the minimum parameters that you must configure to enable JWT + authentication on Grafana:

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SectionParametersDescriptionValues to be configured for z/OSMF
[auth.jwt]enabledUse this parameter to allow JWT to authenticate on the Grafana + server.

The default value is set to true.

true
enable_login_tokenUpon successful authentication proxy header validation, this + parameter provides the user with a login + token.

The default value is set to false.

true
header_nameUse this parameter to specify the header's name that holds a + token.

The default value is set to X-JWT-Assertion.

X-Forwarded-Access-Token
username_claimUse this parameter to identify the user. +

The sub claim is mandatory and needs to be present in a JWT, and it should mention the subject of the JWT.

The default value is also set to sub.

sub
jwk_set_fileUse this parameter to verify the token with a JSON Web Key Set loaded + from a JSON file./PATH/TO/jwks.json
cache_ttlUse this parameter to establish the duration for caching data + retrieved from the HTTP endpoint. +

This parameter enables the user to store the data for a specified period, allowing for faster access and retrieval of information.

The default value is set to 60m (minutes).

60m
expect_claimsUse this parameter to verify the validity of other claims that + contain JSON-encoded information. +

When it comes to validation, only the exp, nbf, and iat claims are automatically checked by default.

You must validate if you are using other claims such as iss, sub, aud, and jti.

{"iss": "zOSMF"}
auto_sign_upUse this parameter to automatically create user profiles in Grafana + using the TSO ID of z/OSMF for users who do not have + user profiles in the Grafana + server.

The default value is set to false.

true
url_loginUse this parameter to enable JWT authentication in the URL. +

The default value is set to false.

true
[server]protocolUse this parameter to configure z/OSMF to work over + HTTPS.

When you configure z/OSMF to work over HTTPS, it is recommended to configure Grafana to also work over HTTPS. This ensures the secure data transfer between the user's web browser and the Grafana server.

The default value is set to http.

https
cert_fileUse this parameter to specify the path to the certificate file when + the protocol parameter is set to https or + h2./PATH/TO/certificate.crt
cert_keyUse this parameter to specify the path to the certificate key file + when the protocol parameter is set to https + or h2./PATH/TO/privateKey.key
[Security]cookie_secureUse this parameter if you hosted the Grafana instance over + HTTPS.

The default value is set to false.

true
cookie_samesiteUse this parameter to prevent the browser from sharing cookies with + other + websites.

The default value is set to lax.

disabled
allow_embeddingUse this parameter to enable web browsers to display Grafana within + z/OSMF HTML <frame>, + <iframe>, <embed>, or <object> element. +

The default value is set to false.

true
+

For more information about customizing the Grafana instance by modifying the parameters + in the configuration file, refer to the following sections in the Grafana + documentation.

+ +
+
+

Defining the Grafana server

+ +

You must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource + Monitoring page of z/OSMF.

+

Before you begin

You must have completed the following tasks:
+

Procedure

  1. + Enter the URL of z/OSMF in a web browser. +
  2. + Log in to z/OSMF if + you are not already logged in. +
  3. + Double-click System Status. +
  4. + Click Add Entry from the Actions + drop-down list. +
  5. + Perform the following steps to add details about the Grafana server: +
      +
    1. + Enter a name for the Grafana server in the Resource + name field. +
      The Resource name is the required field, and + you must provide a unique name. The Resource name + can contain up to 24 characters including + alphanumeric characters (A-Z, + a-z, and + 0-9) and special characters + (@ # $).
      Note: You must note that the Resource name is not + case sensitive. Therefore, the entries with similar names but + different capitalization, such as SYS1 + and Sys1 are considered as identical by + the system.
      +
    2. +
    3. + Enter the host name or IP address of the Grafana server that you want + to access in the Host name or IP address + field. +
      The host name or IP address can contain up to + 4000 characters.
      +
    4. +
    5. + Select Grafana from the Target system + type drop-down list. +
    6. +
    7. + Select the Use HTTPS checkbox to enable secure + communication. +
    8. +
    9. + Enter the port number where the Grafana server is hosted in the + Port field. +
      +

      The Port is the required field, and the + default port number is set to 3000.

      +
      Tip: Alternatively, you can use + up-down controls to specify the port + number.
      +
      +
    10. +
    +
  6. + Click OK. +
+

Results

You have defined the Grafana server as the target + system.
+

What to do next

You can perform the following tasks:
    +
  • Modify or Remove the Grafana server by clicking the + Action drop-down menu from the System + Status page.
  • +
  • Access Grafana dashboards. See Accessing the Grafana dashboard.
  • +
+
+
+

Accessing the Grafana dashboard

+ +

You can access the Grafana dashboard from the Resource + Monitoring page of z/OSMF to + investigate the RMF Monitor III metrics and reports.

+

Before you begin

You must have defined the Grafana server in z/OSMF. See Defining the Grafana server.
+

Procedure

  1. + Enter the URL of z/OSMF in a web browser. +
  2. + Log in to z/OSMF if + you are not already logged in. +
  3. + Double-click Resource Monitoring. +
  4. + Select the Grafana server that you want to access from the drop-down + list. +
  5. + Click OK. +
+

Results

You have accessed Grafana from z/OSMF.
+

What to do next

You can perform the following tasks:
    +
  • View the dashboards by navigating to Apps > IBM RMF > Dashboards.
  • +
  • Add a RMF data source to fetch data from Distributed Data Servers (DDS). See Creating RMF data + sources.
  • +
+
+
\ No newline at end of file diff --git a/grafana/rmf-app/doc/src/pdf/rmf_grafana.merged.xml b/grafana/rmf-app/doc/src/pdf/rmf_grafana.merged.xml new file mode 100644 index 00000000..25e509ee --- /dev/null +++ b/grafana/rmf-app/doc/src/pdf/rmf_grafana.merged.xml @@ -0,0 +1,1723 @@ + + + + + + +IBM RMF for z/OS Grafana Plugin <ph class="- topic/ph " props="pdf">User Guide</ph> + IBM RMF for z/OS Grafana Plugin <ph class="- topic/ph " props="pdf">User Guide</ph> + IBM RMF for z/OS Grafana PluginOverviewGrafana is a platform for monitoring and visualizing data. It enables users to create, explore, and share dashboards that are interactive and customizable. The IBM RMF for z/OS Grafana plugin provides effortless analysis and visualization of Resource Measurement Facility for z/OS (RMF for z/OS) Monitor III metrics and reports within the Grafana platform. Thereby, you can monitor and analyze the health and performance of applications.Release notesThis article covers the new features, system requirements, and known issues of the IBM RMF for z/OS Grafana plugin.Installing the pluginYou must install the IBM RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports.Upgrading the pluginYou must ensure that the IBM RMF for z/OS Grafana plugin is up to date to leverage its enhanced functionalities. You can do so by either installing or upgrading to the latest version of the plugin.Creating RMF data sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source.RMF master dashboardIBM RMF for z/OS Grafana is a plugin provides custom panels for the RMF data source and master dashboard that consists of RMF Charts, RMF Reporting, and RMF Time Series dashboards.Applying visualization to RMF dataBy adding panels to dashboards, you can effectively present your RMF data in a visual format. Each panel must require at least one query to display a significant visualization.IBM RMF query languagesIn Grafana, queries are essential for fetching and transforming data from RMF data sources.RMF Variable Query syntaxVariables are a powerful tool to create more interactive and dynamic dashboards. They offer a way to replace hard-coded values in metric queries and panel titles with placeholders for values.AlertsGrafana Alerting feature provides a reliable solution to detect and respond to system issues in real time.Historical dataIn Grafana, you can view historical data using absolute and relative time ranges.Error typesWhenever you encounter issues while using the IBM RMF for z/OS Grafana plugin, you can view detailed error messages that contain sufficient information to help you identify and troubleshoot the problem.Troubleshooting issuesThis section guides how to analyze and address typical issues that may arise when using the IBM RMF for z/OS Grafana plugin.Grafana through z/OSMFWhen you use IBM z/OS Management Facility to monitor the performance of the z/OS sysplexes in your environment, you can also access Grafana dashboards from z/OSMF.PrerequisitesBefore you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to complete.Grafana configuration parametersYou can find the information about parameters you can use during the configuration of JWT authentication on Grafana.Defining the Grafana serverYou must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource Monitoring page of z/OSMF.Accessing the Grafana dashboardYou can access the Grafana dashboard from the Resource Monitoring page of z/OSMF to investigate the RMF Monitor III metrics and reports. +<ph class="- topic/ph topic/title-wrapper ">IBM RMF for z/OS Grafana Plugin</ph> + <ph class="- topic/ph topic/title-wrapper ">Visualization of RMF Monitor III metrics in Grafana</ph> + + Overview + + Grafana is a platform for monitoring and visualizing data. It enables users to + create, explore, and share dashboards that are interactive and customizable. The IBM RMF for z/OS Grafana plugin provides effortless analysis and + visualization of Resource Measurement Facility for z/OS (RMF for z/OS) Monitor III metrics and reports within the + Grafana platform. Thereby, you can monitor and analyze the health and performance of + applications. + +

The IBM RMF for z/OS Grafana plugin provides the following + features:

    +
  • You can choose various visualization options, such as graphs, charts, panels, + and reports, to help you understand your data's trends, patterns, and + variances.
  • + +
  • You can create dynamic and engaging dashboards by piecing together various + panels, each displaying a unique visualization.
  • +
  • You have the freedom to customize each panel based on your requirements, + including its appearance, size, and the data queries it displays.
  • +
  • Grafana supports integration with numerous data sources, which helps you fetch + data from various Distributed Data Servers (DDS) and display it in a unified + dashboard.
  • +
  • You can set up alerts based on specific conditions or thresholds in your RMF + data. Grafana can trigger notifications via email or other communication + channels when these conditions are met.
  • +
  • You can define a dashboard variable to change the RMF data displayed in your + dashboard simply by selecting a value from the drop-down list at the top.
  • +

+
+
+ <ph class="- topic/ph topic/title-wrapper ">Release notes</ph> + This article covers the new features, system requirements, and known issues of the + IBM RMF for z/OS Grafana plugin. + +
+ What's new +
+ +
May 2025 v1.0.9
+
+
    +
  • +

    IBM RMF for z/OS Grafana plugin has been + enhanced to optimize the step size when querying and displaying + time series data, based on the selected time range and panel + size. This enhancement ensures that panels display the required + number of data points.

    +
  • +
  • +

    A bug has been fixed that was causing specific data points to be + dropped from time series views, resulting in a flat line in the + graphs.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+
+
+
+
+
+ +
April 2025 v1.0.8
+
+
    +
  • +

    A new option, Compression, has been added + to the data source creation process. This option enables the RMF + data source to request HTTP compression from the Data + Distributed Server (DDS) during data retrieval, which improves + the efficiency of data transfer. See Creating RMF data sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source..

    +
  • +
  • +

    Fixed certain scenarios of missing data within dashboards for + time series visualizations.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+
+ +
November 2024 v1.0.7
+
+

Fixed internally found defects.

+ +
+
+ +
October 2024 v1.0.6
+
+
    +
  • +

    The IBM RMF for z/OS Grafana plugin now + allows customizing banner and caption fields in IBM RMF Report + visualizations.

    +
  • +
  • +

    After you modify any IBM RMF data + source and save the changes, you no longer need to re-enter the + password.

    +
  • +
  • +

    Improved performance.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+
+
+
+
+
+ +
August 2024 v1.0.5
+
+
    +
  • +

    When creating the datasource, you now have the option to specify + the desired cache size in megabytes for the datasource.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +

    The topic of Creating RMF data sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source. has been + updated per the new UI changes.

    +
  • +
+
+
+ +
June 2024 v1.0.4
+
+
    +
  • +

    The user interface for creating the datasource has been enhanced + to improve the user experience.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +

    The following dashboards are updated:

      +
    • Common Storage Activity (Timeline)
    • +
    • Common Storage Activity
    • +
    • Coupling Facility Overview (Timeline)
    • +
    • Coupling Facility Overview
    • +
    • Execution Velocity (Timeline)
    • +
    • Execution Velocity
    • +
    • General Activity (Timeline)
    • +
    • General Activity
    • +
    • Overall Image Activity (Timeline)
    • +
    • Overall Image Activity
    • +
    • Performance Index (Timeline)
    • +
    • Response Time (Timeline)
    • +
    • Response Time
    • +
    • XCF Activity (Timeline)
    • +
    • XCF Activity
    • +
    You must re-import the + dashboards to utilize the latest enhancements in the + dashboards.

    +
  • +
  • +

    The documentation updates for v1.0.4 include the following + changes:

      +
    • +

      The topic of Creating RMF data sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source. + has been updated as per the new UI changes.

      +
    • +
    • +

      The Upgrading the RMF for z/OS plugin on GrafanaYou must ensure that the IBM RMF for z/OS Grafana plugin is up to date to leverage its enhanced functionalities. You can do so by either installing or upgrading to the latest version of the plugin. topic is + included to provide information about the upgrade + process.

      +
    • +

    +
  • +
+
+
+ +
February 2024 v1.0.3
+
+
    +
  • +

    Fixed specific issues related to the support of Grafana + v10.x.x.

    +
  • +
  • +

    Fixed empty settings issue for IBM RMF data source defined via + Home / Apps / IBM RMF page.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
  • +

    The documentation updates for v1.0.3 include the following + changes:

      +
    • +

      The Grafana + through IBM z/OS Management FacilityWhen you use IBM z/OS Management Facility to monitor the performance of the z/OS sysplexes in your environment, you can also access Grafana dashboards from z/OSMF. topic + explains more detailed setup instructions to access + Grafana from the z/OSMF server.

      +
    • +
    • +

      The RMF for z/OS plugin + installationYou must install the IBM RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports. section is updated to provide + clear information and guidance on installing the RMF for z/OS plugin on + different platforms based on specific + requirements.

      +
    • +
    • +

      The troubleshootingThis section guides how to analyze and address typical issues that may arise when using the IBM RMF for z/OS Grafana plugin. topic is provided to help + users analyze and resolve common issues that may + occur while using the IBM RMF for z/OS Grafana + plugin.

      +
    • +

    +
  • +
+
+
+ +
December 2023 v1.0.2
+
+
    +
  • +

    Support spaces in Datasource name.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+
+ +
November 2023 v1.0.1
+
+
    +
  • +

    Resolved security issues in dependencies.

    +
  • +
  • +

    Fixed internally found defects.

    +
  • +
+
+
+ +
November 2023 v1.0.0
+
+

The first release of the IBM RMF for z/OS Grafana + plugin is in the following GitHub repository: https://github.com/IBM/RMF.

+
+
+
+
+
+ Requirements +

You must have the following software to use the IBM RMF for z/OS Grafana plugin:

    +
  • Resource Measurement Facility for z/OS + 3.1
  • +
  • Distributed Data Server
  • +
  • IBM RMF for z/OS Grafana plugin 1.0.x
  • +
  • Grafana 9.5.1 or later
  • +

+
+ +
+
+ <ph class="- topic/ph topic/title-wrapper ">Installing the RMF for z/OS plugin on Grafana</ph> + + Installing the plugin + + You must install the IBM RMF for z/OS Grafana plugin to analyze + and visualize RMF Monitor III metrics and reports. + + +

You must have completed the following tasks:

    +
  • Installed RMF for z/OS + 3.1 + DDS and the functionality level must + be 3650 or higher.
  • +
  • Installed Grafana 9.5.1 or later.
  • +
You must be familiar working with Grafana.

+
+ + + Set the value of allow_loading_unsigned_plugins to + ibm-rmf,ibm-rmf-datasource,ibm-rmf-report in the + [plugins] section of your custom configuration + file. + +

The default configurations for a Grafana installation are in the + defaults.ini file. You can copy the + default.ini file and rename it to + custom.ini for customizing your Grafana + configuration. + The default location of the configuration file is as follows: + + Operating systems + Default path to the configuration file + + + Windows + WORKING_DIR/conf/defaults.ini + + + Linux + /etc/grafana/grafana.ini + + + macOS + /usr/local/etc/grafana/grafana.ini + +

+ You can use the + GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS + environment variable to override + allow_loading_unsigned_plugins. +
+
+ + Choose any one of the methods described in the following table to install the + RMF for z/OS plugin based on your requirements: + + + + Methods + Step # + + + Installing the RMF for z/OS + plugin in the Grafana stand-alone application. + Perform steps 3 and 4. + + + Installing the RMF for z/OS + plugin along with Grafana within the Docker environment. + Perform steps 5 and 6. + + + + + + Run the following command to install the plugin by using Grafana CLI: + + grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf + You must replace the value of + <version> for the pluginURL + option to version number of the plugin to be installed. + + + + + + Restart the Grafana server, and then go to step 7. + + + Run the following command to create a volume for storing the Grafana + state: + + docker volume create rmf-grafana-data + + + + Run the following command to create and run a container: + + docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image> + You must replace the values of the + following options in the command:
    +
  • <version> for the env + option to the version number of the plugin to be installed.
  • +
  • <image> to the version of the Grafana image to + be used.
  • +
+ zCX/zLinux images are available at Container Images for IBM Z and LinuxONE. + Similarly, images of other required platforms are available at Docker + Hub. +
+
+ + To enable the RMF for z/OS plugin on the Grafana + UI, you must perform the following sub-steps: + + + Enter the URL of Grafana in your web browser. + + + Enter the username and password of Grafana on the + sign-in page. + + + Go to AdministrationPlugins. + + The navigation of the user interface can differ based on the + Grafana version that is currently installed. + + + + Enter RMF in the Search bar + on the Plugins page. + + + Click IBM RMF in + the search results. + + + Click Enable. + + After you install the IBM RMF for z/OS Grafana plugin, when you open + IBM RMF on the Plugins page of Grafana UI, an + Invalid plugin signature warning message is + displayed. + + + + + + Verify the signature of the IBM RMF Grafana plugin, which is signed with the + GPG key, by performing the following sub-steps: + + + Download the PUBLIC_KEY.asc (GPG public key) + file. + The location of the file is as + follows: + + + Follow the instructions in the Importing a public key section of the GPG + user guide. + + + Download the IBM RMF for z/OS Grafana plugin + (ibm-rmf-grafana-x.y.z.zip) and signature file + (ibm-rmf-grafana-x.y.z.zip.asc) from https://github.com/IBM/RMF/releases. + + + Run the following command to verify the signature: + + gpg --verify ibm-rmf-grafana-x.y.z.zip.asc ibm-rmf-grafana-x.y.z.zip +

Where x.y.z is the version number + of the IBM RMF for z/OS Grafana plugin.

+

For more information, refer to the GPG user guide.

+
+
+
+
+
+ You have installed the IBM RMF for z/OS Grafana plugin. You can find the IBM RMF plugin listed under the + Apps section.

+ You can add an RMF data source to fetch data from Distributed Data Servers (DDS). See Creating RMF data sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source.. +
+ + Grafana CLI documentation + docker run command + docker volume create command + +
+ <ph class="- topic/ph topic/title-wrapper ">Upgrading the RMF for z/OS plugin on Grafana</ph> + + Upgrading the plugin + + You must ensure that the IBM RMF for z/OS Grafana plugin is up + to date to leverage its enhanced functionalities. You can do so by either installing or + upgrading to the latest version of the plugin. + + The upgrade procedures differ based on the environment you used to install the + Grafana server. + + Methods + Step # + + + Upgrading the plugin in the Grafana stand-alone application. + Perform steps 1 to 3. + + + Upgrading the plugin in the Grafana within the Docker + environment. + Perfrom steps 4 to 7. + + + + + Stop the Grafana server. + + + Run the following command to upgrade the plugin by using Grafana CLI: + + grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf + You must replace the value of + <version> for the pluginURL + option with the plugin's version number to be upgraded. + For example, if you want to install the v1.0.3 version of the plugin, the value of pluginURL is https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v1.0.3/ibm-rmf-grafana-1.0.3.zip. + + The CLI tool downloads the mentioned version of the plugin and replaces + the existing files. + + + Restart the Grafana server, and then go to step 7. + + + Run the following command to stop the docker container: + + docker stop rmf-grafana +

Where rmf-grafana is the name of the container.

+
+
+ + Run the following command to remove the docker container: + + docker rm rmf-grafana + + + + Run the following command to upgrade the plugin by creating and running a + container: + + docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image> + You must replace the values of the + following options in the command:
    +
  • <version> for the env + option to the version number of the plugin to be upgraded.
  • +
  • <image> to the version of the Grafana image + used.
  • +
+
+
+ + Perform the following sub-steps to re-import the dashboards. + After upgrading the plugin to a new version, it is essential to re-import the + dashboard. This ensures that you are utilizing the most up-to-date features in + the dashboards.You can find the updated + dashboards for each release by referring to the CHANGELOG of the plugin. You do not need to + re-import all the dashboards. + + + Enter the URL of Grafana in your web browser. + + + Enter the username and password of Grafana on the + sign-in page. + + + Go to AdministrationPlugins. + + The navigation of the user interface can differ based on the + Grafana version that is currently installed. + + + + Enter RMF in the Search bar + on the Plugins page. + + + Click IBM RMF in + the search results. + + + Click Dashboards, and then click + Re-import to re-import the dashboards. + + + +
+ You have updated the IBM RMF for z/OS Grafana plugin. +
+
+ <ph class="- topic/ph topic/title-wrapper ">Creating RMF data sources</ph> + To access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by + adding an RMF data source. + + +
    +
  • You must have installed the RMF for z/OS Grafana plugin. See Installing the RMF for z/OS plugin on GrafanaYou must install the IBM RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports..
  • +
  • You must know the hostname and port number of DDS.
  • +
+
+ + + Go to AppsIBM RMFAdd RMF Data Source. + Alternatively, you can click AdministrationData sources+ Add new data source, then search for the IBM RMF to choose a data source type.The navigation of the user interface can differ based on the + Grafana version that is currently installed. + + + Enter a name for the data source in the Name + field. + + + Set Default + to + ON to make the added data source the default + one. + + When you create new panels, the default data source + is preselected. + + + + Enter the details for the following fields in the HTTP + section: + + + + Fields + Action + + + DDS URL + Enter the URL of the DDS in this field.

The format of the URL is + http://hostname:port_number[/path] + or + https://hostname:port_number[/path]

In the DDS URL, the + /path is + optional, and you must exclude it in the default network + configuration. However, it might be required in more advanced + setups, such as when DDS + functions behind a reverse proxy.
+
+ + Timeout + Specify the duration, in seconds in this field, for which + Grafana is allowed to wait for a connection to the DDS before it closes the + connection.

The default value is + 60.

+
+ + Compression + This option is enabled by default, which means that when RMF + requests data from DDS, HTTP + compression is utilized, provided that the DDS is operating on a + maintenance level OA67541. The compression setting is ignored if DDS is not at this + maintenance level.

You can turn off HTTP compression by setting + the Compression option to + OFF, resulting in DDS data being always + transferred in an uncompressed format.

+
+
+
+
+ + Set the Skip TLS Verify option to + ON if you are accepting any certificate + presented by the DDS and any hostname listed in that certificate. However, this + practice is not considered secure and is typically used in development or + testing environments. + + By default, the Skip TLS + Verify option is set to + OFF. + + + + Set the Basic Auth option to + ON to create the data source with basic + authentication. + + + Enter the credentials of the DDS in the + User and Password + fields. + + The User and + Password fields are visible only when you enable + the basic authentication. + + + + Specify the size of the cache (in MB) for the data source in the + Size field. + + The value must be greater than or + equal to 128. The default value is + 1024. + + + + Click Save & test. + The Data source is working message is displayed if the + connection to DDS succeeds. + +
+ You have added the RMF data source. + +

You can refer to the RMF master dashboardIBM RMF for z/OS Grafana is a plugin provides custom panels for the RMF data source and master dashboard that consists of RMF Charts, RMF Reporting, and RMF Time Series dashboards. topic for information about RMF + master dashboard and its features.

+
+
+
+ <ph class="- topic/ph topic/title-wrapper ">RMF master dashboard</ph> + IBM RMF for z/OS Grafana is a plugin provides custom panels for + the RMF data source and master dashboard that consists of RMF Charts, RMF Reporting, and RMF + Time Series dashboards. + +

Grafana provides a highly flexible and customizable dashboard consisting of one or more + rows and panels. You can use various pre-configured panels to construct queries and + tailor the visualization to meet your requirements. This enables you to create a + personalized dashboard that seamlessly interacts with data from a configured Distributed Data Server (DDS). For more information about creating and managing dashboards, refer to the Grafana documentation.

+

When you install the RMF for z/OS Grafana plugin for the first time, all the dashboards + are imported automatically. You can view the dashboards by navigating to AppsIBM RMFDashboards. The following table lists the dashboards available in RMF Charts, RMF + Reporting, and RMF Time Series dashboards: + <ph class="- topic/ph topic/title-wrapper ">RMF master dashboard</ph> + + + + + + + + + + RMF Charts Dashboard + RMF Reporting + Dashboards + RMF Time Series Dashboards + + + + + Common Storage Activity + CACHDET + DSND + PROC + SYSINFO + Common Storage Activity (Timeline) + + + Coupling Facility Overview + CACHSUM + EADM + PROCU + SYSRG + Coupling Facility Overview (Timeline) + + + Execution Velocity + CFACT + ENCLAVE + SPACED + SYSSUM + Execution Velocity (Timeline) + + + General Activity + CFOVER + ENQ + SPACEG + USAGE + General Activity (Timeline) + + + Overall Image Activity + CFSYS + HSM + STOR + XCFGROUP + Overall Image Activity (Timeline) + + + Performance Index + CHANNEL + IOQ + STORC + XCFOVW + Performance Index (Timeline) + + + Response Time + CPC + JES + STORCR + XCFPATH + Response Time + + + Using & Delays + CRYOVW + LOCKSP + STORF + XCFSYS + Using & Delays (Timeline) + + + XCF Activity + DELAY + LOCKSU + STORM + ZFSFS + XCF Activity (Timeline) + + + Common Storage Activity + DEV + OPD + STORR + ZFSKN + Common Storage Activity (Timeline) + + + + DEVR + PCIE + STORS + ZFSOVW + + + + +

+

The dashboard interface offers several customization options for data presentation. The + following is the image of the master dashboard from the IBM RMF for z/OS Grafana plugin:

+

+ default_dashboard_view +

+

You can click the + import_dashboard + option when there is a new version of the plugin, and then re-import the + dashboard by clicking the + reimport + icon. Similarly, if any of the dashboards is no longer required, you can click + the icon to remove it + from the master dashboard.

+

For more information about available features in the Dashboard and their descriptions, + refer to the Grafana documentation.

+
+
+ <ph class="- topic/ph topic/title-wrapper ">Applying visualization to RMF data</ph> + By adding panels to dashboards, you can effectively present your RMF data in a visual + format. Each panel must require at least one query to display a significant + visualization. + + You must have completed the following tasks:
    +
  • Installed the IBM RMF for z/OS Grafana plugin. See Installing the RMF for z/OS plugin on GrafanaYou must install the IBM RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports..
  • +
  • Added a RMF data source in Grafana. See Creating RMF data sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source..
  • +
  • Understood query languages of the RMF. See IBM RMF query languagesIn Grafana, queries are essential for fetching and transforming data from RMF data sources..
  • +
+ + + Identify the dashboard for which you want to add visualization. + + + Perform one of the steps described in the following table: + + + + Step description + Step # + + + If there are no panels added to the dashboard + Perform step 3. + + + If at least one panel is added to the dashboard + Perform step 5. + + + + + + Click + Add visualization to add visualization to your + data. + + The navigation of the user interface can differ based on the + Grafana version that is currently installed. + + The Edit panel is displayed. + + + Go to step 6. + + + Click AddVisualization from the dashboard header. + +

+
+ The Edit panel is displayed. +
+ + Enter a name for the panel in the Title field. + Optionally you can also provide a description for the panel that you are + creating.

When you add the description for the panel, a notification icon + is + displayed after the Panel title, as shown in the + following image:

+
+ + Select one of the visualization types from the drop-down menu: + +

+

You can choose Report for IBM RMF for z/OS or built-in + Bar chart Grafana visualization types from the + drop-down list.

+
+
+ + Click the Query tab, and then enter a query in the query + language of the RMF data source. + + You can click + Query to add + multiple queries. + + + + Click the Transformation tab, and then select a + transformation from the list. + Upon accessing the transformation options, a dedicated row is presented for + configuration.You can click + Add + Transformation to add multiple transformations to + data. + + + Select the existing data sources from the Data source + drop-down list. + + + Click the Time Picker drop-down list to select relative + time range options and set custom absolute time ranges. + +

+
+
+ + Click the Refresh dashboard + icon to query the RMF + data source. + Grafana provides you with a preview of your query results along with the + corresponding visualization. + + + Click Apply to view your changes applied to the + dashboard. + + + Click Save, and then enter a note describing the changes + you have made. + + + Click Save to store the changes made to the + dashboard. + +
+ You have applied visualization to the RMF data. + +

Grafana provides a range of visualizations that cater to different use cases. For + more information about the built-in panels, options, and typical usage, refer to the + Grafana documentation.

+

You can also configure the panel options based on your requirements. For more + information refer to the Grafana documentation.

+

You can add multiple transformation to your data. When there are multiple + transformations, Grafana applies them sequentially. Each transformation produces a + result set that is passed on to the next transformation in the pipeline. Grafana + provides several ways that you can transform data. For entire list of + transformations, refer to the Grafana documentation.

+
+
+
+ <ph class="- topic/ph topic/title-wrapper ">IBM RMF query languages</ph> + In Grafana, queries are essential for fetching and transforming data from RMF data + sources. + +

Executing a query is a process that involves defining the data source, specifying the + desired data to retrieve, and applying relevant filters or transformations. IBM RMF for z/OS Grafana plugin provides a user-friendly RMF query + editor that maximizes its unique capabilities. Grafana panels retrieve data for + visualization from RMF data sources via queries.

+

You can use the following types of queries to retrieve data from the specified RMF data + source:

+
    +
  • Metric query – Use this query to retrieve RMF Monitor III metrics.
  • +
  • Report query – Use this query to retrieve RMF Monitor III reports.
  • +
+
+ Metric query syntax +

The syntax of the Metric query is as follows:

+

resource_type.metric_description + {qualifications}

+

Where:

    +
  • resource_type is the type + of resource for which information is requested. You must enter the + appropriate value in the + resource_type field.

    The + available resource types are documented in the z/OS RMF Monitor III resource + model topic in the z/OS Resource Measurement Facility Programmer's + Guide.

  • +
  • metric_description is the name of the + metric for the selected resource type.

    After entering the resource type, + you can choose the metric description from the drop-down list.

  • +
  • qualifications is an optional parameter + and can contain any or all the following attributes separated by a comma:
      +
    • ulq: The name of the resource + type at the upper level.
    • +
    • name: The name of the + resource.
    • +
    • filter: The filter helps to + focus on the data of your interest when requesting a list of values. +

      You can use one of the following values for the + filter attribute:

      + +
      PAT=< pattern>
      +
      Specifies one or more patterns that must match the + name part of a list element.
      +
      + +
      LB=<number>
      +
      Specifies a lower bound value. Only list elements + with values higher than the given lower bound are + returned.
      +
      + +
      UB=<number>
      +
      Specifies an upper bound value. Only list elements + with values lower than the established upper bound + are returned.
      +
      + +
      HI=<integer>
      +
      Only the highest <integer> list elements are + returned (mutually exclusive with LO).
      +
      + +
      LO=<integer>
      +
      Only the lowest <integer> list elements are + returned (mutually exclusive with HI).
      +
      + +
      ORD=< NA | ND | VA | VD | NN>
      +
      +
        +
      • NA - Sort the list of names by their names in + ascending order.
      • +
      • ND – Sort the list of names by their names in + descending order.
      • +
      • VA – Sort the list of values by their values + in ascending order.
      • +
      • VD – Sort the list of values by their values + in descending order.
      • +
      • NN - If you do not want to have any order, you + can specify ORD=NN.
      • +
      +
      +
      +

    • +
    • workscope: To qualify a request + for performance data in more detail about address spaces and WLM + entities. You can use one of the following values for the workscope + attribute:
        +
      • G - Global (no workscope required)
      • +
      • W - WLM workload
      • +
      • S - WLM service class
      • +
      • P - WLM service class period
      • +
      • R - WLM report class
      • +
      • J - Job
      • +
    • +
  • +

+

Examples:

+ SYSPLEX.% total physical utilization (AAP) by partition + COUPLING_FACILITY.% processor utilization + CPC.% total physical utilization (shared IIP) + MVS_IMAGE.% delay by WLM report class period {name=RS21} + + MVS_IMAGE.% workflow by WLM report class period {ulq=RS21,name=RS2*,filter=ORD=NA,workscope=,,G} +
+
+ Report query syntax +

The syntax of the Report query is as follows:

+

resource_type.REPORT.report_name

+

Where:

    +
  • resource_type is the type + of resource for which information is requested. You must enter the + appropriate value in the + resource_type field.
  • +
  • report_name is the name of the + report.

    You can find the report names in the Interactive performance analysis with + Monitor III, which is documented in the z/OS Resource Measurement Facility Report Analysis.

    You can view reports on the Grafana dashboard only + for the resource types SYSPLEX and + MVS_IMAGE.
  • +

+

Examples:

+ SYSPLEX.REPORT.CACHSUM + SYSPLEX.REPORT.CPC +
+
+
+ <ph class="- topic/ph topic/title-wrapper ">RMF Variable Query syntax</ph> + Variables are a powerful tool to create more interactive and dynamic dashboards. They + offer a way to replace hard-coded values in metric queries and panel titles with + placeholders for values. + +

Variables make it easy to change the data displayed in your dashboard simply by selecting + a value from the drop-down list at the top. Using variables in your dashboard simplifies + maintenance, particularly if you have multiple identical data sources. Instead of + creating separate dashboards for each data source, you can create one dashboard and use + variables to change what you are viewing.It's important to note that variables don't have a default value. Each variable + drop-down list in Dashboard settings displays the variable list in the order it + appears.

+

You can define a dashboard variable in Dashboard SettingsVariables using Grafana's RMF Variable Query syntax with and without a filter.

+
Syntax of the query without a filter

The + general syntax of the query without a filter is as follows:

SELECT + <COLUMN_NAME> FROM RESOURCE WHERE condition1 or + condition2 or + condition3

The + <COLUMN_NAME> is limited to label and + RESOURCE is limited to resource only and cannot be used + for other purposes.

Where:

    +
  • condition1: + ULQ=Value + and + TYPE=Value
  • +
  • condition2: + Name=Value + and + TYPE=Value
  • +
  • condition3: + Name=Value + and + ULQ=Value + and + TYPE=Value
  • +

Examples for condition1:

    +
  • select label from resource where + ulq="hostname of the + DDS" and + type="CHANNEL_PATH"
  • +
  • select label from resource where + ulq="hostname of the + DDS" and + type="ALL_CHANNELS"
  • +

Examples for condition2:

select + label from resource where + name="resource_name" and + type="SYSPLEX"

Examples + for condition3:

    +
  • select label from resource where + ulq="hostname of the + DDS" and + name="*" and + type="CHANNEL_PATH"
  • +
  • select label from resource where + ulq="hostname of the + DDS" and + name="*" and + type="ALL_CHANNELS"
  • +

+
+ Syntax of the query with a filter +

The general syntax of the RMF query with a filter is as follows:

+

SELECT <COLUMN_NAME> FROM RESOURCE WHERE + condition

+

Where condition is + Name=Value and + ULQ=Value and + TYPE=Value and + Filter= + Value

+

Examples for condition:

+

select label from resource where + name="resource_name" + and type="SYSPLEX" and + filter="MVS_IMAGE"

+
+ +

To learn how to effectively add and manage variables of your choice in Grafana, you + can refer to the Grafana documentation.

+
+
+
+ <ph class="- topic/ph topic/title-wrapper ">Introduction to Alerts</ph> + + Alerts + + Grafana Alerting feature provides a reliable solution to detect and respond to system + issues in real time. + +

Through Grafana monitoring capabilities, you can keep track of incoming metrics data and + configure the alerting system to detect specific events or circumstances. When the + system identifies any issues, it automatically sends notifications to ensure that you + are up to date. With Grafana Alerting, you can eliminate the need for manual monitoring + and control system outages that could lead to significant incidents.

+

For more information about configuration of alerts and contact points, refer to the Grafana documentation.

+ +
+
+ <ph class="- topic/ph topic/title-wrapper ">Historical data collection</ph> + + Historical data + + In Grafana, you can view historical data using absolute and relative time + ranges. + +
+

Viewing historical data is a common practice across organizations for various + purposes. The importance and use of historical data are significant in + decision-making, research, analysis, and planning. Analyzing historical data + provides valuable insights into the status, usage, performance, and health of + various resources.

+

You can also access cached metric data for queries, data sources, and timestamp + combinations that have already viewed by other user on Grafana. This means that if + any user requests metrics data for the same query, datasource, and timestamp, the + cached data can be displayed faster than a service call from DDS. If data for a + particular timestamp is not found in the cache, it will be fetched by a service call + from DDS. This feature can save you time and provide a faster experience accessing + metric data.

+ When you view data over extended time ranges, + the system may require considerable CPU resources on the host. + + + + +
+
+
+ <ph class="- topic/ph topic/title-wrapper ">Error reporting in the plugin</ph> + + Error types + + Whenever you encounter issues while using the IBM RMF for z/OS Grafana plugin, you can view detailed error messages + that contain sufficient information to help you identify and troubleshoot the + problem. + +

By viewing these error messages, you can quickly and efficiently troubleshoot any issues + you may encounter while using the IBM RMF for z/OS Grafana + plugin.

+

The errors that can occur vary in severity and are classified into different types as + described in the following table: + + Type + Error Code + Description + + + Severe + S + A critical error has arisen that will cause the task you are currently + performing to terminate immediately.

It is essential to take necessary + measures to prevent such errors to ensure the smooth functioning of the + IBM RMF for z/OS Grafana plugin.

+ + + Eventual Action + E + An error of a transient nature has arisen but can be resolved with an + action by the user. + + + Warning + W + Receiving a warning message from the IBM RMF for z/OS Grafana plugin is not indicative of an + error within the application. + + + Information + I + An information message informs the users about changes or updates in + the IBM RMF for z/OS Grafana plugin.

You need not + take any action in response, but it's essential to stay up-to-date and + be aware of these updates.

+
+

+

When an error occurs, it is assigned a unique Error ID that can help quickly identify the + root cause of the issue by referring to the log file. The Error ID is a combination of + 10 characters comprising lower and upper case alphabets.

+

In case of any problems with the Distributed Data Server (DDS), you can identify the issues by looking + into DDS-specific errors, which will be + displayed without any modifications. The messages issued by the Distributed Data Server are documented in the Distributed Data Server messages - GPM topic + in the z/OS Resource Measurement Facility Messages and Codes.

+

The following are the examples of error messages that you may encounter while using the + IBM RMF for z/OS Grafana plugin:

+

+ DDS_error +

+

+ Error_plugin +

+ To diagnose the issue from the docker logs of the IBM RMF for z/OS Grafana plugin, you can run the following command: + docker logs <container_name> 2>&1 | grep "<unique error code shown in the error message>" +
+
+ <ph class="- topic/ph topic/title-wrapper ">Troubleshooting issues</ph> + This section guides how to analyze and address typical issues that may arise when + using the IBM RMF for z/OS Grafana plugin. + +
+

This article is regularly updated with the latest information on discovering and + solving issues that may arise. You can search through the article to find the + precise information you need.

+

You can open a case by navigating to IBM support if you cannot find any + solutions for the issue you encountered. Before opening a case, gather all the + required information and provide the details to IBM support for further + investigation.

+

The following table describes the details of issues and the resolutions you can apply + to fix the problems:

+ + + + + + + + Issues + Cause + Resolutions + + + + + RMF Time Series dashboards do not plot the Monitor 3 metrics + data, whereas RMF Reports and RMF Charts dashboards plot + correctly. + The proxy settings configured by your network administrator block + web socket connections from the Grafana server. + The IBM RMF for z/OS Grafana plugin streams time series data to the clients through web socket connections. + Unblocking web sockets and configuring the appropriate proxy + settings is necessary to ensure that web sockets with the name + "ws" in the URI work correctly with + the IBM RMF for z/OS Grafana + plugin.You can contact your network administrator to modify the proxy configuration settings. + + + +
+
+
+
+ <ph class="- topic/ph topic/title-wrapper ">Grafana through <ph class="- topic/ph ">IBM z/OS Management Facility</ph></ph> + + Grafana through z/OSMF + + When you use IBM z/OS Management Facility to monitor the + performance of the z/OS sysplexes in your environment, you can also access Grafana + dashboards from z/OSMF. + +

You must complete certain tasks to access Grafana through z/OSMF. The following table lists the task flows + to access Grafana from z/OSMF: + + + + + + Tasks + More information + + + + + Complete the tasks provided in the Prerequisites topic. + Prerequisites for accessing Grafana dashboards on z/OSMFBefore you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to complete. + + + Install the RMF for z/OS plugin on Grafana. + Installing the RMF for z/OS plugin on GrafanaYou must install the IBM RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports. + + + Define Grafana servers as target systems. + Defining the Grafana serverYou must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource Monitoring page of z/OSMF. + + + Access Grafana dashboards + Accessing the Grafana dashboardYou can access the Grafana dashboard from the Resource Monitoring page of z/OSMF to investigate the RMF Monitor III metrics and reports. + + + +

+
+ + <ph class="- topic/ph topic/title-wrapper ">Prerequisites for accessing Grafana dashboards on <ph class="- topic/ph ">z/OSMF</ph></ph> + + Prerequisites + + Before you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to + complete. + +

The following sections describe each prerequisite in detail:

+
+ Configure <ph class="- topic/ph ">z/OSMF</ph> +

When installing z/OS, z/OSMF is automatically + installed as a fundamental component of the operating system. However, to use its + features, you must configure the z/OSMF + nucleus on your system and add core and optional services. This enables you to take + advantage of the many benefits that z/OSMF + offers. For more information, refer to the z/OS Management Facility Configuration Guide.

+
+
+ Install Grafana +

You must install Grafana v9.5.1 or later.

+

For more information, refer to the Grafana documentation for detailed + instructions on installing Grafana and its dependencies and starting the Grafana + server on your system.

+
+
+ User administration +

You must review the default user management settings provided by the Grafana server + to determine if you need any additional permissions to be added for the users.

+ +

For more information, refer to the User Management section of the Grafana + documentation.

+
+
+ Configure JSON Web Token (JWT) support on <ph class="- topic/ph ">z/OSMF</ph> +

You must configure the z/OSMF server to build + and use JSON Web Token (JWT) tokens. Because, by default, the JWT function is turned + off on the z/OSMF server. You can turn on the + JWT authentication by modifying the server's configuration files directly. Once + enabled, the JWT function allows you to use JWT tokens to authenticate and authorize + user access to the Grafana through the z/OSMF + server.

+

When configuring z/OSMF JWK files, it is + essential to use the jwksUri parameter. This parameter + specifies a URL for the JSON Web Key service, which is necessary for building the + JWK files.

+

The format of the jwksUri parameter is as follows:

+

https://${hostname}:${port}/jwt/ibm/api/zOSMFBuilder/jwk

+

For example, if your z/OSMF server is running + on https://abc.com:12345, then the value of jwksUri + is:

+

https://abc.com:12345/jwt/ibm/api/zOSMFBuilder/jwk

+

Where,

    +
  • abc is the hostname where the z/OSMF server runs.
  • +
  • 12345 is the port number.
  • +

+

You must save the content of jwksUri as the + jwks.json file and place it in the following directory:

+

/PATH/TO/jwks.json

+

For information about enabling the JWT function, refer to the z/OS Management Facility Configuration Guide.

+
+
+ Configure JWT authentication on Grafana +

You must configure Grafana to accept a JWT token in the HTTP header. You can also + verify the token's validity using a JSON Web Key Set (JWKS) stored in a local + file.

+

As a system administrator, when you install Grafana, you can pass values for some of + the individual parameters in the .ini configuration file to + configure JWT authentication on Grafana. See Grafana configuration parametersYou can find the information about parameters you can use during the configuration of JWT authentication on Grafana..

+

The default location of the configuration file is as follows: + + Operating systems + Default path to the configuration file + + + Windows + WORKING_DIR/conf/defaults.ini + + + Linux + /etc/grafana/grafana.ini + + + macOS + /usr/local/etc/grafana/grafana.ini + +

+
+ + + <ph class="- topic/ph topic/title-wrapper ">Grafana configuration parameters</ph> + You can find the information about parameters you can use during the configuration of + JWT authentication on Grafana. + +

The following table lists the minimum parameters that you must configure to enable JWT + authentication on Grafana:

+ + + + + + + + + Section + Parameters + Description + Values to be configured for z/OSMF + + + + + [auth.jwt] + enabled + Use this parameter to allow JWT to authenticate on the Grafana + server.The default value is set to true. + true + + + enable_login_token + Upon successful authentication proxy header validation, this + parameter provides the user with a login + token.The default value is set to false. + true + + + header_name + Use this parameter to specify the header's name that holds a + token.The default value is set to X-JWT-Assertion. + X-Forwarded-Access-Token + + + username_claim + Use this parameter to identify the user. + The sub claim is mandatory and needs to be present in a JWT, and it should mention the subject of the JWT.The default value is also set to sub. + sub + + + jwk_set_file + Use this parameter to verify the token with a JSON Web Key Set loaded + from a JSON file. + /PATH/TO/jwks.json + + + cache_ttl + Use this parameter to establish the duration for caching data + retrieved from the HTTP endpoint. + This parameter enables the user to store the data for a specified period, allowing for faster access and retrieval of information.The default value is set to 60m (minutes). + 60m + + + expect_claims + Use this parameter to verify the validity of other claims that + contain JSON-encoded information. + When it comes to validation, only the exp, nbf, and iat claims are automatically checked by default.You must validate if you are using other claims such as iss, sub, aud, and jti. + {"iss": "zOSMF"} + + + auto_sign_up + Use this parameter to automatically create user profiles in Grafana + using the TSO ID of z/OSMF for users who do not have + user profiles in the Grafana + server.The default value is set to false. + true + + + url_login + Use this parameter to enable JWT authentication in the URL. + The default value is set to false. + true + + + [server] + protocol + Use this parameter to configure z/OSMF to work over + HTTPS.When you configure z/OSMF to work over HTTPS, it is recommended to configure Grafana to also work over HTTPS. This ensures the secure data transfer between the user's web browser and the Grafana server.The default value is set to http. + https + + + cert_file + Use this parameter to specify the path to the certificate file when + the protocol parameter is set to https or + h2. + /PATH/TO/certificate.crt + + + cert_key + Use this parameter to specify the path to the certificate key file + when the protocol parameter is set to https + or h2. + /PATH/TO/privateKey.key + + + [Security] + cookie_secure + Use this parameter if you hosted the Grafana instance over + HTTPS.The default value is set to false. + true + + + cookie_samesite + Use this parameter to prevent the browser from sharing cookies with + other + websites.The default value is set to lax. + disabled + + + allow_embedding + Use this parameter to enable web browsers to display Grafana within + z/OSMF HTML <frame>, + <iframe>, <embed>, or <object> element. + The default value is set to false. + true + + + +
+

For more information about customizing the Grafana instance by modifying the parameters + in the configuration file, refer to the following sections in the Grafana + documentation.

+
    +
  • Configure JWT authentication
  • +
  • Configure Grafana
  • +
+ +
+ <ph class="- topic/ph topic/title-wrapper ">Defining the Grafana server</ph> + You must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource + Monitoring page of z/OSMF. + + You must have completed the following tasks:
    +
  • Completed the tasks provided in the Prerequisites section. See Prerequisites for accessing Grafana dashboards on z/OSMFBefore you can start working with Grafana dashboards through z/OSMF, there are some prerequisites that you need to complete..
  • +
  • Installed the IBM RMF for z/OS Grafana plugin. See Installing the RMF for z/OS plugin on GrafanaYou must install the IBM RMF for z/OS Grafana plugin to analyze and visualize RMF Monitor III metrics and reports..
  • +
+ + + Enter the URL of z/OSMF in a web browser. + + + Log in to z/OSMF if + you are not already logged in. + + + Double-click System Status. + + + Click Add Entry from the Actions + drop-down list. + + + Perform the following steps to add details about the Grafana server: + + + Enter a name for the Grafana server in the Resource + name field. + The Resource name is the required field, and + you must provide a unique name. The Resource name + can contain up to 24 characters including + alphanumeric characters (A-Z, + a-z, and + 0-9) and special characters + (@ # $). You must note that the Resource name is not + case sensitive. Therefore, the entries with similar names but + different capitalization, such as SYS1 + and Sys1 are considered as identical by + the system. + + + Enter the host name or IP address of the Grafana server that you want + to access in the Host name or IP address + field. + The host name or IP address can contain up to + 4000 characters. + + + Select Grafana from the Target system + type drop-down list. + + + Select the Use HTTPS checkbox to enable secure + communication. + + + Enter the port number where the Grafana server is hosted in the + Port field. + +

The Port is the required field, and the + default port number is set to 3000.

+ Alternatively, you can use + up-down controls to specify the port + number. +
+
+
+
+ + Click OK. + +
+ You have defined the Grafana server as the target + system. + You can perform the following tasks:
    +
  • Modify or Remove the Grafana server by clicking the + Action drop-down menu from the System + Status page.
  • +
  • Access Grafana dashboards. See Accessing the Grafana dashboardYou can access the Grafana dashboard from the Resource Monitoring page of z/OSMF to investigate the RMF Monitor III metrics and reports..
  • +
+
+
+ <ph class="- topic/ph topic/title-wrapper ">Accessing the Grafana dashboard</ph> + You can access the Grafana dashboard from the Resource + Monitoring page of z/OSMF to + investigate the RMF Monitor III metrics and reports. + + You must have defined the Grafana server in z/OSMF. See Defining the Grafana serverYou must define the Grafana server as a target system in z/OSMF to access Grafana from the Resource Monitoring page of z/OSMF.. + + + Enter the URL of z/OSMF in a web browser. + + + Log in to z/OSMF if + you are not already logged in. + + + Double-click Resource Monitoring. + + + Select the Grafana server that you want to access from the drop-down + list. + + + Click OK. + + + You have accessed Grafana from z/OSMF. + You can perform the following tasks:
    +
  • View the dashboards by navigating to AppsIBM RMFDashboards.
  • +
  • Add a RMF data source to fetch data from Distributed Data Servers (DDS). See Creating RMF data + sourcesTo access RMF Monitor III metrics in Grafana, you need to connect to the Distributed Data Server (DDS) by adding an RMF data source..
  • +
+
+
\ No newline at end of file diff --git a/grafana/rmf-app/doc/src/pdf/rmf_grafana.pdf b/grafana/rmf-app/doc/src/pdf/rmf_grafana.pdf index 4e4cd1f0..171c79a4 100644 Binary files a/grafana/rmf-app/doc/src/pdf/rmf_grafana.pdf and b/grafana/rmf-app/doc/src/pdf/rmf_grafana.pdf differ diff --git a/grafana/rmf-app/doc/src/pdf/rmf_grafana.style.xml b/grafana/rmf-app/doc/src/pdf/rmf_grafana.style.xml new file mode 100644 index 00000000..00661d35 --- /dev/null +++ b/grafana/rmf-app/doc/src/pdf/rmf_grafana.style.xml @@ -0,0 +1,2386 @@ + | | Page Page | | | | + + + + + + + + + + + + + + + IBM RMF for z/OS Grafana Plugin User Guide + + +
+
+
+
+
+
IBM + RMF for z/OS Grafana Plugin User Guide
+
+
+
ContentsContents
+
IBM RMF for z/OS Grafana Plugin User + Guide
+
+
.
+
+
.
Grafana is a platform for monitoring and visualizing + data. It enables users to create, explore, and share + dashboards that are interactive and customizable. The +
IBM
RMF for z/OS Grafana + plugin provides effortless analysis and visualization of +
Resource Measurement Facility for z/OS
(
RMF for + z/OS
) Monitor III metrics and reports within + the Grafana platform. Thereby, you can monitor and + analyze the health and performance of + applications.
+
+
+
.
This article covers the new features, system + requirements, and known issues of the
IBM
+ RMF for z/OS Grafana plugin.
+
+
+
.
You + must install the
IBM
RMF for z/OS Grafana + plugin to analyze and visualize RMF Monitor III metrics + and reports.
+
+
+
.
You + must ensure that the
IBM RMF for z/OS Grafana
+ plugin is up to date to leverage its enhanced + functionalities. You can do so by either installing or + upgrading to the latest version of the + plugin.
+
+
+
.
To + access RMF Monitor III metrics in Grafana, you need to + connect to the
Distributed Data Server
+ (
DDS
) by adding an RMF data + source.
+
+
+
.
IBM
RMF for z/OS Grafana is + a plugin provides custom panels for the RMF data source + and master dashboard that consists of RMF Charts, RMF + Reporting, and RMF Time Series dashboards.
+
+
+
.
By + adding panels to dashboards, you can effectively present + your RMF data in a visual format. Each panel must + require at least one query to display a significant + visualization.
+
+
+
.
In + Grafana, queries are essential for fetching and + transforming data from RMF data sources.
+
+
+
.
Variables are a powerful tool to create more + interactive and dynamic dashboards. They offer a way to + replace hard-coded values in metric queries and panel + titles with placeholders for values.
+
+
+
.
Grafana Alerting feature provides a reliable solution + to detect and respond to system issues in real + time.
+
+
+
.
In + Grafana, you can view historical data using absolute and + relative time ranges.
+
+
+
.
Whenever you encounter issues while using the
IBM RMF for + z/OS Grafana
plugin, you can view detailed + error messages that contain sufficient information to + help you identify and troubleshoot the + problem.
+
+
+
.
This section guides how to analyze and address typical + issues that may arise when using the
IBM
+ RMF for z/OS Grafana plugin.
+
+
+
.
When you use
IBM
z/OS Management + Facility to monitor the performance of the z/OS + sysplexes in your environment, you can also access + Grafana dashboards from
z/OSMF
.
+
+
.
Before you can start working with Grafana + dashboards through
z/OSMF
, there are some + prerequisites that you need to complete.
+
+
+
+ +
You can find the information + about parameters you can use during the + configuration of JWT authentication on + Grafana.
+
+
+
+
+
.
You must define the Grafana server as a target + system in
z/OSMF
to access Grafana + from the
Resource + Monitoring
page of
z/OSMF
.
+
+
+
.
You can access the Grafana dashboard from the
Resource + Monitoring
page of
z/OSMF
to investigate the RMF Monitor III + metrics and reports.
+
+
+
+
+
+

- | - . IBM RMF for z/OS Grafana Plugin

+
+

| - . OverviewVisualization of RMF Monitor III + metrics in Grafana

+
+ +
+
+

Grafana is a + platform for monitoring and visualizing data. It enables + users to create, explore, and share dashboards that are + interactive and customizable. The IBM® RMF for z/OS + Grafana plugin provides effortless analysis and + visualization of Resource Measurement Facility for + z/OS (RMF for z/OS) Monitor III + metrics and reports within the Grafana platform. Thereby, + you can monitor and analyze the health and performance of + applications.

+
The IBM RMF for z/OS Grafana + plugin provides the following features:
    +
  • You + can choose various visualization options, such as + graphs, charts, panels, and reports, to help you + understand your data's trends, patterns, and + variances.
  • +
  • You + can create dynamic and engaging dashboards by + piecing together various panels, each displaying a + unique visualization.
  • +
  • You + have the freedom to customize each panel based on + your requirements, including its appearance, size, + and the data queries it displays.
  • +
  • Grafana supports integration with numerous data + sources, which helps you fetch data from various + Distributed Data Servers (DDS) and display it in a unified + dashboard.
  • +
  • You + can set up alerts based on specific conditions or + thresholds in your RMF data. Grafana can trigger + notifications via email or other communication + channels when these conditions are met.
  • +
  • You + can define a dashboard variable to change the RMF + data displayed in your dashboard simply by selecting + a value from the drop-down list at the top.
  • +
+
+
+
+

| - . Release notes

+
+

This article + covers the new features, system requirements, and known + issues of the IBM® RMF for z/OS Grafana plugin.

+
+

What's + new

+
+
May 2025 v1.0.9
+
+
    +
  • +

    IBM RMF + for z/OS Grafana plugin has been enhanced + to optimize the step size when querying and + displaying time series data, based on the selected + time range and panel size. This enhancement + ensures that panels display the required number of + data points.

    +
  • +
  • +

    A bug + has been fixed that was causing specific data + points to be dropped from time series views, + resulting in a flat line in the graphs.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
+
+
+
+
+
+
April 2025 v1.0.8
+
+
    +
  • +

    A new + option, Compression, has been added to the data + source creation process. This option enables the + RMF data source to request HTTP compression from + the Data Distributed Server (DDS) during data + retrieval, which improves the efficiency of data + transfer. See Creating RMF data + sources (on page ).

    +
  • +
  • +

    Fixed + certain scenarios of missing data within + dashboards for time series visualizations.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
+
+
November 2024 v1.0.7
+
+

Fixed internally found + defects.

+
+
October 2024 v1.0.6
+
+
    +
  • +

    The + IBM RMF for z/OS Grafana plugin now allows + customizing banner and caption fields in IBM RMF + Report visualizations.

    +
  • +
  • +

    After + you modify any IBM + RMF data source and save the changes, you + no longer need to re-enter the password.

    +
  • +
  • +

    Improved + performance.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
+
+
+
+
+
+
August 2024 v1.0.5
+
+
    +
  • +

    When + creating the datasource, you now have the option + to specify the desired cache size in megabytes for + the datasource.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
  • +

    The + topic of Creating RMF data + sources (on page ) + has been updated per the new UI changes.

    +
  • +
+
+
June 2024 v1.0.4
+
+
    +
  • +

    The user + interface for creating the datasource has been + enhanced to improve the user experience.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
  • +
    The following dashboards are + updated:
      +
    • Common Storage Activity (Timeline)
    • +
    • Common Storage Activity
    • +
    • Coupling Facility Overview (Timeline)
    • +
    • Coupling Facility Overview
    • +
    • Execution Velocity (Timeline)
    • +
    • Execution Velocity
    • +
    • General Activity (Timeline)
    • +
    • General Activity
    • +
    • Overall Image Activity (Timeline)
    • +
    • Overall Image Activity
    • +
    • Performance Index (Timeline)
    • +
    • Response Time (Timeline)
    • +
    • Response Time
    • +
    • XCF Activity (Timeline)
    • +
    • XCF Activity
    • +
    Note: You must + re-import the dashboards to utilize the latest + enhancements in the dashboards.
    +
  • +
  • +
    The documentation updates for + v1.0.4 include the following changes:
    +
  • +
+
+
February 2024 v1.0.3
+
+
    +
  • +

    Fixed + specific issues related to the support of Grafana + v10.x.x.

    +
  • +
  • +

    Fixed + empty settings issue for IBM RMF data source + defined via Home / Apps / IBM RMF page.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
  • +
    The documentation updates for + v1.0.3 include the following changes:
    +
  • +
+
+
December 2023 v1.0.2
+
+
    +
  • +

    Support + spaces in Datasource name.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
+
+
November 2023 v1.0.1
+
+
    +
  • +

    Resolved + security issues in dependencies.

    +
  • +
  • +

    Fixed + internally found defects.

    +
  • +
+
+
November 2023 v1.0.0
+
+

The + first release of the IBM RMF for z/OS + Grafana plugin is in the following GitHub + repository: https://github.com/IBM/RMF.

+
+
+
+
+

Requirements

+
You must have the following + software to use the IBM RMF for z/OS Grafana + plugin:
    +
  • Resource Measurement Facility for z/OS + 3.1
  • +
  • Distributed Data Server
  • +
  • IBM RMF for z/OS Grafana plugin 1.0.x
  • +
  • Grafana 9.5.1 or later
  • +
+
+
+
+
+

| - . Installing the pluginInstalling the RMF for z/OS plugin on + Grafana

+
+ +
+
+

You must install + the IBM® RMF for z/OS Grafana plugin to + analyze and visualize RMF Monitor III metrics and + reports.

+
+
+

Before you begin

+
+
You must have completed the + following tasks:
    +
  • Installed RMF for z/OS + 3.1 + DDS and the functionality level must be + 3650 or higher.
  • +
  • Installed Grafana 9.5.1 or later.
  • +
You must be familiar working with Grafana.
+
+
+
+

Procedure

+
+
    +
  1. + Set the value of allow_loading_unsigned_plugins to ibm-rmf,ibm-rmf-datasource,ibm-rmf-report + in the [plugins] section of your custom + configuration file. +
    +
    The default configurations + for a Grafana installation are in the defaults.ini file. You can copy the default.ini file and rename it to custom.ini for customizing your Grafana + configuration. +

    The default location of the configuration file is as follows:

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    Operating systemsDefault path to the + configuration file
    Windows®WORKING_DIR/conf/defaults.ini
    Linux®/etc/grafana/grafana.ini
    macOS®/usr/local/etc/grafana/grafana.ini
    +
    +
    Note: You can + use the GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS + environment variable to override allow_loading_unsigned_plugins.
    +
    +
  2. +
  3. + Choose any one of the methods + described in the following table to install the + RMF for z/OS plugin based on your + requirements: +
    +
    + + + + + + + + + + + + + + + + + + + + + +
    MethodsStep #
    Installing the RMF for z/OS plugin in + the Grafana stand-alone application.Perform steps 3 (on page ) + and 4 (on page ).
    Installing the RMF for z/OS plugin + along with Grafana within the Docker + environment.Perform steps 5 (on page ) + and 6 (on page ).
    +
    +
    +
  4. +
  5. + Run the following command to + install the plugin by using Grafana CLI: +
    +
    grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf
    +
    Remember: You + must replace the value of <version> for the pluginURL option to version number of the + plugin to be installed.
    +
    +
  6. +
  7. + Restart the Grafana server, + and then go to step 7 (on page ). +
  8. +
  9. + Run the following command to + create a volume for storing the Grafana + state: +
    +
    docker volume create rmf-grafana-data
    +
    +
  10. +
  11. + Run the following command to + create and run a container: +
    +
    docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image>
    +
    Remember: You + must replace the values of the following options + in the command:
      +
    • <version> for the env option to the version number of the + plugin to be installed.
    • +
    • <image> to the version of the Grafana + image to be used.
    • +
    +
    Note: + zCX/zLinux images are available at Container Images for IBM Z and + LinuxONE. + Similarly, images of other required platforms are + available at Docker + Hub.
    +
    +
  12. +
  13. + To enable the RMF for + z/OS plugin on the Grafana UI, you must + perform the following sub-steps: +
      +
    1. + Enter the URL of Grafana in + your web browser. +
    2. +
    3. + Enter the username and + password of Grafana on the sign-in page. +
    4. +
    5. + Go to Administration > + Plugins. +
      +
      Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed.
      +
      +
    6. +
    7. + Enter RMF in the Search bar on the Plugins page. +
    8. +
    9. + Click IBM + RMF in the search results. +
    10. +
    11. + Click Enable. +
      +
      Note: After + you install the IBM RMF for z/OS + Grafana plugin, when you open IBM RMF on + the Plugins page of Grafana UI, an Invalid plugin + signature warning message is + displayed.
      +
      +
    12. +
    +
  14. +
  15. Optional: + Verify the signature of the + IBM RMF Grafana plugin, which is signed with the + GPG key, by performing the following + sub-steps: +
      +
    1. + Download the PUBLIC_KEY.asc (GPG public key) + file. + +
    2. +
    3. + Follow the instructions in + the Importing a public + key + section of the GPG user guide. +
    4. +
    5. + Download the IBM RMF + for z/OS Grafana plugin (ibm-rmf-grafana-x.y.z.zip) and signature + file (ibm-rmf-grafana-x.y.z.zip.asc) from https://github.com/IBM/RMF/releases. +
    6. +
    7. + Run the following command to + verify the signature: +
      +
      gpg --verify ibm-rmf-grafana-x.y.z.zip.asc ibm-rmf-grafana-x.y.z.zip
      +

      Where + x.y.z is the version number of the + IBM RMF for z/OS Grafana plugin.

      +

      For more + information, refer to the GPG + user guide.

      +
      +
    8. +
    +
  16. +
+
+
+

Results

+
You have installed the IBM RMF for + z/OS Grafana plugin. You can find the IBM + RMF plugin listed under the Apps + section.

+
+

What to do next

+
You can add an RMF data source to fetch data from + Distributed Data Servers + (DDS). See Creating RMF data + sources (on page ).
+
+ +
+
+

| - . Upgrading the pluginUpgrading the RMF for z/OS plugin on + Grafana

+
+ +
+
+

You must ensure + that the IBM RMF for z/OS Grafana plugin is up to date to + leverage its enhanced functionalities. You can do so by + either installing or upgrading to the latest version of the + plugin.

+
+

About this task

+
The upgrade procedures differ based on the environment + you used to install the Grafana server.
+ + + + + + + + + + + + + + + + + + + + + +
MethodsStep #
Upgrading the plugin in the Grafana stand-alone + application.Perform steps 1 (on page ) + to 3 (on page ).
Upgrading the plugin in the Grafana within the + Docker environment.Perfrom steps 4 (on page ) + to 7 (on page ).
+
+
+
+

Procedure

+
+
    +
  1. + Stop the Grafana + server. +
  2. +
  3. + Run the following command to + upgrade the plugin by using Grafana CLI: +
    +
    grafana cli --pluginUrl https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip plugins install ibm-rmf
    +
    Note: You must + replace the value of <version> for the pluginURL option with the plugin's version + number to be upgraded. +

    For example, if you want to install the v1.0.3 version of the plugin, the value of pluginURL is https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v1.0.3/ibm-rmf-grafana-1.0.3.zip.

    +
    +
    The CLI tool downloads the + mentioned version of the plugin and replaces the + existing files.
    +
  4. +
  5. + Restart the Grafana server, + and then go to step 7 (on page ). +
  6. +
  7. + Run the following command to + stop the docker container: +
    +
    docker stop rmf-grafana
    +

    Where + rmf-grafana is the name of the + container.

    +
    +
  8. +
  9. + Run the following command to + remove the docker container: +
    +
    docker rm rmf-grafana
    +
    +
  10. +
  11. + Run the following command to + upgrade the plugin by creating and running a + container: +
    +
    docker run --name rmf-grafana --hostname rmf-grafana --detach --restart unless-stopped --volume rmf-grafana-data:/var/lib/grafana --publish 3000:3000 --env "GF_INSTALL_PLUGINS=https://github.com/IBM/RMF/releases/download/ibm-rmf-grafana/v<version>/ibm-rmf-grafana-<version>.zip;ibm-rmf" --env "GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=ibm-rmf,ibm-rmf-datasource,ibm-rmf-report" <image>
    +
    Remember: You + must replace the values of the following options + in the command:
      +
    • <version> for the env option to the version number of the + plugin to be upgraded.
    • +
    • <image> to the version of the Grafana + image used.
    • +
    +
    +
  12. +
  13. + Perform the following + sub-steps to re-import the dashboards. +
    After upgrading the plugin to + a new version, it is essential to re-import the + dashboard. This ensures that you are utilizing the + most up-to-date features in the dashboards.
    Tip: You can + find the updated dashboards for each release by + referring to the CHANGELOG + of the plugin. You do not need to re-import all + the dashboards.
    +
      +
    1. + Enter the URL of Grafana in + your web browser. +
    2. +
    3. + Enter the username and + password of Grafana on the sign-in page. +
    4. +
    5. + Go to Administration > + Plugins. +
      +
      Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed.
      +
      +
    6. +
    7. + Enter RMF in the Search bar on the Plugins page. +
    8. +
    9. + Click IBM + RMF in the search results. +
    10. +
    11. + Click Dashboards, and then click Re-import to re-import the + dashboards. +
    12. +
    +
  14. +
+
+
+

Results

+
You have updated the IBM RMF for + z/OS Grafana plugin.
+
+
+
+

| - . Creating RMF data sources

+
+

To access RMF + Monitor III metrics in Grafana, you need to connect to the + Distributed Data Server (DDS) + by adding an RMF data source.

+
+
+

Before you begin

+
+ +
+
+
+

Procedure

+
+
    +
  1. + Go to Apps > + IBM + RMF > + Add + RMF Data Source. +
    Alternatively, you can click + Administration > + Data + sources > + + Add + new data source, then search for the + IBM RMF to choose a data source type.
    Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed.
    +
  2. +
  3. + Enter a name for the data + source in the Name field. +
  4. +
  5. Optional: + Set Default + + to ON to make the + added data source the default one. +
    +
    Note: When you + create new panels, the default data source is + preselected.
    +
    +
  6. +
  7. + Enter the details for the + following fields in the HTTP section: +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldsAction
    DDS + URLEnter the URL of the DDS in this field.

    The + format of the URL is http://hostname:port_number[/path] or https://hostname:port_number[/path]

    Important: In + the DDS URL, the /path is optional, and you must + exclude it in the default network configuration. + However, it might be required in more advanced + setups, such as when DDS functions behind a + reverse proxy.
    TimeoutSpecify the duration, in seconds in this field, + for which Grafana is allowed to wait for a + connection to the DDS before it closes + the connection.

    The default value is 60.

    CompressionThis option is enabled by default, which means + that when RMF requests data from DDS, HTTP compression is utilized, + provided that the DDS is operating on a + maintenance level OA67541. The compression setting + is ignored if DDS is not at this + maintenance level.

    You can turn off HTTP + compression by setting the Compression option to OFF, resulting in + DDS data being always transferred in an + uncompressed format.

    +
    +
    +
  8. +
  9. Optional: + Set the Skip + TLS Verify option to ON if you are + accepting any certificate presented by the DDS and + any hostname listed in that certificate. However, + this practice is not considered secure and is + typically used in development or testing + environments. +
    +
    Note: By + default, the Skip + TLS Verify option is set to OFF.
    +
    +
  10. +
  11. + Set the Basic + Auth option to ON to create the + data source with basic authentication. +
  12. +
  13. + Enter the credentials of the + DDS in the User and Password fields. +
    +
    Note: The + User and Password fields are visible only when you + enable the basic authentication.
    +
    +
  14. +
  15. + Specify the size of the cache + (in MB) for the data source in the Size field. +
    +
    Remember: The + value must be greater than or equal to 128. The default + value is 1024.
    +
    +
  16. +
  17. + Click Save + & test. +
    The Data source is + working message is displayed if the + connection to DDS succeeds.
    +
  18. +
+
+
+

Results

+
You have added the RMF data source.
+
+
+

What to do next

+
+

You can refer + to the RMF master + dashboard (on page ) + topic for information about RMF master dashboard and its + features.

+
+
+
+
+

| - . RMF master dashboard

+
+

IBM® RMF for z/OS + Grafana is a plugin provides custom panels for the RMF data + source and master dashboard that consists of RMF Charts, RMF + Reporting, and RMF Time Series dashboards.

+

Grafana provides a + highly flexible and customizable dashboard consisting of one + or more rows and panels. You can use various pre-configured + panels to construct queries and tailor the visualization to + meet your requirements. This enables you to create a + personalized dashboard that seamlessly interacts with data + from a configured Distributed Data Server + (DDS). For more information about creating and + managing dashboards, refer to the Grafana + documentation.

+
When you install the RMF for z/OS + Grafana plugin for the first time, all the dashboards are + imported automatically. You can view the dashboards by + navigating to Apps > + IBM + RMF > + Dashboards. The following table lists + the dashboards available in RMF Charts, RMF Reporting, and + RMF Time Series dashboards:
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1. RMF master + dashboard (continued)
RMF Charts DashboardRMF + Reporting DashboardsRMF Time Series Dashboards
Common Storage + ActivityCACHDETDSNDPROCSYSINFOCommon Storage Activity + (Timeline)
Coupling Facility + OverviewCACHSUMEADMPROCUSYSRGCoupling Facility + Overview (Timeline)
Execution VelocityCFACTENCLAVESPACEDSYSSUMExecution Velocity + (Timeline)
General ActivityCFOVERENQSPACEGUSAGEGeneral Activity + (Timeline)
Overall Image + ActivityCFSYSHSMSTORXCFGROUPOverall Image Activity + (Timeline)
Performance IndexCHANNELIOQSTORCXCFOVWPerformance Index + (Timeline)
Response TimeCPCJESSTORCRXCFPATHResponse Time
Using & DelaysCRYOVWLOCKSPSTORFXCFSYSUsing & Delays + (Timeline)
XCF ActivityDELAYLOCKSUSTORMZFSFSXCF Activity + (Timeline)
Common Storage + ActivityDEVOPDSTORRZFSKNCommon Storage Activity + (Timeline)
+ DEVRPCIESTORSZFSOVW +
+
+

The dashboard + interface offers several customization options for data + presentation. The following is the image of the master + dashboard from the IBM RMF for z/OS Grafana + plugin:

+

default_dashboard_view

+

You can click the + import_dashboard + option when there is a new version of the plugin, and then + re-import the dashboard by clicking the reimport + icon. Similarly, if any of the dashboards is no longer + required, you can click the + icon to remove it from the master dashboard.

+

For more + information about available features in the Dashboard and + their descriptions, refer to the Grafana + documentation.

+
+
+
+

| - . Applying visualization to RMF + data

+
+

By adding panels + to dashboards, you can effectively present your RMF data in + a visual format. Each panel must require at least one query + to display a significant visualization.

+
+

Before you begin

+
You must have completed the + following tasks:
+
+
+

Procedure

+
+
    +
  1. + Identify the dashboard for + which you want to add visualization. +
  2. +
  3. + Perform one of the steps + described in the following table: +
    +
    + + + + + + + + + + + + + + + + + + + + + +
    Step descriptionStep #
    If there are no panels added to the + dashboardPerform step 3 (on page ).
    If at least one panel is added to the + dashboardPerform step 5 (on page ).
    +
    +
    +
  4. +
  5. + Click + Add + visualization to add visualization to your + data. +
    +
    Note: The + navigation of the user interface can differ based + on the Grafana version that is currently + installed.
    +
    +
    The Edit + panel is displayed.
    +
  6. +
  7. + Go to step 6 (on page ). +
  8. +
  9. + Click Add > + Visualization from the dashboard + header. +
    +

    +
    +
    The Edit + panel is displayed.
    +
  10. +
  11. + Enter a name for the panel in + the Title field. +
    Optionally you can also + provide a description for the panel that you are + creating.

    When you add the description + for the panel, a notification icon + is displayed after the Panel title, as shown in the following + image:

    +
  12. +
  13. + Select one of the + visualization types from the drop-down + menu: +
    +

    +

    You can + choose Report + for IBM RMF for z/OS or built-in Bar + chart Grafana visualization types from the + drop-down list.

    +
    +
  14. +
  15. + Click the Query tab, and then enter a query in the + query language of the RMF data source. +
    +
    Note: You can + click + + Query to add multiple queries.
    +
    +
  16. +
  17. + Click the Transformation tab, and then select a + transformation from the list. +
    Upon accessing the + transformation options, a dedicated row is + presented for configuration.
    Note: You can + click + Add + Transformation to add multiple + transformations to data.
    +
  18. +
  19. + Select the existing data + sources from the Data + source drop-down list. +
  20. +
  21. + Click the Time + Picker drop-down list to select relative + time range options and set custom absolute time + ranges. +
    +

    +
    +
  22. +
  23. + Click the Refresh dashboard + + icon to query the RMF data source. +
    Grafana provides you with a + preview of your query results along with the + corresponding visualization.
    +
  24. +
  25. Optional: + Click Apply to view your changes applied to the + dashboard. +
  26. +
  27. + Click Save, and then enter a note describing the + changes you have made. +
  28. +
  29. + Click Save to store the changes made to the + dashboard. +
  30. +
+
+
+

Results

+
You have applied visualization to the RMF + data.
+
+
+

What to do next

+
+

Grafana + provides a range of visualizations that cater to + different use cases. For more information about the + built-in panels, options, and typical usage, refer to + the Grafana + documentation.

+

You can also + configure the panel options based on your requirements. + For more information refer to the Grafana + documentation.

+

You can add + multiple transformation to your data. When there are + multiple transformations, Grafana applies them + sequentially. Each transformation produces a result set + that is passed on to the next transformation in the + pipeline. Grafana provides several ways that you can + transform data. For entire list of transformations, + refer to the Grafana + documentation.

+
+
+
+
+

| - . IBM RMF query languages

+
+

In Grafana, + queries are essential for fetching and transforming data + from RMF data sources.

+

Executing a query + is a process that involves defining the data source, + specifying the desired data to retrieve, and applying + relevant filters or transformations. IBM RMF for + z/OS Grafana plugin provides a user-friendly RMF + query editor that maximizes its unique capabilities. Grafana + panels retrieve data for visualization from RMF data sources + via queries.

+

You can use the + following types of queries to retrieve data from the + specified RMF data source:

+
    +
  • Metric + query – Use this query to retrieve RMF Monitor III + metrics.
  • +
  • Report + query – Use this query to retrieve RMF Monitor III + reports.
  • +
+
+

Metric + query syntax

+

The syntax of + the Metric query is as follows:

+

resource_type.metric_description {qualifications}

+
Where:
    +
  • resource_type is the type of + resource for which information is requested. You + must enter the appropriate value in the resource_type field.

    The + available resource types are documented in the z/OS RMF Monitor III resource + model + topic in the z/OS + Resource Measurement Facility Programmer's + Guide.

  • +
  • metric_description is the name of + the metric for the selected resource type.

    After + entering the resource type, you can choose the + metric description from the drop-down + list.

  • +
  • qualifications is an optional + parameter and can contain any or all the following + attributes separated by a comma:
      +
    • ulq: The name of the resource type + at the upper level.
    • +
    • name: The name of the resource.
    • +
    • filter: The filter helps to focus on + the data of your interest when requesting a list + of values.
      You can + use one of the following values for the filter attribute:
      +
      PAT=< pattern>
      +
      Specifies one or more patterns that must match + the name part of a list element.
      +
      LB=<number>
      +
      Specifies a lower bound value. Only list elements + with values higher than the given lower bound are + returned.
      +
      UB=<number>
      +
      Specifies an upper bound value. Only list + elements with values lower than the established + upper bound are returned.
      +
      HI=<integer>
      +
      Only + the highest <integer> list elements are + returned (mutually exclusive with LO).
      +
      LO=<integer>
      +
      Only + the lowest <integer> list elements are + returned (mutually exclusive with HI).
      +
      ORD=< NA | ND | VA | VD | NN>
      +
      +
        +
      • NA - Sort the list of names by their names in + ascending order.
      • +
      • ND – Sort the list of names by their names in + descending order.
      • +
      • VA – Sort the list of values by their values in + ascending order.
      • +
      • VD – Sort the list of values by their values in + descending order.
      • +
      • NN - If you do not want to have any order, you + can specify ORD=NN.
      • +
      +
      +
    • +
    • workscope: To qualify a request for + performance data in more detail about address + spaces and WLM entities. You can use one of the + following values for the workscope attribute:
        +
      • G - Global (no workscope required)
      • +
      • W - WLM workload
      • +
      • S - WLM service class
      • +
      • P - WLM service class period
      • +
      • R - WLM report class
      • +
      • J - Job
      • +
    • +
  • +
+

Examples:

+
SYSPLEX.% total physical utilization (AAP) by partition
+
COUPLING_FACILITY.% processor utilization
+
CPC.% total physical utilization (shared IIP)
+
MVS_IMAGE.% delay by WLM report class period {name=RS21}
+
MVS_IMAGE.% workflow by WLM report class period {ulq=RS21,name=RS2*,filter=ORD=NA,workscope=,,G}
+
+
+

Report + query syntax

+

The syntax of + the Report query is as follows:

+

resource_type.REPORT.report_name

+
Where:
    +
  • resource_type is the type of + resource for which information is requested. You + must enter the appropriate value in the resource_type field.
  • +
  • report_name is the name of the + report.

    You can + find the report names in the Interactive performance analysis with Monitor + III, + which is documented in the z/OS Resource Measurement + Facility Report Analysis.

    Note: You can + view reports on the Grafana dashboard only for the + resource types SYSPLEX and MVS_IMAGE.
  • +
+

Examples:

+
SYSPLEX.REPORT.CACHSUM
+
SYSPLEX.REPORT.CPC
+
+
+
+
+

| - . RMF Variable Query syntax

+
+

Variables are a + powerful tool to create more interactive and dynamic + dashboards. They offer a way to replace hard-coded values in + metric queries and panel titles with placeholders for + values.

+
Variables make it easy to change the + data displayed in your dashboard simply by selecting a value + from the drop-down list at the top. Using variables in your + dashboard simplifies maintenance, particularly if you have + multiple identical data sources. Instead of creating + separate dashboards for each data source, you can create one + dashboard and use variables to change what you are + viewing.
Important: It's + important to note that variables don't have a default + value. Each variable drop-down list in Dashboard + settings displays the variable list in the order it + appears.
+

You can define a + dashboard variable in Dashboard Settings > + Variables using Grafana's RMF + Variable Query syntax with and without a filter.

+

Syntax + of the query without a filter

The general syntax of the query + without a filter is as follows:

SELECT <COLUMN_NAME> FROM RESOURCE WHERE condition1 or condition2 or condition3

Note: The <COLUMN_NAME> is limited to label + and RESOURCE is limited to resource + only and cannot be used for other purposes.
Where:
    +
  • condition1: ULQ=Value + and + TYPE=Value
  • +
  • condition2: Name=Value + and + TYPE=Value
  • +
  • condition3: Name=Value + and + ULQ=Value + and + TYPE=Value
  • +
Examples for condition1:
    +
  • select label from resource + where ulq="hostname of the DDS" and type="CHANNEL_PATH"
  • +
  • select label from resource + where ulq="hostname of the DDS" and type="ALL_CHANNELS"
  • +

Examples for condition2:

select label from resource where + name="resource_name" and type="SYSPLEX"
Examples for condition3:
    +
  • select label from resource + where ulq="hostname of the DDS" and name="*" and type="CHANNEL_PATH"
  • +
  • select label from resource + where ulq="hostname of the DDS" and name="*" and type="ALL_CHANNELS"
  • +
+
+

Syntax + of the query with a filter

+

The general + syntax of the RMF query with a filter is as follows:

+

SELECT <COLUMN_NAME> FROM RESOURCE WHERE condition

+

Where condition is Name=Value and ULQ=Value and TYPE=Value and Filter= + Value

+

Examples for condition:

+

select label from resource where name="resource_name" and type="SYSPLEX" and filter="MVS_IMAGE"

+
+
+

To learn how + to effectively add and manage variables of your choice + in Grafana, you can refer to the Grafana + documentation.

+
+
+
+
+

| - . AlertsIntroduction to Alerts

+
+ +
+
+

Grafana Alerting + feature provides a reliable solution to detect and respond + to system issues in real time.

+

Through Grafana + monitoring capabilities, you can keep track of incoming + metrics data and configure the alerting system to detect + specific events or circumstances. When the system identifies + any issues, it automatically sends notifications to ensure + that you are up to date. With Grafana Alerting, you can + eliminate the need for manual monitoring and control system + outages that could lead to significant incidents.

+

For more + information about configuration of alerts and contact + points, refer to the Grafana + documentation.

+
+
+
+

| - . Historical dataHistorical data collection

+
+ +
+
+

In Grafana, you + can view historical data using absolute and relative time + ranges.

+
+

Viewing + historical data is a common practice across + organizations for various purposes. The importance and + use of historical data are significant in + decision-making, research, analysis, and planning. + Analyzing historical data provides valuable insights + into the status, usage, performance, and health of + various resources.

+

You can also + access cached metric data for queries, data sources, and + timestamp combinations that have already viewed by other + user on Grafana. This means that if any user requests + metrics data for the same query, datasource, and + timestamp, the cached data can be displayed faster than + a service call from DDS. If data for a particular + timestamp is not found in the cache, it will be fetched + by a service call from DDS. This feature can save you + time and provide a faster experience accessing metric + data.

+
CAUTION: When + you view data over extended time ranges, the system may + require considerable CPU resources on the host.
+
+
+
+
+

| - . Error typesError reporting in the + plugin

+
+ +
+
+

Whenever you + encounter issues while using the IBM RMF for z/OS Grafana + plugin, you can view detailed error messages that contain + sufficient information to help you identify and troubleshoot + the problem.

+

By viewing these + error messages, you can quickly and efficiently troubleshoot + any issues you may encounter while using the IBM RMF for + z/OS Grafana plugin.

+
The errors that can occur vary in + severity and are classified into different types as + described in the following table:
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeError CodeDescription
SevereSA + critical error has arisen that will cause the task + you are currently performing to terminate + immediately.

It is essential to take + necessary measures to prevent such errors to + ensure the smooth functioning of the IBM RMF + for z/OS Grafana plugin.

Eventual Action EAn error of a transient nature has arisen but can + be resolved with an action by the user.
WarningWReceiving a warning message from the IBM RMF + for z/OS Grafana plugin is not indicative + of an error within the application.
InformationIAn information message informs the users about + changes or updates in the IBM RMF + for z/OS Grafana plugin.

You need + not take any action in response, but it's + essential to stay up-to-date and be aware of these + updates.

+
+

When an error + occurs, it is assigned a unique Error ID that can help + quickly identify the root cause of the issue by referring to + the log file. The Error ID is a combination of 10 characters + comprising lower and upper case alphabets.

+

In case of any + problems with the Distributed Data Server + (DDS), you can identify the issues by looking + into DDS-specific errors, which will be displayed + without any modifications. The messages issued by the Distributed + Data Server are documented in the Distributed Data Server messages - + GPM + topic in the z/OS + Resource Measurement Facility Messages and + Codes.

+

The following are + the examples of error messages that you may encounter while + using the IBM RMF for z/OS Grafana plugin:

+

DDS_error

+

Error_plugin

+
Tip: To diagnose the + issue from the docker logs of the IBM RMF for + z/OS Grafana plugin, you can run the following + command: +
docker logs <container_name> 2>&1 | grep "<unique error code shown in the error message>"
+
+
+
+

| - . Troubleshooting issues

+
+

This section + guides how to analyze and address typical issues that may + arise when using the IBM® RMF for z/OS Grafana plugin.

+
+

This article + is regularly updated with the latest information on + discovering and solving issues that may arise. You can + search through the article to find the precise + information you need.

+

You can open a + case by navigating to IBM + support + if you cannot find any solutions for the issue you + encountered. Before opening a case, gather all the + required information and provide the details to IBM + support for further investigation.

+

The following + table describes the details of issues and the + resolutions you can apply to fix the problems:

+
+ + + + + + + + + + + + + + + + + + + + +
+
IssuesCauseResolutions
RMF Time Series + dashboards do not plot the Monitor 3 metrics data, + whereas RMF Reports and RMF Charts dashboards plot + correctly.The proxy settings + configured by your network administrator block web + socket connections from the Grafana server. +

The IBM RMF for z/OS Grafana plugin streams time series data to the clients through web socket connections.

Unblocking web sockets + and configuring the appropriate proxy settings is + necessary to ensure that web sockets with the name + "ws" in the URI work + correctly with the IBM RMF for z/OS + Grafana + plugin.

You can contact your network administrator to modify the proxy configuration settings.

+
+
+
+
+
+

| - . Grafana through z/OSMFGrafana through IBM z/OS + Management Facility

+
+ +
+
+

When you use + IBM® z/OS Management Facility to monitor + the performance of the z/OS sysplexes in your environment, + you can also access Grafana dashboards from z/OSMF.

+
You must complete certain tasks to + access Grafana through z/OSMF. The following table + lists the task flows to access Grafana from z/OSMF:
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
TasksMore + information
Complete the tasks + provided in the Prerequisites topic.Prerequisites for accessing Grafana dashboards on + z/OSMF (on page )
Install the RMF for z/OS + plugin on Grafana.Installing the RMF for z/OS plugin on + Grafana (on page )
Define Grafana servers as + target systems.Defining the Grafana + server (on page )
Access Grafana + dashboardsAccessing the Grafana + dashboard (on page )
+
+
+
+

. PrerequisitesPrerequisites for accessing Grafana + dashboards on z/OSMF

+
+ +
+
+

Before you + can start working with Grafana dashboards through z/OSMF, there are some prerequisites that + you need to complete.

+

The following + sections describe each prerequisite in detail:

+
+

Configure + z/OSMF

+

When + installing z/OS, z/OSMF is + automatically installed as a fundamental component + of the operating system. However, to use its + features, you must configure the z/OSMF nucleus on your system and add core + and optional services. This enables you to take + advantage of the many benefits that z/OSMF offers. For more information, refer + to the z/OS Management Facility + Configuration + Guide.

+
+
+

Install + Grafana

+

You must + install Grafana v9.5.1 or later.

+

For more + information, refer to the Grafana + documentation for detailed instructions on + installing Grafana and its dependencies and starting + the Grafana server on your system.

+
+
+

User + administration

+

You must + review the default user management settings provided + by the Grafana server to determine if you need any + additional permissions to be added for the + users.

+

For more + information, refer to the User + Management + section of the Grafana documentation.

+
+
+

Configure + JSON Web Token (JWT) support on z/OSMF

+

You must + configure the z/OSMF server to build + and use JSON Web Token (JWT) tokens. Because, by + default, the JWT function is turned off on the z/OSMF server. You can turn on the JWT + authentication by modifying the server's + configuration files directly. Once enabled, the JWT + function allows you to use JWT tokens to + authenticate and authorize user access to the + Grafana through the z/OSMF server.

+

When + configuring z/OSMF JWK files, it + is essential to use the jwksUri parameter. This parameter + specifies a URL for the JSON Web Key service, which + is necessary for building the JWK files.

+

The format + of the jwksUri parameter is as follows:

+

https://${hostname}:${port}/jwt/ibm/api/zOSMFBuilder/jwk

+

For + example, if your z/OSMF server is + running on https://abc.com:12345, + then the value of jwksUri is:

+

https://abc.com:12345/jwt/ibm/api/zOSMFBuilder/jwk

+
Where,
    +
  • abc is the hostname where the z/OSMF server runs.
  • +
  • 12345 is the port number.
  • +
+

You must + save the content of jwksUri as the jwks.json file and place it in the + following directory:

+

/PATH/TO/jwks.json

+

For + information about enabling the JWT function, refer + to the z/OS Management Facility + Configuration + Guide.

+
+
+

Configure + JWT authentication on Grafana

+

You must + configure Grafana to accept a JWT token in the HTTP + header. You can also verify the token's validity + using a JSON Web Key Set (JWKS) stored in a local + file.

+

As a + system administrator, when you install Grafana, you + can pass values for some of the individual + parameters in the .ini configuration file to configure JWT + authentication on Grafana. See Grafana configuration + parameters (on page ).

+
The default location of the + configuration file is as follows:
+ + + + + + + + + + + + + + + + + + + + + + + + + +
Operating systemsDefault path to the + configuration file
Windows®WORKING_DIR/conf/defaults.ini
Linux®/etc/grafana/grafana.ini
macOS®/usr/local/etc/grafana/grafana.ini
+
+
+
+
+

. Grafana configuration + parameters

+
+

You can find the information + about parameters you can use during the + configuration of JWT authentication on Grafana.

+

The + following table lists the minimum parameters that + you must configure to enable JWT authentication on + Grafana:

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
SectionParametersDescriptionValues to + be configured for z/OSMF
[auth.jwt]enabledUse this parameter to + allow JWT to authenticate on the Grafana + server.

The default value is set to true.

true
enable_login_tokenUpon successful + authentication proxy header validation, this + parameter provides the user with a login + token.

The default value is set to false.

true
header_nameUse this parameter to + specify the header's name that holds a + token.

The default value is set to X-JWT-Assertion.

X-Forwarded-Access-Token
username_claimUse this parameter to + identify the user. +

The sub claim is mandatory and needs to be present in a JWT, and it should mention the subject of the JWT.

The default value is also set to sub.

sub
jwk_set_fileUse this parameter to + verify the token with a JSON Web Key Set loaded + from a JSON file./PATH/TO/jwks.json
cache_ttlUse this parameter to + establish the duration for caching data retrieved + from the HTTP endpoint. +

This parameter enables the user to store the data for a specified period, allowing for faster access and retrieval of information.

The default value is set to 60m (minutes).

60m
expect_claimsUse this parameter to + verify the validity of other claims that contain + JSON-encoded information. +

When it comes to validation, only the exp, nbf, and iat claims are automatically checked by default.

You must validate if you are using other claims such as iss, sub, aud, and jti.

{"iss": + "zOSMF"}
auto_sign_upUse this parameter to + automatically create user profiles in Grafana + using the TSO ID of z/OSMF for users who do not have user + profiles in the Grafana + server.

The default value is set to false.

true
url_loginUse this parameter to + enable JWT authentication in the URL. +

The default value is set to false.

true
[server]protocolUse this parameter to + configure z/OSMF to work over + HTTPS.

When you configure z/OSMF to work over HTTPS, it is recommended to configure Grafana to also work over HTTPS. This ensures the secure data transfer between the user's web browser and the Grafana server.

The default value is set to http.

https
cert_fileUse this parameter to + specify the path to the certificate file when the + protocol parameter is set to https or h2./PATH/TO/certificate.crt
cert_keyUse this parameter to + specify the path to the certificate key file when + the protocol parameter is set to https or h2./PATH/TO/privateKey.key
[Security]cookie_secureUse this parameter if you + hosted the Grafana instance over + HTTPS.

The default value is set to false.

true
cookie_samesiteUse this parameter to + prevent the browser from sharing cookies with + other + websites.

The default value is set to lax.

disabled
allow_embeddingUse this parameter to + enable web browsers to display Grafana within + z/OSMF HTML <frame>, <iframe>, + <embed>, or <object> element. +

The default value is set to false.

true
+
+

For more + information about customizing the Grafana instance + by modifying the parameters in the configuration + file, refer to the following sections in the Grafana + documentation.

+ +
+
+
+
+

. Defining the Grafana + server

+
+

You must + define the Grafana server as a target system in z/OSMF to access Grafana from the Resource + Monitoring page of z/OSMF.

+
+

Before + you begin

+
You must have completed the + following tasks:
+
+
+

Procedure

+
+
    +
  1. + Enter the URL of z/OSMF in a web browser. +
  2. +
  3. + Log in to z/OSMF if you are not already logged + in. +
  4. +
  5. + Double-click System + Status. +
  6. +
  7. + Click Add + Entry from the Actions drop-down list. +
  8. +
  9. + Perform the following steps + to add details about the Grafana server: +
      +
    1. + Enter a name for the Grafana + server in the Resource name field. +
      The Resource name is the required field, and + you must provide a unique name. The Resource name can contain up to 24 characters + including alphanumeric characters (A-Z, a-z, and 0-9) and special + characters (@ # $).
      Note: You must + note that the Resource name is not case sensitive. + Therefore, the entries with similar names but + different capitalization, such as SYS1 and Sys1 are considered + as identical by the system.
      +
    2. +
    3. + Enter the host name or IP + address of the Grafana server that you want to + access in the Host + name or IP address field. +
      The host name or IP address + can contain up to 4000 + characters.
      +
    4. +
    5. + Select Grafana from the Target + system type drop-down list. +
    6. +
    7. + Select the Use + HTTPS checkbox to enable secure + communication. +
    8. +
    9. + Enter the port number where + the Grafana server is hosted in the Port field. +
      +

      The + Port is the required field, and the + default port number is set to 3000.

      +
      Tip: + Alternatively, you can use up-down controls to specify the port + number.
      +
      +
    10. +
    +
  10. +
  11. + Click OK. +
  12. +
+
+
+

Results

+
You have defined the Grafana server as the target + system.
+
+

What + to do next

+
You can perform the following + tasks:
+
+
+
+

. Accessing the Grafana + dashboard

+
+

You can + access the Grafana dashboard from the Resource + Monitoring page of z/OSMF to investigate the RMF Monitor III + metrics and reports.

+
+

Before + you begin

+
You must have defined the Grafana server in z/OSMF. See Defining the Grafana + server (on page ).
+
+
+

Procedure

+
+
    +
  1. + Enter the URL of z/OSMF in a web browser. +
  2. +
  3. + Log in to z/OSMF if you are not already logged + in. +
  4. +
  5. + Double-click Resource Monitoring. +
  6. +
  7. + Select the Grafana server + that you want to access from the drop-down + list. +
  8. +
  9. + Click OK. +
  10. +
+
+
+

Results

+
You have accessed Grafana from z/OSMF.
+
+

What + to do next

+
You can perform the following + tasks:
    +
  • View the dashboards by navigating to Apps > + IBM + RMF > + Dashboards.
  • +
  • Add a RMF data source to fetch data from Distributed Data Servers (DDS). See Creating RMF data + sources (on page ).
  • +
+
+
+
+
+
+
+
+
+ +
\ No newline at end of file diff --git a/grafana/rmf-app/doc/src/rn.dita b/grafana/rmf-app/doc/src/rn.dita index 7f914075..0a8654ce 100644 --- a/grafana/rmf-app/doc/src/rn.dita +++ b/grafana/rmf-app/doc/src/rn.dita @@ -8,44 +8,91 @@
What's new
+ +
May 2025 v1.0.9
+
+
    +
  • +

    plugin has been + enhanced to optimize the step size when querying and displaying + time series data, based on the selected time range and panel + size. This enhancement ensures that panels display the required + number of data points.

    +
  • +
  • +

    A bug has been fixed that was causing specific data points to be + dropped from time series views, resulting in a flat line in the + graphs.

    +
  • +
  • +

    +

  • +
+
+
+
+
+
+
April 2025 v1.0.8
    -
  • A new option, Compression, has been added to - the data source creation process. This option enables the RMF data - source to request HTTP compression from the Data Distributed Server - (DDS) during data retrieval, which improves the efficiency of data - transfer. See .
  • -
  • Fixed certain scenarios of missing data within dashboards for time - series visualizations.
  • -
  • Fixed internally found defects.
  • +
  • +

    A new option, Compression, has been added + to the data source creation process. This option enables the RMF + data source to request HTTP compression from the Data + Distributed Server (DDS) during data retrieval, which improves + the efficiency of data transfer. See .

    +
  • +
  • +

    Fixed certain scenarios of missing data within dashboards for + time series visualizations.

    +
  • +
  • +

    +

November 2024 v1.0.7
-
Fixed internally found defects.
    -
  • Fixed internally found defects.
  • -
  • You can now download - plugin documentation as a PDF file. See .
  • -
+
+

+

    +
  • +

    +

  • +
  • +

    You can now download plugin documentation as a PDF file. See .

    +
  • +
+
October 2024 v1.0.6
    -
  • The plugin now allows - customizing banner and caption fields in IBM RMF Report - visualizations.
  • -
  • After you modify any data source - and save the changes, you no longer need to re-enter the - password.
  • -
  • Improved performance.
  • -
  • Fixed internally found defects.
  • +
  • +

    The plugin now + allows customizing banner and caption fields in IBM RMF Report + visualizations.

    +
  • +
  • +

    After you modify any data + source and save the changes, you no longer need to re-enter the + password.

    +
  • +
  • +

    Improved performance.

    +
  • +
  • +

    +

@@ -57,11 +104,17 @@
August 2024 v1.0.5
    -
  • When creating the datasource, you now have the option to specify the - desired cache size in megabytes for the datasource.
  • -
  • Fixed internally found defects.
  • -
  • The topic of has been updated - per the new UI changes.
  • +
  • +

    When creating the datasource, you now have the option to specify + the desired cache size in megabytes for the datasource.

    +
  • +
  • +

    +

  • +
  • +

    The topic of has been + updated per the new UI changes.

    +
@@ -69,38 +122,48 @@
June 2024 v1.0.4
    -
  • The user interface for creating the datasource has been enhanced to - improve the user experience.
  • -
  • Fixed internally found defects.
  • -
  • The following dashboards are updated:
      -
    • Common Storage Activity (Timeline)
    • -
    • Common Storage Activity
    • -
    • Coupling Facility Overview (Timeline)
    • -
    • Coupling Facility Overview
    • -
    • Execution Velocity (Timeline)
    • -
    • Execution Velocity
    • -
    • General Activity (Timeline)
    • -
    • General Activity
    • -
    • Overall Image Activity (Timeline)
    • -
    • Overall Image Activity
    • -
    • Performance Index (Timeline)
    • -
    • Response Time (Timeline)
    • -
    • Response Time
    • -
    • XCF Activity (Timeline)
    • -
    • XCF Activity
    • -
    • - You must re-import the - dashboards to utilize the latest enhancements in the - dashboards. -
    • -
  • -
  • The documentation updates for v1.0.4 include the following - changes:
      -
    • The topic of has been - updated as per the new UI changes.
    • -
    • The topic is included to - provide information about the upgrade process.
    • -
  • +
  • +

    The user interface for creating the datasource has been enhanced + to improve the user experience.

    +
  • +
  • +

    +

  • +
  • +

    The following dashboards are updated:

      +
    • Common Storage Activity (Timeline)
    • +
    • Common Storage Activity
    • +
    • Coupling Facility Overview (Timeline)
    • +
    • Coupling Facility Overview
    • +
    • Execution Velocity (Timeline)
    • +
    • Execution Velocity
    • +
    • General Activity (Timeline)
    • +
    • General Activity
    • +
    • Overall Image Activity (Timeline)
    • +
    • Overall Image Activity
    • +
    • Performance Index (Timeline)
    • +
    • Response Time (Timeline)
    • +
    • Response Time
    • +
    • XCF Activity (Timeline)
    • +
    • XCF Activity
    • +
    You must re-import the + dashboards to utilize the latest enhancements in the + dashboards.

    +
  • +
  • +

    The documentation updates for v1.0.4 include the following + changes:

      +
    • +

      The topic of + has been updated as per the new UI changes.

      +
    • +
    • +

      The topic is + included to provide information about the upgrade + process.

      +
    • +

    +
@@ -108,45 +171,82 @@
February 2024 v1.0.3
    -
  • Fixed specific issues related to the support of Grafana - v10.x.x.
  • -
  • Fixed empty settings issue for IBM RMF data source defined via - Home / Apps / IBM RMF page.
  • -
  • Fixed internally found defects.
  • -
  • The documentation updates for v1.0.3 include the following - changes:
      -
    • The Grafana through IBM - z/OS Management Facility topic explains more - detailed setup instructions to access Grafana from the - z/OSMF server.
    • -
    • The plugin - installation section is updated to provide clear - information and guidance on installing the plugin on - different platforms based on specific requirements.
    • -
    • The troubleshooting topic - is provided to help users analyze and resolve common issues - that may occur while using the plugin.
    • -
  • +
  • +

    Fixed specific issues related to the support of Grafana + v10.x.x.

    +
  • +
  • +

    Fixed empty settings issue for IBM RMF data source defined via + Home / Apps / IBM RMF page.

    +
  • +
  • +

    +

  • +
  • +

    The documentation updates for v1.0.3 include the following + changes:

      +
    • +

      The Grafana + through IBM z/OS Management Facility topic + explains more detailed setup instructions to access + Grafana from the z/OSMF server.

      +
    • +
    • +

      The plugin + installation section is updated to provide + clear information and guidance on installing the plugin on + different platforms based on specific + requirements.

      +
    • +
    • +

      The troubleshooting topic is provided to help + users analyze and resolve common issues that may + occur while using the + plugin.

      +
    • +

    +
December 2023 v1.0.2
-
Support spaces in Datasource name.
+
+
    +
  • +

    Support spaces in Datasource name.

    +
  • +
  • +

    +

  • +
+
November 2023 v1.0.1
-
Resolved security issues in dependencies.
+
+
    +
  • +

    Resolved security issues in dependencies.

    +
  • +
  • +

    +

  • +
+
November 2023 v1.0.0
-
The first release of the - plugin is in the following GitHub repository: https://github.com/IBM/RMF.
+
+

The first release of the + plugin is in the following GitHub repository: https://github.com/IBM/RMF.

+