アクティブスクリプト (パフォーマンス)
- Last Updated: May 6, 2024
- 7 minute read
- WhatsUp Gold
- Version 2023.1
アクティブスクリプトパフォーマンスモニタを使用すると、VBScript と JScript を作成して、1 つまたは複数の SNMP または WMI 値のポーリング、それらの値に対する算術演算やその他の演算の実行、および単一の出力値のグラフ化を容易に行うことができます。アクティブスクリプトパフォーマンスモニタは、ポーリングした値に対して計算を実行する必要がある場合にのみ使用してください。この機能を使用して複数の値のポーリングを行うことは可能ですが、データベースに保存されるのは 1 つの値、つまりスクリプト化された計算の結果だけです。
アクティブスクリプトパフォーマンスモニタには、次の認証情報が 1 つ以上必要です。
- SNMPv1
- SNMPv2
- SNMPv3
- WMI
次のボックスを使用してアクティブスクリプトパフォーマンスモニタを設定します。
- [名前]。パフォーマンスモニタの固有の名前を入力します。この名前がモニタライブラリに表示されます。
- [説明]。(省略可能) パフォーマンスモニタの短い説明を入力します。この説明は、モニタライブラリでパフォーマンスモニタの横に表示されます。
- [スクリプトの種類]。JSCRIPT または VBSCRIPT を選択します。
- [タイムアウト]。WhatsUp Gold が選択したデバイスへの接続を試行する時間を入力します。
- [ポーリング間隔]。WhatsUp Gold がデバイスから更新情報を要求する頻度を指定します。
- [参照変数]。SNMP 参照変数と WMI 参照変数を追加、編集、または削除します。アクティブスクリプトパフォーマンスモニタでは必要に応じて参照変数を使用できます。詳細については、「スクリプトモニタでの参照変数の使用」を参照してください。
- [スクリプトテキスト]。モニタコードを入力します。
SNMP アクティブスクリプトパフォーマンスモニタを設定するには:
- 新しい変数を [参照変数] フィールドに追加するには、[アクティブスクリプトパフォーマンスモニタの追加] ダイアログで
をクリックします。[新しい参照変数の追加] ダイアログが表示されます。 - 適切な情報を入力します。
- [変数名]。変数の固有の名前を入力します。
- [説明]。(省略可能) 変数の短い説明を入力します。
- [SNMP] ラジオボタンを選択します。
- デバイス接続の [タイムアウト] および [再試行回数] に値を入力します。これらのフィールドには必要に応じて入力します。
- [選択] をクリックして MIB ブラウザを起動します。
- [コンピュータからカウンタを選択する] ボックスに、接続するコンピュータの名前または IP アドレスを入力します。参照ボタン ([...]) をクリックしてリストからデバイスを選択できます。
- デバイス接続に使用する SNMP 認証情報を選択します。参照ボタン ([...]) をクリックして認証情報ライブラリにアクセスし、新しい認証情報を作成することもできます。
- [タイムアウト] ボックスと [再試行回数] ボックスで、接続するコンピュータの接続試行時間と再試行回数を調整します。
- [OK] をクリックします。
- ナビゲーションツリーを使用して、監視する MIB を選択します。ダイアログの下部に、プロパティ/値の詳細情報が表示されます。
- [OK] をクリックして、[新しい参照変数の追加] ダイアログの [パフォーマンスカウンタ] および [インスタンス] フィールドに OID を追加します。
- 設定を確認し、[OK] をクリックして [アクティブスクリプトパフォーマンスモニタの追加] ダイアログの [参照変数] リストに変数を追加します。
- [スクリプトテキスト] フィールドにモニタコードを記述するか、貼り付けます。
- [OK] をクリックして、変更を保存します。
WMI アクティブスクリプトパフォーマンスモニタを設定するには:
- 新しい変数を [参照変数] フィールドに追加するには、[アクティブスクリプトパフォーマンスモニタの追加] ダイアログで
をクリックします。[新しい参照変数の追加] ダイアログが表示されます。 - 適切な情報を入力します。
- [変数名]。変数の固有の名前を入力します。
- [説明]。(省略可能) 変数の短い説明を入力します。
- [WMI] ラジオボタンを選択します。
- [選択] をクリックして MIB ブラウザを起動します。
- [コンピュータからカウンタを選択する] ボックスに、接続するコンピュータの名前または IP アドレスを入力します。参照ボタン ([...]) をクリックしてリストからデバイスを選択できます。
- デバイスに接続するために使用する Windows 認証情報を選択します。参照ボタン ([...]) をクリックして認証情報ライブラリにアクセスし、新しい認証情報を作成することもできます。
- [OK] をクリックします。
- ナビゲーションツリーを使用して、監視する MIB を選択します。ダイアログの下部に、プロパティ/値の詳細情報が表示されます。
- [OK] をクリックして、[新しい参照変数の追加] ダイアログの [パフォーマンスカウンタ] および [インスタンス] フィールドに OID を追加します。
- 設定を確認し、[OK] をクリックして [アクティブスクリプトパフォーマンスモニタの追加] ダイアログの [参照変数] リストに変数を追加します。
- [スクリプトテキスト] フィールドにモニタコードを記述するか、貼り付けます。
- [OK] をクリックして、変更を保存します。
次の点に注意してください。
- モニタスクリプトにはエラー処理を含める必要があります。スクリプトには、
Context.SetValueを使用してグラフ化する値が必要です。またはContext.SetResultを使用して、WhatsUp Gold にスクリプトが失敗したことを伝える必要があります。 - 何らかの理由でポーリングが失敗すると、
Context.GetReferenceVariableによって「null」が返されます。 SetValueまたはSetResultへの呼び出しがない場合、エラーは報告されず、データはグラフ化されません。SetValueを使用した場合、SetValueによって暗黙的にSetResultが 0、すなわち「良い」に設定されるため、SetResultを使用する必要はありません。- このパフォーマンスモニタの結果は、すべてカスタムパフォーマンスモニタおよびダッシュボードレポートに表示されます。
- このパフォーマンスモニタのエラーは、パフォーマンスモニタのエラーログおよび EventViewer.exe に表示されます。
重要: 平均を計算するために 2 つのポーリングを必要とする WMI 参照変数をポーリングすると (「Processor\% Processor Time」など)、初回は「Null」が返されます。