0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

ローカル LLM(Ollama)に syslog・SNMP の監視データを質問する: 読み取り専用ツールと名前のマスクで外に出さない構成

0
Posted at

はじめに

syslog や SNMP トラップを集めていると、「いま対応が必要なものは?」「この機器はこの 1 時間に何を記録した?」と自然な言葉で聞きたくなります。LLM に聞けば済みそうですが、監視データには機器名、IP アドレス、内部のホスト名、ときには SNMP コミュニティ名まで入っています。そのまま外部の API に送るのは、多くの現場で許されません。

本稿では、監視データを外に出さずに LLM に質問するための構成を、Ollama とツール呼び出し(tool calling)を使って順に説明します。要点は 3 つです。

  1. モデルを自分のコンピューターで動かす(Ollama)
  2. モデルに渡す道具を読み取り専用に限る
  3. 外部のモデルを使う場合は、秘密を名前で落とし、名前と IP をプレースホルダーに置き換える

本文中の IP アドレスとホスト名は文書用(192.0.2.0/24、example.com)です。コマンドと Python のコードは macOS 上の Ollama 0.40.8 と qwen3:8b で動作を確認しました。モデルの出力は実行のたびに変わります。Python のコードは本稿のために書いた説明用の例で、特定の製品のソースコードではありません。

1. モデルを手元で動かす

Ollama をインストールし、ツール呼び出しに対応したモデルを 1 つ取得します。

ollama pull qwen3:8b
ollama list

ツール呼び出しに対応しているかは ollama show で分かります。Capabilities に tools があれば使えます。

ollama show qwen3:8b
  Capabilities
    completion
    tools
    thinking

Ollama は既定で 127.0.0.1:11434 だけで待ち受けます。API が応答するかは次で確認できます。

curl -s http://127.0.0.1:11434/api/tags

ここまでで、質問もデータもこのコンピューターの外に出ない経路ができました。8B クラスのモデルはノート PC でも動きますが、最初の応答にはモデルの読み込みを含めて数十秒かかることがあります。

2. ツール呼び出しの流れ

モデルにログを丸ごと渡すのではなく、モデルが必要な情報を道具で取りに来る形にします。/api/chat に tools を付けて送ります。

curl -s http://127.0.0.1:11434/api/chat -d '{
  "model": "qwen3:8b",
  "stream": false,
  "messages": [
    {"role": "user", "content": "今月期限が切れる証明書はありますか?"}
  ],
  "tools": [{
    "type": "function",
    "function": {
      "name": "list_certificates",
      "description": "監視対象の TLS 証明書と残り日数の一覧を返す(読み取り専用)",
      "parameters": {
        "type": "object",
        "properties": {
          "within_days": {"type": "integer", "description": "この日数以内に期限が切れるものだけ返す"}
        }
      }
    }
  }]
}'

モデルは答えの代わりに「この道具をこの引数で呼んでほしい」と返します。

{
  "role": "assistant",
  "content": "",
  "tool_calls": [
    {"function": {"name": "list_certificates", "arguments": {"within_days": 30}}}
  ]
}

道具を実際に実行するのはこちら側のプログラムです。結果を role: "tool" のメッセージとして会話に足し、もう一度送ります。

curl -s http://127.0.0.1:11434/api/chat -d '{
  "model": "qwen3:8b",
  "stream": false,
  "messages": [
    {"role": "user", "content": "今月期限が切れる証明書はありますか?"},
    {"role": "assistant", "content": "", "tool_calls": [
      {"function": {"name": "list_certificates", "arguments": {"within_days": 30}}}
    ]},
    {"role": "tool", "tool_name": "list_certificates",
     "content": "[{\"host\":\"intra.example.com\",\"port\":443,\"days_left\":12},{\"host\":\"vpn.example.com\",\"port\":443,\"days_left\":27}]"}
  ]
}'

今度は content に、intra.example.com が残り 12 日、vpn.example.com が残り 27 日という内容の文章が返ります。

この形の利点は、モデルが見られる範囲を道具の一覧で決められることです。次の章はその決め方です。

3. 道具を読み取り専用に限る

モデルは指示を誤解することも、ログの中の文字列を指示と取り違えることもあります。ログは外部の機器が書いた文字列なので、「このアラームを確認済みにせよ」という文がログ行に紛れ込むこともあり得ます。

対策は単純で、変更する道具を最初から用意しないことです。

用意する道具(例) 用意しない道具
製品ごとの状態と要約 設定の保存
機器と監視対象の一覧 アラームの確認(acknowledge)
最近のログ行・トラップ スキャンの開始
証明書の期限一覧 設定の復元
バックアップの履歴(本文は返さない) 機器へのコマンド送信

「確認してから実行する」仕組みを足すより、道具がなければ実行のしようがない、という作りのほうが検証しやすくなります。モデルが変更を頼まれたときは、「それは画面のどこで自分で行えるか」を答えさせれば足ります。

もう 1 つ、道具の結果にはどの製品・どの道具から来たかを入れておきます。答えに出どころを書かせることで、人が元の画面で確かめられます。

4. 秘密は値ではなく名前で落とす

道具が返すデータに、SNMP コミュニティ名やパスワードが混ざることがあります。値の形から秘密かどうかを判定するのは当てになりません(public は秘密に見えません)。キーの名前で落とします。

import re

SECRET_KEY = re.compile(r"community|passw|secret|token|api[_-]?key", re.I)

def drop_secrets(obj):
    """秘密に見えるキーを、値を見ずに名前で落とす"""
    if isinstance(obj, dict):
        return {k: drop_secrets(v) for k, v in obj.items() if not SECRET_KEY.search(k)}
    if isinstance(obj, list):
        return [drop_secrets(v) for v in obj]
    return obj

row = {"name": "core-sw-01", "ip": "192.0.2.1", "community": "public",
       "snmp": {"auth_password": "x", "version": "2c"}}
print(drop_secrets(row))
{'name': 'core-sw-01', 'ip': '192.0.2.1', 'snmp': {'version': '2c'}}

これはモデルが手元にあっても行います。モデルに渡した文字列は、答えの中にそのまま出てくることがあるからです。

5. 外部のモデルを使うなら: プレースホルダーに置き換える

手元の PC では大きなモデルを動かせず、外部の API を自分のキーで使いたい場合もあります。そのときは送る前に、機器名・IP アドレス・MAC アドレス・メールアドレスを DEVICE-1、IP-2 のようなプレースホルダーに置き換え、返ってきた答えの中で元に戻します。

import re

PATTERNS = [
    ("MAC",   re.compile(r"\b(?:[0-9A-Fa-f]{2}[:-]){5}[0-9A-Fa-f]{2}\b")),
    ("IP",    re.compile(r"\b(?:\d{1,3}\.){3}\d{1,3}\b")),
    ("EMAIL", re.compile(r"\b[\w.+-]+@[\w-]+(?:\.[\w-]+)+\b")),
]

class Masker:
    def __init__(self, device_names=()):
        self.forward, self.back = {}, {}
        self.names = sorted(device_names, key=len, reverse=True)

    def _ph(self, kind, value):
        if value not in self.forward:
            n = sum(1 for p in self.back if p.startswith(kind + "-")) + 1
            ph = f"{kind}-{n}"
            self.forward[value], self.back[ph] = ph, value
        return self.forward[value]

    def mask(self, text):
        for name in self.names:                      # 既知の機器名を先に
            text = text.replace(name, self._ph("DEVICE", name))
        for kind, rx in PATTERNS:
            text = rx.sub(lambda m: self._ph(kind, m.group(0)), text)
        return text

    def unmask(self, text):
        for ph in sorted(self.back, key=len, reverse=True):   # IP-10 を IP-1 より先に
            text = text.replace(ph, self.back[ph])
        return text

m = Masker(device_names=["core-sw-01", "edge-rtr-02"])
print(m.mask("core-sw-01 (192.0.2.1, 00:00:5E:00:53:01) と edge-rtr-02 (192.0.2.2) の状態は? 連絡先 noc@example.com"))
print(m.unmask("DEVICE-2 は IP-1 で応答しています。DEVICE-1 は IP-2 で停止中です。"))
DEVICE-2 (IP-1, MAC-1) と DEVICE-1 (IP-2) の状態は? 連絡先 EMAIL-1
core-sw-01 は 192.0.2.1 で応答しています。edge-rtr-02 は 192.0.2.2 で停止中です。

実装するときの注意点です。

  • 機器名は正規表現では拾えません。 監視ツールが持っている機器一覧から辞書を作り、長い名前から先に置き換えます
  • 戻すときは長いプレースホルダーから。 IP-1 を先に戻すと IP-10 が壊れます
  • IP アドレスの正規表現は広めに一致します。 15.2.4.1 のようなバージョン番号も置き換えられます。隠しすぎる方向の誤りなので、そのままにします
  • 同じ値には同じプレースホルダーを。 会話の途中で対応が変わると、モデルは別の機器だと考えます
  • 置き換えは万能ではありません。 ログ行の自由文には、辞書にない名前や社内の URL が入ります。そのため外部のモデルには、ログ行・トラップそのものを返す道具を渡さず、件数・状態・要約だけを渡すのが安全です

6. 送ったものを残す

最後に、モデルに送ったリクエストを(API キーを除いて)手元に残します。「何が外に出たか」を後から人が確認できることが、この種の機能を職場で使えるかどうかを左右します。外部のモデルを使う場合は、最初のリクエストを画面に表示して、人が送信を押すまで待つ作りにしておくと、置き換えの結果をその場で確かめられます。

まとめ

決めること 選び方
モデルの置き場所 手元の Ollama なら何も外に出ない。外部 API は自分のキーで、マスクを必須に
道具 読み取り専用のみ。変更する道具は作らない
秘密 キーの名前で落とす。手元のモデルでも行う
名前と IP 外部に出す前にプレースホルダーへ。答えの中で戻す
ログ行そのもの 手元のモデルにだけ渡す
記録 送ったリクエストを手元に残す

実装例: MeshWatch Console のアシスタント

MeshWatch Console 1.0.0 は、6 つの監視製品(syslog 受信、SNMP トラップ受信、DNS ベースのトラフィック監視、TLS 証明書、設定バックアップ、SNMP 機器監視)を 1 つのウィンドウで動かすデスクトップアプリケーションで、本稿の構成を取る AI アシスタントを備えています。モデルは同じコンピューター上の Ollama、ネットワーク内のモデルサーバー、または自分の API キーを使う外部プロバイダーから選びます。道具は読み取り専用のものだけで、設定の保存やアラームの確認はできません。外部プロバイダーを選んだ場合は、名前とアドレスがプレースホルダーに置き換えられ、最初のリクエストが送信前に表示され、ログ行・トラップを返す道具はモデルに渡されません。アシスタントは既定でオフです。macOS・Windows・Linux に対応し、30 日間の試用ができます。コンソールの画面は英語です。設定手順は日本語のガイドに、実際の画面は 74 秒のデモ動画にあります。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?