ColdFusion MX
目 次 > ColdFusion MX アプリケーションの開発 > エラーの処理 > cflog タグを使用したエラーのロギング O

cflog タグを使用したエラーのロギング

『ColdFusion MX の設定と管理』で説明されているように、ColdFusion には、ログファイルの生成、管理、および表示のための拡張機能が用意されています。また、ColdFusion ログにエントリを追加する cflog タグもあります。

デフォルトのエラーハンドラを使用する場合に、ColdFusion はデフォルトのログにエラーを自動的にロギングします。その他の場合には、エラー処理コード内で cflog タグを使用してログエントリを生成する必要があります。

cflog タグを使用すると、次の情報を指定できます。

たとえば、次のページのように、例外エラー処理ページで cflog タグを使用してエラー情報をアプリケーション固有のログファイルにロギングすることができます。

<html>
<head>
<title>製品 - エラー</title>
</head>
<body>

<h2>申し訳ございません。</h2>

<p>このページのリクエスト時にエラーが発生しました。
エラーはロギングされました。問題を解決するために最善を尽くします。
ご迷惑をおかけして誠に申し訳ございません。</p>

<cflog type="Error"
      file="myapp_errors"
      text="Exception error -- 
         例外タイプ :#error.type#
         テンプレート :#error.template#,
         リモートアドレス : #error.remoteAddress#, 
         HTTP リファレンス :#error.HTTPReferer#
         診断 : #error.diagnostics#">

</body>
</html>

コードの確認

次の表で、前述のコード (太字部分) について説明します。

コード

説明

 
<cflog     type="Error"
  file="myapp_errors"
  text="Exception error
  例外タイプ :#Error.type#
  テンプレート :#Error.template#,
  リモートアドレス : #Error.remoteAddress#,
  HTTP リファレンス :#error.HTTPReferer#
  診断 : #Error.diagnostics#">

このページが処理されると、ColdFusion ログディレクトリ内の myapp_errors.log ファイルにエントリをロギングします。エントリをエラーメッセージとして識別し、例外タイプを含んでいるエラーメッセージ、エラーを発生させているページのパス、そのページを呼び出したリモートアドレス、およびこのエラーの診断メッセージを含めます。

実在しないカスタムタグを呼び出そうとし、このページがエラーを検出した場合には、次のようなログファイルエントリが生成されます。

"Error","web-13","12/19/01","11:29:07",MYAPP,"Exception error --
      例外タイプ :coldfusion.runtime.CfErrorWrapper
      テンプレート :/MYStuff/NeoDocs/exceptiontest.cfm,
      リモートアドレス :  127.0.0.1, 
      HTTP リファレンス : 
      診断 : Cannot find CFML template for custom tag testCase.Cannot 
      CFML template for custom tag testCase.ColdFusion attempted looking 
      in the tree of installed custom tags but did not find a custom tag with 
      this name."

このテキストには、カンマで区切られた、次のエントリのリストが含まれています。
目 次 > ColdFusion MX アプリケーションの開発 > エラーの処理 > cflog タグを使用したエラーのロギング O