SNMP プローブパラメーター

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：6分

    • このパラメーターリストは、SNMP プローブに渡すことができます。

    プローブ パラメーターの設定手順については、「プローブパラメーターを設定」を参照してください。

    パラメーター 説明 デフォルト値
    oid_spec_list

    OID 仕様のリスト (1 行に 1 つ)。各仕様は、次の 2 つの形式のいずれかになっている必要があります。

    • walk {OID}：OID とそのすべての子をウォークします
    • table {OID} {OID Children}：テーブル内のすべてのエントリーをウォークし、指定した子のみを返します (例："iso.org.dod.internet")

    {OID Children} は、指定されたテーブルのエントリー内の、カンマで区切られた子ノードのリストを参照します。たとえば、「ifEntry.ifIndex,ifEntry.ifDescr,ifEntry.ifType」はテーブル「iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable」の OID の子です。便宜上、テーブルエントリープリフィックスは省略される場合があります(前にある子は、「ifIndex,ifDescr,ifType」として指定できます)。

    いずれの子にも、括弧内にフィルター修飾子を含めることができます。たとえば、子「entPhysicalContainedIn(= 0)」は、「entPhysicalContainedIn」の値が 0 の場合にのみテーブルエントリーを返すことを指定します。式でサポートされている演算子は次のとおりです。
    = 次の値と等しい
    != 次の値と等しくない
    番号 次の値を含む

    複数の子にフィルター式がある場合、いずれかの子が一致すると、そのエントリーが読み取られます。

    「//」を含むすべてのコンテンツは無視されます (コメント)。「1.3.6.1」または「iso.org.dod.internet」で始まらない OID は、便宜上「1.3.6.1」と自動的に前置きされます。

    		 required
    ソース SNMP をクエリーするデバイスの IP アドレスまたはホスト名です。 required
    インデックス コミュニティ文字列の後に適用するインデックスです。VLAN インタロゲーションの場合は、Cisco スタイルのコミュニティ文字列インデックスです。 0
    credential_id 他よりも優先的に使用される特定の認証情報の sys_id です。このパラメーターは内部でのみ使用され、サポートされていません。 なし
    credential_tag 使用する必要がある認証情報タグです。このパラメーターは内部でのみ使用され、サポートされていません。 なし
    timeout

    デフォルトに代わる応答を待機するためのタイムアウト値 (ミリ秒単位) です。このパラメーターを使用して、mid.snmp.request.timeout SNMP MID サーバー設定パラメーターを上書きすることができます。

    注:
    use_getbulk が true に設定されている場合、個別の GETBULK 要求に対してタイムアウト値が設定されます。
    		 1500
    established_session_timeout 少なくとも 1 つの応答が受信された後に応答を待機する間隔 (ミリ秒単位) です。これより長い値は、完全かつ正確なデータを収集するのに役立ちます。このパラメーターを使用して、mid.snmp.session.timeout SNMP MID サーバー設定パラメーターを上書きすることができます。 500
    debug デバッグログ記録を有効にします。デバッグモードの場合は true に設定します。 false
    request_interval 応答が受信されなかったときに、タイムアウトして (または established_session_timeout 値に達して) OID に後続の要求を行うまでの間隔 (ミリ秒単位) です。この値がタイムアウト (または established_session_timeout) 値と同じかそれ以上に設定されている場合は、特定の OID に対して単一の要求のみが送信されます。タイムアウト (または established_session_timeout) 値を変更する場合は、request_interval を同時に調整して、指定された環境に合わせて、同じ OID に対する要求が多くなりすぎたり少なくなりすぎたりしないようにします。 400
    request_delay 応答の受信と次の要求の送信との間の間隔 (ミリ秒単位) です。デフォルトは 0 (遅延なし) です。この値で、SNMP クエリーの全体的な速度を遅くするように設定することができます。 0
    result_format これらのプローブの JSON 形式のペイロードを返します。
    • SNMP - F5 BIG-IP - システム
    • SNMP - Netscaler - システム
    • SNMP - ルーティング
    このパラメーターは、ペイロードが大きくなった場合に、ノード上のセンサー障害やメモリーの問題を防ぐために、データをよりコンパクトな形式で返します。この値を変更したり、このパラメーターを削除したりしないでください。
    警告:
    このパラメーターを他のプローブとともに使用すると、センサーに障害が発生します。
    		 JSON
    use_getbulk
    複数の SNMP GETNEXT 要求を使用するのではなく、SNMP デバイスから表データを取得するための SNMP GETBULK 要求の使用を有効にします。表形式のデータでは、GETBULK の方が効率的です。要求タイプに関係なく、特定のデバイスは他のタスクでビジー状態の場合に何も結果を返さないことがあります。このパラメーターは、プローブレベルでの設定に使用されます。また、GETBULK は、個々の MID サーバーまたはすべての MID サーバーに対してグローバルに設定することもできます。設定は、優先度の順にリストされます。

    use_getbulk が true に設定されている場合、established_session_timeout, request_interval, および request_delay のパラメーターは無視されます。代わりに、retries のパラメーターを使用できます。タイムアウト設定は、use_getscalar で使用されているものと同じです。

    デフォルトでは、次のプローブは GETBULK 要求を使用します (パラメーター値は true)。
    • SNMP - スイッチ - Vlan
    • SNMP - スイッチ - BridgePortTable
    • SNMP - スイッチ - ForwardingTable
    • SNMP - スイッチ - SpanningTreeTable
    • SNMP - ネットワーク - ArpTable
    • SNMP - レイヤー 2 プロトコルキャッシュ
    • SNMP - F5 BIG IP - システム (サービスマッピングの顧客のみ)
    注:
    これらのプローブの timeout の値は 5000 です。
    		 false
    use_getscalar SNMP デバイスからのスカラー値の簡単な取得と処理を有効にします。

    use_getscalar が true に設定されている場合、established_session_timeout, request_interval および request_delay のパラメーターは無視されます。代わりに、retries および timeout のパラメーターを使用できます。タイムアウト設定は、use_getbulk で使用されているものと同じです。

    		 false
    retries use_getscalar のパラメーターが true に設定されている場合に、個別の GETBULK 要求 (use_getbulk を参照) または GETNEXT 要求を完了するための ディスカバリー の追加の試行回数です。 2