ログの理解

ログの理解

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

メモこのヘルプページは、Creator 6をご利用のユーザー向けです。旧バージョン(Creator 5)をご利用の場合は、こちらをクリックしてください。ご利用中のCreatorのバージョンをご確認ください。
概要
ログを使用すると、Creatorのアプリでユーザーのアクセス活動や処理の実行状況を監視できます。データに関する操作、ワークフロー、呼び出されたAPI、バックグラウンド処理を確認できるため、実行経路の追跡、失敗の特定、問題のトラブルシューティングやデバッグを効果的に行えます。
利用条件
  1. ログは、Creatorのすべてのプランで利用できます。
  2. 特権管理者と管理者は、Creatorでログを表示、検索できます。

1. 概要

Zoho Creatorのログでは、アプリ内で発生する活動を一元的に確認できます。アプリ内でのユーザーのアクセス活動の監査や、アプリの実行状況の分析に役立ち、リアルタイムのパフォーマンスやデバッグに関する詳細な情報を得られます。

次の2つのタブを併用することで、Creatorアカウント内の活動を包括的に把握できます:
  1. [アクセスログ] - データの表示、フォームの送信、ブループリントの遷移の実行、独自のAPIの実行など、アプリ内でのユーザーの操作を記録します。アクセスログの各エントリーには、ユーザーの端末のIPアドレスも自動的に記録されます。
  2. [アプリログ] - ワークフロー、Delugeタスク、API、ページスクリプトなど、システムによる処理の実行状況を記録します。
これらのログを組み合わせることで、処理を最初から最後まで追跡でき、異なる環境にまたがる場合でも、問題のデバッグやユーザー操作の監査を容易に行えます。各ログエントリーは追加されてから2か月間保持され、その後完全に削除されます。

1.1. ダッシュボードの操作

ログダッシュボードには、ログの閲覧や管理に役立つ次のオプションがあります:
  1. [タイムゾーン]():ログのタイムスタンプの表示に使用するタイムゾーンを変更します。
  2. [期間フィルター]():[アクセスログ]と[アプリログ]に表示するログの日時の範囲を設定します。
  3. [並べ替え]():現在のログタブのログを、古い順または新しい順に並べ替えます。
  4. [検索]():検索パネルを開き、現在のログタブのログエントリーを絞り込みます。検索オプションは、アクセスログとアプリログで異なります。
  5. [更新]():現在のログタブの最新のエントリーを再読み込みします。
  6. 目のアイコン():ログエントリーの表に追加で表示する列を選択できます。
  7. [操作]():ログエントリーに関連して実行できる操作を表示します。管理者は、アクセスログから関連するアプリログに移動でき、その逆の移動も可能です。

2. アクセスログ

アクセスログには、アプリのライブモードでユーザーが行った活動が記録されます。これらのログでは、フォーム、レポート、ページなどのコンポーネントに対するユーザーの操作と、それによって実行されるワークフローを追跡できます。ユーザーの行動の追跡、操作の監査、個々の操作で発生した失敗の特定に特に役立ちます。
列
説明
記録される値
タイムスタンプ
操作が行われた日時
日時の値
活動
ユーザーが実行した、またはユーザーの操作によって開始された具体的な操作

コンポーネントごとに、次のアプリ内の操作がアクセスログに記録されます:

フォーム

  • access_form

  • add_record

  • click_button_in_stateless_form

レポート

  • view_report

  • view_record

  • edit_record

  • delete_record

  • duplicate_record

  • export_report

  • import_report

  • print_report

  • add_record_comment

  • delete_record_comment

  • trigger_custom_action_in_report

ページ

  • view_page

  • click_actionable_page_elements

  • print_page

  • export_page

フォームワークフロー

  • enter_field_input

  • execute_form_workflow_on_load

  • add_subform_row

  • delete_subform_row

スケジュールワークフロー

  • execute_form_schedule

  • execute_custom_schedule

承認フロー

  • approve_record

  • reject_record

  • recall_record

決済ワークフロー

  • payment_callback

ブループリント

  • trigger_blueprint_transition

バッチ処理ワークフロー

  • execute_pre_batch_action

  • execute_batch_workflow

  • execute_post_batch_action

編集モードでのスクリプト実行

  • execute_script_in_edit_mode

API

  • edit_record_by_id

  • delete_record_by_id

  • get_record

  • get_record_by_id

  • upload_file

  • upload_file_to_subform

  • download_file

  • download_file_from_subform

  • get_fields

  • get_forms

  • get_reports

  • get_pages

  • get_sections

  • get_applications

  • create_bulk_read_job

  • get_bulk_read_job_status

  • download_bulk_read_result

  • create_bulk_insert_job

  • get_bulk_insert_job_status

  • download_bulk_insert_result

  • upload_file_to_bulk_insert_job

  • start_abort_bulk_insert_job

  • execute_custom_api

アプリのリンク名
操作が行われたアプリのリンク名
-
コンポーネントのリンク名
操作に関連するコンポーネントのリンク名
フォーム、レポート、ページ、独自のAPIなどのリンク名
タグ
ログエントリー内の特定の活動にのみ適用される追加情報
  1. form
  2. field
  3. subform_field
  4. form_button
  5. report
  6. report_button
  7. page_element
  8. transition
  9. approval_level
  10. job_id
データID
関連するデータのID
システムによって生成されたデータID
環境
操作が行われた環境
  1. development
  2. stage
  3. production
ユーザーの種類
操作を実行したユーザーの種類
  1. account_users
  2. public_users
  3. portal_users
所要時間
操作の完了にかかった時間
ミリ秒、秒、分
トリガーの種類
操作が実行されたきっかけ
  1. user_action - ユーザーがアプリ内で手動で実行した操作。
  2. api - REST APIや独自のAPIのタスクなど、自動化されたAPI要求によって実行されたアプリの操作。
  3. schedule - スケジュールワークフローやスケジュール設定されたバッチ処理ワークフローなど、あらかじめ予定された処理。
  4. edit_mode_action - 構築中やテスト中のスクリプト実行など、アプリの編集モードから実行された操作。
ユーザーのメールアドレス
操作を実行したユーザーのメールアドレス
有効なメールアドレス
エラーコード
要求の処理中にシステムまたは処理に関与する外部サービスで発生した、具体的なエラーを識別するコードです。
システムまたは外部サービスのエラーコード
エラーメッセージ
発生したエラーの詳細を示す、処理結果の簡単な説明です。
-
IPアドレス
操作を実行したユーザーの端末のIPアドレス
IPv4またはIPv6の値
コンポーネントの種類
操作に関連するコンポーネントの種類
  1. form
  2. report
  3. page
  4. form_schedule
  5. custom_schedule
  6. approval_workflow
  7. payment_workflow
  8. blueprint
  9. batch_workflow
  10. report_workflow
  11. function
  12. custom_api
HTTPステータスコード
HTTPステータスコードは要求の処理結果を示し、正常に処理されたか、特定のエラーが発生したかを表します。
  1. 200 - ok
  2. 201 - created
  3. 400 - bad_request
  4. 401 - authorization_error
  5. 403 - forbidden
  6. 404 - not_found
  7. 405 - method_not_allowed
  8. 408 - request_timeout
  9. 409 - conflict
  10. 422 - unprocessable_entity
  11. 429 - too_many_requests
  12. 500 - internal_server_error
  13. 501 - not_implemented
  14. 502 - bad_gateway
  15. 503 - service_unavailable
  16. 504 - gateway_timeout

2.1. アクセスログの詳細の表示

アクセスログの項目をクリックすると、次の2つのタブが表示される場合があります:
  1. [アクセスログの概要] - 対象の活動の内訳を整理して確認できる詳細画面です。この画面は複数のセクションに分かれており、該当するアクセスログに関連するすべての情報が各セクションに表示されます:
    1. 概要:タイムスタンプ、活動、トリガーの種類、関連するデータのIDなどの主要な情報が表示されます。
    2. コンポーネントの詳細:アプリのリンク名、コンポーネントのリンク名、コンポーネントの種類が表示されます。アプリが環境に追加されている場合は、活動が行われた環境も表示されます。また、表示されている活動に該当する場合は、詳しい情報を示すタグも表示されます。
    3. ユーザーの詳細:操作を実行したユーザーを特定できるよう、ユーザーの名前、メールアドレス、ユーザーの種類、役割、権限が表示されます。
    4. 実行の詳細:所要時間、HTTPステータス、エラーコード、エラーメッセージ、そのログ項目を識別する一意のアクセスログIDなど、活動の結果が表示されます。
    5. 要求の詳細:端末の種類やIPアドレスなど、技術的な情報が表示されます。
    6. 追加の詳細:実行された活動に固有の関連情報が表示されます。たとえば、エクスポートの場合はレポートの条件、エクスポート形式、データの件数が表示され、API呼び出しの場合は使用されたメソッドが表示されます。
  2. [ワークフローログ] - アクセスログの項目に対応する操作によってワークフローが実行された場合、このタブに実行に伴うアプリのログの一覧が表示されます。
このような詳細情報を通じて、ユーザーの操作と、その操作によって実行されたコンポーネントの動作を関連付け、的確にトラブルシューティングできます。

アクセスログのエントリーから関連するアプリログへの移動:

1. 対象のアクセスログのエントリーにカーソルを合わせ、エントリーの末尾にある三点リーダーアイコン()をクリックします。
2. [アプリログを表示]をクリックすると、そのアクセスログのエントリーに関連するアプリログに移動します。

2.2. 特定のログで表示される追加情報

一部のアクセスログの詳細表示には、標準のセクションに加えて、実行した操作に関する詳細情報を示す新しいセクションが表示されます。
ログの種類
ラベル
表示される値
export_report
レポートの条件 - エクスポート時にレポートに適用されたフィルター条件
-

電子的保護対象医療情報の項目 - エクスポートに含まれる、電子的保護対象医療情報を格納した項目
項目のリンク名

個人情報の項目 - エクスポートに含まれる、個人情報を格納した項目
項目のリンク名

エクスポート形式 - エクスポートされたデータのファイル形式
.xlsx、.pdf、.html、.xml、.json、.csv、.tsvなどのファイル形式

データ件数 - レポートからエクスポートされたデータの件数
-
import_report
ファイル名 - インポートするファイルの名前
-

ファイルの種類 - インポートされたデータのファイル形式
.xls、.xlsx、.xlsm、.csv、.tsv、.ods、.mdb、.accdb、.json、.numbersのファイル形式

成功件数 - インポートされたデータの件数
-

失敗件数 - インポートに失敗したデータの件数
-
api
メソッド - API要求で使用されたHTTPメソッド
GET、POST、PATCH、DELETE

サービス名 - API呼び出しに関連する内部または外部のサービス
サービス名
payment_callback
取引ID - 決済取引の一意のID
Zoho Checkoutで生成された取引IDの値

決済ゲートウェイ - 決済処理に使用された外部ゲートウェイ
外部決済ゲートウェイ名
  1. create_bulk_insert_job
  2. upload_file_to_bulk_insert_job
  3. start_abort_bulk_insert_job
データの合計件数 - 処理のために送信されたデータの合計件数
-

処理に成功したデータ - 処理されたデータの件数
-

処理に失敗したデータ - 処理に失敗したデータの件数
-

未処理のデータ - 処理されなかったデータの件数
-
execute_batch_workflow
成功したバッチ数 - バッチ処理ワークフローで完了したバッチの数
-

失敗したバッチ数 - バッチ処理ワークフローで失敗したバッチの数
-

2.3. アクセスログの検索と絞り込み

特定のアクセスログを見つけるには、[ログを検索]パネルのフィルターを使用します:
  1. Zoho Creatorのホームページの左側のペインで[運用]に移動し、アプリセクションの[ログ]をクリックします。初期状態では、[アクセスログ]タブが開きます。
  2. ツールバーの検索アイコン()をクリックします。
  3. 表示されたログの検索パネルで必要な検索フィルターを設定し、[検索]をクリックします。
かんたん表示のアクセスログの一覧が絞り込み結果に更新され、適用されたフィルターが表の上にチップとして表示されます。
検索フィルターを削除するには:
  1. 適用されたフィルターを削除するには、ログの一覧表の上に表示されているフィルターチップのXアイコン()をクリックします。
利用可能なフィルター:
概要
コンポーネントの詳細
ユーザーの詳細
実行の詳細
概要
  1. [活動]
  2. [トリガーの種類]
  3. [データID]

コンポーネントの詳細
  1. [アプリのリンク名]
  2. [環境]
  3. [コンポーネントの種類]
  4. [コンポーネントのリンク名]
  5. [タグ]

ユーザーの詳細
  1. [ユーザーのメールアドレス]
  2. [ユーザーの種類]
  3. [IPアドレス]
実行の詳細
  1. [所要時間]:条件を選択し、値を入力して単位を選択します。
  2. [HTTPステータスコード]
  3. [エラーコード]
  4. [アクセスログID]
アクセスログの検索時の注意点
  1. [トリガーの種類]:選択した活動に該当するトリガーの種類のみが表示されます。
  2. [コンポーネントの種類]:選択したトリガーの種類に該当するコンポーネントの種類のみが表示されます。
  3. [コンポーネントのリンク名]:最初にアプリのリンク名とコンポーネントの種類を選択します。そのアプリ内の、選択した種類のコンポーネントのみが選択肢として表示されます。
  4. [タグ]:最初にコンポーネントのリンク名を選択します。利用可能なタグは、選択したアプリのリンク名とコンポーネントのリンク名によって異なります。
  5. レポートのボタンタグ:ボタンがクリックされたレポートの指定が必須です。このタグを選択すると、レポートの行が自動的に追加されます。レポートのリンク名を入力して続行します。

3. アプリのログ

アプリのログには、エンドユーザーのアクセス活動や自動処理をきっかけに実行されたシステム処理が記録されます。ワークフロー、Delugeスクリプト、外部連携などについて、より詳細な情報を提供します。これらのログは主に、エラーのデバッグ、実行フローの分析、バックグラウンドでの各種処理の実行状況の把握に使用されます。
列
説明
取り得る値
タイムスタンプ
実行日時
-
ワークフローのリンク名
起動されたワークフローのリンク名
ワークフローのリンク名
アプリのリンク名
処理が実行されたアプリのリンク名
アプリのリンク名
コンポーネントのリンク名
実行に関連するコンポーネントのリンク名
フォーム、レポート、またはページのリンク名
カテゴリー
アプリのログに記録されるシステム実行の大分類
  1. workflow - フォームイベント、スケジュール、承認など、アプリ内の操作やイベントによって起動されるワークフローの実行。
  2. task - API呼び出し、SMS、メールなど、ワークフロー内の個々のタスクの実行。
サブカテゴリー
カテゴリー内で実行の種類をさらに細かく分ける分類
2つのログカテゴリーには、次のコンポーネントが含まれます:
  1. workflow - form_workflow、schedule_workflow、approval_workflow、payment_workflow、report_workflow、blueprint、batch_workflow、function、page_script
  2. task - web_data、notification
イベント
実行されたワークフローイベントまたはDelugeタスクの名前
ワークフロー名またはDelugeタスク:
  1. on_create_form_load
  2. on_create_field_input
  3. on_create_form_submit_validation
  4. on_create_form_submit_success
  5. on_create_addition_of_a_row
  6. on_create_deletion_of_a_row
  7. on_edit_form_load
  8. on_edit_field_input
  9. on_edit_form_submit_validation
  10. on_edit_form_submit_success
  11. on_edit_field_update
  12. on_edit_addition_of_a_row
  13. on_edit_deletion_of_a_row
  14. on_create_edit_form_load
  15. on_create_edit_field_input
  16. on_create_edit_form_submit_validation
  17. on_create_edit_form_submit_success
  18. on_create_edit_addition_of_a_row
  19. on_create_edit_deletion_of_a_row
  20. on_delete_record_delete_validation
  21. on_delete_record_delete_success
  22. form_schedule
  23. custom_schedule
  24. approve_record
  25. reject_record
  26. click_report_button
  27. successful_payment
  28. failed_payment
  29. trigger_blueprint_transition
  30. click_button_in_stateless_form
  31. render_html_snippet
  32. render_zml_snippet
  33. integration_task
  34. invoke_url
  35. invoke_api
  36. sms
  37. email
  38. execute_page_script
  39. initiate_batch_workflow
  40. execute_batch_workflow
  41. successful_batch_workflow
  42. failed_batch_workflow

  43. execute_function

ステータス
要求が正常に処理されたか、実行に失敗したかを示します。
  1. success
  2. failure
実行時間 実行にかかった時間 ミリ秒、秒、分
サービス
処理の実行元または実行先のサービス
イベントに関係する外部または内部サービスの名前やWebアドレス。
メッセージ
要求が正常に完了したことや、発生したエラーの詳細など、結果に関する簡単な説明。
情報メッセージまたはエラーメッセージ
エラーコード
要求の処理中に、システムまたは実行に関係する外部サービスで発生した具体的なエラーを識別するコード。
内部または外部のエラーコード
データID
関連するデータのID
システムで生成されたデータID
コンポーネントの種類
処理に関係するコンポーネントの種類
  1. form
  2. page
  3. form_schedule
  4. custom_schedule
  5. approval_workflow
  6. payment_workflow
  7. blueprint
  8. batch_workflow
  9. report_workflow
  10. function
  11. custom_api

3.1. アプリのログの詳細の表示

アプリのログのエントリーをクリックすると詳細画面が開き、アクセス操作やシステムによって起動されたイベントによって実行された処理を詳しく確認できます。この画面には、次の2つのタブがあります:
  1. [概要]
    このタブには、選択したログの概要が表示され、実行単位の詳細を整理された形式で確認できます。
    1. 概要:タイムスタンプ、実行時間、カテゴリー、サブカテゴリー、実行ステータス、エラーコード、メッセージなどの主要な情報に加え、対象の実行をいつでも特定できる一意のアプリのログIDが表示されます。実行結果をすばやく把握できます。
    2. コンポーネントの詳細:実行されたイベントまたはDelugeタスクと、実行に関係するアプリ、ワークフロー、コンポーネントの情報が表示されます。また、該当する場合は、影響を受けたデータや、呼び出された外部サービスまたはドメインも表示されます。
    3. 実行の詳細:実行時の状況を把握し、関係するワークフローやプロセスを正確に特定するための詳細情報が表示されます。このセクションには、実行ステータス、エラーコード、このログの記録を引き起こした処理に関連するアクセスログIDなどの情報が含まれます。
  2. [タスクのログ]
    このタブには、選択したワークフローの一部として実行されたすべての個別タスクが一覧表示されます。各エントリーには、ワークフロー内の特定の手順と、その実行ステータスや関連する詳細が表示されます。これにより、ワークフローの実行を細かく追跡し、失敗した箇所を正確に特定できます。

アプリのログのエントリーから関連するアクセスログへの移動:

  1. 対象のアプリのログのエントリーにカーソルを合わせ、エントリーの末尾にある三点リーダーアイコン()をクリックします。
  2. [アクセスログを表示]をクリックすると、そのアプリのログのエントリーに関連するアクセスログに移動します。
また、アプリログの該当エントリーの詳細表示で、右上の[アクセスログを表示]ボタンをクリックして、関連するアクセスログを開くこともできます。

3.2. アプリログの検索と絞り込み

アプリログを検索するには:
  1. Zoho Creatorのホームページの左側のペインで[操作]に移動し、アプリセクションの[ログ]をクリックします。
  2. [アプリログ]タブに移動します。
  3. ツールバーの検索アイコン()をクリックします。
  4. 表示されたログを検索パネルで必要な検索フィルターを設定し、[検索]をクリックします。
かんたん表示のアプリログのエントリーが絞り込み結果に更新され、適用されたフィルターが表の上部にチップとして表示されます。
検索フィルターを削除するには:
ログエントリーの表の上部に表示されているフィルターチップのXアイコン()をクリックすると、適用されたフィルターを削除できます。
利用可能なフィルター:
概要
コンポーネントの詳細
実行の詳細
概要
  1. イベント
  2. カテゴリー
  3. サブカテゴリー
  4. データID
  5. サービス
コンポーネントの詳細
  1. アプリのリンク名
  2. 環境
  3. コンポーネントの種類
  4. コンポーネントのリンク名
  5. ワークフローのリンク名
実行の詳細
  1. 所要時間:条件を選択し、値を入力して、単位を選択します。
  2. ステータス
  3. エラーコード
  4. メッセージ
  5. アクセスログID

アプリログの検索時の留意事項
  1. カテゴリー:選択したイベントに該当するカテゴリーのみが表示されます。
  2. サブカテゴリー:選択したカテゴリーに該当するサブカテゴリーのみが表示されます。
  3. コンポーネントの種類:選択したサブカテゴリーに該当するコンポーネントの種類のみが表示されます。
  4. ワークフローのリンク名:最初にサブカテゴリーとアプリを選択します。選択したアプリ内で、選択したサブカテゴリーに属するワークフローのみが選択肢として表示されます。
メモ:このフィルターは、page_script、web_data、notificationのサブカテゴリーでは使用できません。

4. 留意事項

ログの保持とストレージ
  1. すべてのプランで、Creatorアカウントのログの保持期間は2か月です。
  2. ログは、アカウントの監査とログのストレージの使用量に加算されます。使用量は、[支払い管理]→[使用状況の詳細]で確認できます。このストレージがいっぱいになるとログの記録が一時停止し、新しい活動やイベントは記録されなくなります。
プライバシー
  1. 初期設定では、アプリ内で操作を実行したユーザーのIPアドレスがログに記録されます。そのため、アプリの使用中にIPアドレス、ユーザー情報、その他のアクセス情報などのデータが収集されることを、Creatorアカウントのすべてのユーザーに周知してください。
ログへのアクセス
  1. アプリログから関連するアクセスログを直接表示して、アプリログが記録されたきっかけをたどることができます。
  2. アクセスログのエントリーから関連するアプリログを直接表示して、そのアクセスによって実行されたワークフローをたどることができます。

5. 関連トピック

  1. 操作履歴について
次のステップ
次のステップ
誰が、いつ、何を変更したかなど、アプリのデータへの変更を追跡できるZoho Creatorの操作履歴について確認しましょう。