ping の実行（Python を使用）

1. エグゼクティブサマリー

Python で，IP アドレスを指定して ping を実行する．簡単な死活監視に使うことを想定している．

pings ライブラリを使用し，指定した IP アドレスまたはホスト名に対して ping を実行する．反応があれば OK，なければ NG を表示する．複数の IP アドレスに対する一括監視にも対応し，実行日時とともに各対象の疎通結果を出力する．

2. 前準備（必要ソフトウェアの入手）

ここでは、最低限の事前準備について説明する。機械学習や深層学習を行う場合は、NVIDIA CUDA、Visual Studio、Cursorなどを追加でインストールすると便利である。これらについては別ページ https://www.kkaneko.jp/cc/dev/aiassist.htmlで詳しく解説しているので、必要に応じて参照してください。

Python 3.12 のインストール（Windows 上） [クリックして展開]

以下のいずれかの方法で Python 3.12 をインストールする。Python がインストール済みの場合、この手順は不要である。

方法1：winget によるインストール

管理者権限のコマンドプロンプトで以下を実行する。管理者権限のコマンドプロンプトを起動するには、Windows キーまたはスタートメニューから「cmd」と入力し、表示された「コマンドプロンプト」を右クリックして「管理者として実行」を選択する。

winget install -e --id Python.Python.3.12 --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 AssociateFiles=1 InstallLauncherAllUsers=1"

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動すると PATH が自動的に設定される。

方法2：インストーラーによるインストール

Python 公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンから Windows 用インストーラーをダウンロードする。
ダウンロードしたインストーラーを実行する。
初期画面の下部に表示される「Add python.exe to PATH」に必ずチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

AIエディタ Windsurf のインストール（Windows 上） [クリックして展開]

Pythonプログラムの編集・実行には、AIエディタの利用を推奨する。ここでは、Windsurfのインストールを説明する。Windsurf がインストール済みの場合、この手順は不要である。

winget install -e --id Codeium.Windsurf --scope machine --accept-source-agreements --accept-package-agreements --custom "/SUPPRESSMSGBOXES /MERGETASKS=!runcode,addtopath,associatewithfiles,!desktopicon"
powershell -Command "$env:Path=[System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User'); windsurf --install-extension MS-CEINTL.vscode-language-pack-ja --force; windsurf --install-extension ms-python.python --force; windsurf --install-extension Codeium.windsurfPyright --force"

【関連する外部ページ】

Windsurf の公式ページ: https://windsurf.com/

必要なライブラリ（pings）のインストール [クリックして展開]

python -m pip install -U pings

3. 実行のための準備とその確認手順（Windows 前提）

3.1 プログラムファイルの準備

第5章のソースコードをテキストエディタ（メモ帳，Windsurf 等）に貼り付け，hoge.py として保存する（文字コード：UTF-8）．

3.2 実行コマンド

コマンドプロンプトでファイルの保存先ディレクトリに移動し，以下を実行する．

python hoge.py

3.3 動作確認チェックリスト

確認項目	期待される結果
到達可能な IP アドレスを指定して実行	「OK」と表示される
到達不可能な IP アドレスを指定して実行	「NG」と表示される
複数ホスト一括監視のコードを実行	実行日時と各対象の「OK」または「NG」が表示される

4. 概要・使い方・実行上の注意

pings ライブラリを使用し，指定した IP アドレスに対して ping を実行して疎通結果を表示する．反応があれば OK，なければ NG を表示する．

複数の IP アドレスやホスト名に対する一括監視も可能である．targets リストに監視対象を記述すると，各対象の疎通結果が実行日時とともに出力される．

ソースコードは第5章に掲載している．

5. ソースコード

単一ホストへの ping 実行

ping を実行
反応があれば OK を表示，反応がなければ NG を表示

import pings

def myping(ipaddr):
    return pings.Ping().ping(ipaddr).is_reached()

if __name__ == '__main__':
    if myping("111.222.33.44"):
        print("OK")
    else:
        print("NG")

複数ホストの一括監視

複数の IP アドレスやホスト名に対して一括で ping を実行し，それぞれの死活状態を確認する例を示す．

import pings
from datetime import datetime

targets = ["192.168.1.1", "192.168.1.2", "8.8.8.8"]
p = pings.Ping()
print("実行日時:", datetime.now().strftime("%Y-%m-%d %H:%M:%S"))
for t in targets:
    status = "OK" if p.ping(t).is_reached() else "NG"
    print(f"{t}: {status}")

6. まとめ

pings ライブラリによる ping 実行

pings ライブラリを使用し，Python から IP アドレスを指定して ping を実行できる．pings.Ping() でオブジェクトを作成し，ping メソッドで疎通確認を行う．

死活監視の判定

is_reached() メソッドにより，対象への到達可否を判定する．反応があれば OK，なければ NG として結果を表示する．

複数ホストの一括監視

targets リストに監視対象の IP アドレスまたはホスト名を記述し，順に ping を実行することで複数対象を一括監視できる．

実行日時の記録

datetime モジュールにより実行日時を出力する．死活監視のログとして日時を記録する際に利用する．

実行時の権限

Windows では管理者権限のコマンドプロンプトからライブラリのインストールを行う．