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

環境情報

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

または

以下のような処理の流れを想定しています。

• ・指定の URL にリクエストを送信し、応答がなければエラーを表示
• ・HTTP のステータスコードが200以外の場合にはエラーを表示
• ・上記以外の場合には正常であると表示

まず WEB サーバーにリクエストを送信する方法ですが、以下のような Kompira Enterprise の組み込み関数 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() は様々な場面で使用することができます。