今回はWebサーバーが公開するURLにリクエストを送り、死活監視を行うジョブフローを作成します。

環境情報

本稿は、以下の環境で検証しています。

処理の流れとしては以下のような想定です。
* 指定のURLにリクエストを送信し、応答がなければエラーを表示
* HTTPのステータスコードが200以外の場合にはエラーを表示
* 上記以外の場合には正常であると表示

まずWEBサーバーにリクエストを送信する方法ですが、Kompiraの組み込み関数urlopen()を使います。引数で指定した url に対して、HTTPリクエストを送信し、結果を取得します。

urlopen(url [, user, password, data, params, files, timeout, encode, http_method, verify, 
quiet, headers, cookies, charset, binary, proxies])

[ ] 内の引数は省略可能です。各引数の意味は以下の通りです。

urlopen()でアクセスに成功した場合の結果は、以下の要素を持つ辞書で返されます。codeには HTTP のステータスコードが、bodyにはレスポンスの内容が格納されています。

これを用いて、Webサーバーにリクエストを送信するのは以下のようなコードになります。

|url = "http://www.kompira.jp/"|

urlopen(url)

続いて結果を判断して表示の切り替えを行います。
条件分岐はifブロックを用いて行います。

{ if (条件式) |
  then: (条件が真の場合の処理)
  else: (条件が偽の場合の処理)
}

urlopen()を実行した際、リクエストの送信に成功した場合には$STATUSが0に、失敗した場合は$STATUSが0以外になります。

よって、まずはurlopen()自体が成功したかどうかで分岐する処理をします。

|url = "http://www.kompira.jp/"|

urlopen(url) =>
{ if $STATUS != 0 | 
  then: print("異常が検出されました")
  else: print("正常です")
}

具体的に失敗する場合は、urlopen()に指定したホスト名やIPアドレスが間違っていたり、ネットワークが接続できなかったということが原因であると考えられます。

さて、今回は「HTTPの応答コードが200以外の場合にはエラーを表示」としたいので、このコードだけでは十分ではありません。

ここにHTTPリクエストのステータスコードが200であるかどうかを確認する処理を追加してみましょう。

ifブロックで追加条件を指定する場合にはelif節を用います。

{ if (条件式) |
  then: (条件が真の場合の処理)
  elif  (追加条件式) : (条件が偽、かつ追加条件が真の場合の処理)
  else: (条件が偽、かつ追加条件も偽の場合の処理)
}

これを用いて、HTTPのステータスコードが200以外の場合は異常とします。urlopen()の結果は$RESULTに辞書型で格納されており、”code”というキーで参照できます。

|url = "http://www.kompira.jp/"|

urlopen(url) =>
{ if $STATUS != 0 | 
  then: print("異常が検出されました")
  elif $RESULT.code != 200 : print("異常が検出されました。エラーコードは %{code}" % $RESULT)
  else: print("正常です")
}

HTTPリクエストに対する応答が正常でなかったときは、$RESULT.codeが200以外となります。

例えば、存在しないURLパスを指定してしまったり、Webサーバー側で何らかのトラブルが発生している場合等があります。

今回の例ではHTTP GETリクエストを送信するのにurlopen()を使用しました。
上記ではレスポンス中のステータスコードを確認するだけにとどまっていますが、サイトのコンテンツ内容の取得はもちろん、ファイルのダウンロードや、外部のREST API呼び出しなど、urlopen()は様々な場面で使用することができます。