【Checkmkプラグイン活用】第4回 Fortigate 60EのIPsec VPNダイアルアップユーザー数をカウントし時系列データを作成

第4回 Fortigate 60EのIPsec VPNダイアルアップユーザー数をカウントし時系列グラフを作成

本記事では、Checkmkのカスタムプラグインを使ってFortigate 60EのIPsec VPN数をカウントし、時系列グラフを作成するところまでをご紹介したいと思います。

文：ジュピターテクノロジー　よしひろ

図1 作成したプラグインで表示されるIPsec VPNユーザー数の時系列グラフ

今回作成するプラグインですが、Checkmkドキュメントの分類では”Genuine Checkmk plug-in”といった分類にあたります。こちらは、100% Checkmkによりインテグレーションされ、自動サービス検出、グラフの閾値設定等をサポートします。プラグイン開発というとなんだか難しそうですが、簡単なpythonスクリプトを書くといった理解でお願いします。

今回作成したプラグイン名は、”fortigate_ipsec_vpn”とします。コピペで直ぐ使えるように、本記事に全文記載しますのでご活用ください。

• “fortigate_ipsec_vpn”プラグインで出来るようになること

• Fortigate 60EのIPsec VPNの接続ユーザー数(ダイヤルアップユーザ*1)がリアルタイムで分かり、時系列グラフで中長期分析が可能となります。

*1 Fortigate 60EのIPsecトンネル設定、”リモートゲートウェイ”が「ダイアルアップユーザ」を設定する環境でのIPsec VPN接続ユーザー数をカウントするプラグインを作ります。こちらの設定が、「スタティックIPアドレス」ですと本文中に記載するOIDが異なる可能性がありますのでご注意ください。

図2 IPsec VPNのリモートゲートウェイ設定

• 監視対象

今回の”fortigate_ipsec_vpn”プラグインで監視する対象は、Fortigate 60Eのみです。Fortigate 60Eには、SNMPを設定する必要があります。こちらの設定手順に関しては、本記事の目的とする所ではありませんので省略します。ご了承ください。

• Checkmkの”Genuine Checkmk plug-in”は、4つの関数を書くだけ

“fortigate_ipsec_vpn”は、4つの関数を書くだけです。いきなりですが、プラグイン全文を記載します。

from cmk.base.plugins.agent_based.agent_based_api.v1 import *

from pprint import pprint

register.snmp_section(

  name = “fortigate_ipsec_vpn”,

  detect = exists(“.1.3.6.1.2.1.1.1.0”),

  fetch = SNMPTree(

    base = ‘.1.3.6.1.4.1.12356.101.12.1.1’,

    oids = [

      ‘0’,

      ],

     ),

  )

def discover_fortigate_ipsec_vpn(section):

        yield Service()

def check_fortigate_ipsec_vpn(section):

    for num in section:

         nusers = int(num[0])

         yield Metric(

             “Fgusers”,

             nusers,

             boundaries=(0, 100))

         nusers = int(num[0])

         print(nusers)

         s = State.OK

         yield Result(state = s, summary = f”{nusers} number of users are connected through IPsec VPN”)

         return

register.check_plugin(

        name=”fortigate_ipsec_vpn”,

        service_name=”FG IPsec VPN USERS”,

        discovery_function=discover_fortigate_ipsec_vpn,

        check_function=check_fortigate_ipsec_vpn,

        )

register.snmp_section()

discover_fortigate_ipsec_vpn()

check_fortigate_ipsec_vpn()

register.check_plugin()