概要
ネットワーク機器の監視を行う際、機器固有のMIBファイルを監視ツールで使える形式に変換する必要があります。この記事では、mibdumpというツールを使って、MIBファイルをPythonやJSON形式に変換する方法を解説します。環境構築から実際の変換例まで、初心者の方でも迷わず実践できるよう詳しく説明していきます。
mibdumpとは
mibdumpは、SNMP（Simple Network Management Protocol）で使用されるMIB（Management Information Base）ファイルを、PythonやJSON、YAMLなどの形式に変換できるツールです。
ネットワーク機器の監視を行う際、機器固有のMIBファイルが必要になりますが、そのままでは以下の課題があります。
MIBファイルはASN.1形式で記述されており、内容を理解するのが困難です。また、New RelicやDatadogなどの監視サービスでは、JSON/YAML形式のプロファイルが必要になります。さらに、PythonスクリプトでSNMP処理を行う場合、pysnmp形式への変換が求められます。
mibdumpを使うことで、こうした形式変換の問題を効率的に解決できるでしょう。
環境構築の準備
まずは必要なPythonライブラリをインストールしましょう。
pip install pysmi pysnmp pysnmp-mibs
Python 3.10以上を推奨します。バージョン確認は python --version で行えます。
基本的な変換手順
MIBファイルの準備
変換したいMIBファイル（例：CISCO-MEMORY-POOL-MIB.mib）を任意のフォルダに配置します。
最もシンプルな変換
Python形式（pysnmp）への変換が最も簡単です。
mibdump.py CISCO-MEMORY-POOL-MIB
変換されたファイルが ~/.pysnmp/mibs/ に保存されます。
実用的な変換例
JSON形式への変換（New Relic用）
New Relicの監視で使用するために、MIBファイルをJSON形式に変換する例です。
mibdump.py --mib-source=./mibs --destination-format=json --destination-directory=./output CISCO-MEMORY-POOL-MIB
Python形式への変換（Datadog用）
DatadogのSNMP監視で使用するために、MIBファイルをPython（pysnmp）形式に変換する例です。
mibdump.py --mib-source=./mibs --destination-directory=./output CISCO-MEMORY-POOL-MIB
各監視サービスの特徴は以下の通りです。
New RelicはJSON形式のプロファイルを使用してSNMP監視を設定します。一方でDatadogはPython（pysnmp）形式のMIBファイルを使用してSNMP監視を設定します。--mib-source=./mibsでMIBファイルが格納されているディレクトリを指定し、--destination-format=jsonで出力形式をJSONに指定します（New Relic用）。--destination-directory=./outputで変換結果の保存先を指定できます。
よく使うオプションと活用方法
複数のMIBファイルを一括変換
mibdump.py --mib-source=./mibs --destination-format=json --destination-directory=./output --ignore-errors CISCO-*
--ignore-errorsオプションを追加することで、エラーが発生しても処理を継続できます。
依存関係エラーの対処法
MIBファイルに依存関係がある場合、以下のオプションが有効です。
mibdump.py --mib-source=./mibs --mib-source=http://mibs.snmplabs.com/asn1/@mib@ --destination-format=json ./output CISCO-MEMORY-POOL-MIB
オンラインのMIBレポジトリを追加ソースとして指定し、依存関係を自動解決します。
初心者が覚えておくべき重要なオプションをまとめると以下の通りです。
| オプション | 用途 | 使用例 |
|---|---|---|
--destination-format |
出力形式を指定 | --destination-format=json |
--destination-directory |
出力先ディレクトリ指定 | --destination-directory=./output |
--mib-source |
MIBファイルの場所指定 | --mib-source=./mibs |
--ignore-errors |
エラーを無視して継続 | --ignore-errors |
--dry-run |
実際には変換せずテスト | --dry-run |
トラブルシューティング
ファイルが見つからない場合
MIBファイルのパスが正しいか確認しましょう。ファイル名の拡張子（.mib、.txt）も確認が必要です。
依存関係でエラーが出る場合
# オンラインソースを追加
mibdump.py --mib-source=http://mibs.snmplabs.com/asn1/@mib@ [その他のオプション]
権限でエラーが出る場合
# 出力ディレクトリを作成
mkdir -p ./output
# または管理者権限で実行
sudo mibdump.py [オプション]
変換形式ごとの用途・活用例
| 変換形式 | 用途・活用例 | 主な利用シーン | ktranslateでの利用可否 |
|---|---|---|---|
| pysnmp（Python） | PySNMPライブラリ用MIBモジュール、Pythonスクリプトなどでimport | SNMP監視・自動化、Datadog監視 | ×（直接利用不可） |
| JSON | SNMP監視アプリやダッシュボード用、ktranslateの中間ファイル | YAML形式へktranslate経由で変換しプロファイル作成 | ○（ktranslateでYAML変換に利用） |
| YAML | ktranslateが認識するプロファイル形式 ※ktranslateコンテナを使ったjson→yaml変換が必要 | SNMP監視、NewRelic等の監視プロファイル | ○（json経由で生成されたもののみ） |
| ASN.1テキスト | 人間可読、MIBブラウザ等 | ドキュメント確認、MIBブラウザ | × |
まとめ
mibdumpを使うことで、複雑なMIBファイルを簡単に扱いやすい形式に変換できます。特に覚えておきたいポイントは以下の通りです。
基本の変換コマンドは mibdump.py MIB-NAME だけで実行可能です。監視ツールとの連携にはJSON形式が適しています。依存関係のエラーには--ignore-errorsオプションで対処できるでしょう。オンラインソース--mib-source=http://mibs.snmplabs.com/asn1/@mib@を活用することで、依存関係を自動解決できます。
New RelicやDatadogなどの監視サービスを導入する際、MIBファイルの変換作業は避けて通れません。この記事で紹介した手順を参考に、効率的な監視環境を構築してください。
全オプション一覧（リファレンス）
上級者向けの全オプション一覧表です。初心者は「よく使うオプション解説」の内容で十分です。
| オプション | 解説・用途 |
|---|---|
| --help | ヘルプ表示 |
| --version | バージョン表示 |
| --quiet | 最小限の出力にする |
| --strict | MIB構文解析をStrictモードで実施。厳密な構文違反時にエラー扱い |
| --debug= | 対象別詳細デバッグ出力（all, borrower, codegen, compiler, grammar等を指定） |
| --mib-source= | 変換元のMIBディレクトリ/ZIP/HTTP/URL指定。@mib@トークンも利用可能 |
| --mib-searcher= | 既存変換MIBファイルの追加検索パス指定 |
| --mib-stub= | 特定MIBの変換処理を除外 |
| --mib-borrower= | 既存コンパイル済みMIB(pysnmp形式等)の追加ソース |
| --destination-format= | 出力形式選択（pysnmp, json, null） |
| --destination-template= | Jinja2テンプレートで出力レイアウトを拡張（カスタム出力生成等） |
| --destination-directory= | 変換後MIBファイルの出力先指定 |
| --cache-directory= | パーサのキャッシュ保管場所指定 |
| --disable-fuzzy-source | ファイル探索時の曖昧一致（大文字/小文字/拡張子等）を無効化 |
| --no-dependencies | 依存MIBの再帰的変換を行わず、指定したMIBのみ変換 |
| --no-python-compile | pysnmp形式変換時にPythonバイトコードへコンパイルを無効化 |
| --python-optimization-level | Pythonファイル最適化レベル指定 |
| --ignore-errors | 変換エラーを無視し処理を続行 |
| --build-index | OID等の逆引きインデックス情報を構築 |
| --rebuild | 既存変換済みでも無条件で再変換 |
| --dry-run | 実ファイルを書き出さず変換のみシミュレート |
| --no-mib-writes | MIBファイル書込禁止（実際の変換出力を抑止） |
| --generate-mib-texts | MIB内の説明テキスト文も変換出力 |
| --keep-texts-layout | 説明文レイアウト、改行など元の体裁を保持 |
| [MIB-NAME [...]] | 変換したいMIBファイル名を複数指定可能 |
参考リンク
- pysmi公式ドキュメント - mibdumpの詳細仕様
- Qiita: SNMP MIB変換事例集 - 実際の使用例
- New Relic公式: MIB登録チュートリアル - 監視サービスでの活用法
- Datadog MIB変換ガイド - Datadog向けの設定例