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

概要

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

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

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

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

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

設定

  1. メインの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] です。