15 VMwareのカスタムパフォーマンスカウンター名作成

概要

VMwareのパフォーマンスカウンターパスは group/counter[rollup] という形式であり、以下のようになります。

group - パフォーマンスカウンターグループ（例：cpu）
counter - パフォーマンスカウンター名（例：usagemhz）
rollup - パフォーマンスカウンターのロールアップタイプ（例：average）

したがって、上記の例では次のようなカウンターパスになります： cpu/usagemhz[average]

パフォーマンスカウンターグループの説明、カウンター名、ロールアップタイプについては、VMwareのドキュメントを参照してください。

Zabbixのスクリプトアイテムを使用することで、内部名を取得したり、カスタムのパフォーマンスカウンター名を作成したりすることができます。

設定

メインのVMwareホスト（eventlog[] アイテムが存在するホスト）で、以下のパラメータで無効化されたスクリプトアイテムを作成します。

名前: VMware metrics
タイプ: スクリプト
キー: vmware.metrics
情報のタイプ: テキスト
スクリプト: 下記のスクリプトをコピー＆ペースト
タイムアウト: 10
履歴: 保存しない
有効: チェックを外す

スクリプト

try {
           Zabbix.log(4, 'vmware metrics script');
       
           var result, resp,
           req = new HttpRequest();
           req.addHeader('Content-Type: application/xml');
           req.addHeader('SOAPAction: "urn:vim25/6.0"');
       
           login = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\
           <soapenv:Header/>\
           <soapenv:Body>\
               <urn:Login>\
                   <urn:_this type="SessionManager">SessionManager</urn:_this>\
                   <urn:userName>{$VMWARE.USERNAME}</urn:userName>\
                   <urn:password>{$VMWARE.PASSWORD}</urn:password>\
               </urn:Login>\
           </soapenv:Body>\
       </soapenv:Envelope>'
           resp = req.post("{$VMWARE.URL}", login);
           if (req.getStatus() != 200) {
               throw 'Response code: '+req.getStatus();
           }
       
           query = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\
       <soapenv:Header/>\
           <soapenv:Body>\
               <urn:RetrieveProperties>\
                   <urn:_this type="PropertyCollector">propertyCollector</urn:_this>\
                   <urn:specSet>\
                       <urn:propSet>\
                          <urn:type>PerformanceManager</urn:type>\
                          <urn:pathSet>perfCounter</urn:pathSet>\
                       </urn:propSet>\
                       <urn:objectSet>\
                          <urn:obj type="PerformanceManager">PerfMgr</urn:obj>\
                       </urn:objectSet>\
                   </urn:specSet>\
               </urn:RetrieveProperties>\
           </soapenv:Body>\
       </soapenv:Envelope>'
           resp = req.post("{$VMWARE.URL}", query);
           if (req.getStatus() != 200) {
               throw 'Response code: '+req.getStatus();
           }
           Zabbix.log(4, 'vmware metrics=' + resp);
           result = resp;
       
           logout = '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:vim25">\
           <soapenv:Header/>\
           <soapenv:Body>\
               <urn:Logout>\
                   <urn:_this type="SessionManager">SessionManager</urn:_this>\
               </urn:Logout>\
           </soapenv:Body>\
       </soapenv:Envelope>'
       
           resp = req.post("{$VMWARE.URL}",logout);         
           if (req.getStatus() != 200) {
               throw 'Response code: '+req.getStatus();
           }
       
       } catch (error) {
           Zabbix.log(4, 'vmware call failed : '+error);
           result = {};
       }
       
       return result;

アイテムを設定したら、テストボタンを押し、値の取得を押します。

取得したXMLを任意のXMLフォーマッタにコピーし、目的のメトリックを探します。

1つのメトリックに対するXMLの例:

<PerfCounterInfo xsi:type="PerfCounterInfo">
           <key>6</key>
           <nameInfo>
               <label>Usage in MHz</label>
               <summary>CPU usage in megahertz during the interval</summary>
               <key>usagemhz</key>
           </nameInfo>
           <groupInfo>
               <label>CPU</label>
               <summary>CPU</summary>
               <key>cpu</key>
           </groupInfo>
           <unitInfo>
               <label>MHz</label>
               <summary>Megahertz</summary>
               <key>megaHertz</key>
           </unitInfo>
           <rollupType>average</rollupType>
           <statsType>rate</statsType>
           <level>1</level>
           <perDeviceLevel>3</perDeviceLevel>
       </PerfCounterInfo>

取得したXMLからカウンターパスを抽出するにはXPathを使用します。上記の例の場合、XPathは以下のようになります。

field	xPath	value
group	//groupInfo[../key=6]/key	cpu
counter	//nameInfo[../key=6]/key	usagemhz
rollup	//rollupType[../key=6]	average

この場合のパフォーマンスカウンターパスは: cpu/usagemhz[average] です。

Documentation

15 VMwareのカスタムパフォーマンスカウンター名作成

概要

設定

スクリプト