> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ログとイベント追跡

> ログとイベント追跡を使って、Octoparseタスクの実行状況、失敗原因、抽出挙動を確認します。

ログとイベント追跡は、タスク実行中に何が起きたかを理解するための機能です。実行失敗、不完全なデータ、予期しない停止、ページネーションの問題、ログインの問題、クラウド抽出の挙動を調査できます。

## ログの用途

ログは、次のような疑問の確認に役立ちます。

* タスクは正常に開始したか
* どのステップで失敗したか
* ページは正しく読み込まれたか
* ページネーションは想定どおり続いたか
* ログインまたはCookieの状態が欠けていなかったか
* タスクはレコードを抽出したか
* クラウド実行はなぜ停止したか

## ログを見るタイミング

次のような場合にログを確認します。

| 状況            | ログが役立つ理由                 |
| ------------- | ------------------------ |
| タスクが失敗した      | 失敗したステップやページを特定できます      |
| データが欠けている     | 抽出フィールドに到達したか確認できます      |
| 想定よりレコード数が少ない | ページネーション、ループ、停止条件を確認できます |
| クラウド実行の挙動が異なる | クラウドでの挙動をローカルテストと比較できます  |
| スケジュール実行が停止した | 実行履歴と失敗したタイミングを確認できます    |

## トラブルシューティングの流れ

<Steps>
  <Step title="失敗または不完全な実行を探す">
    タスクの実行履歴を開き、調査したい実行を選択します。
  </Step>

  <Step title="タイムラインを確認する">
    最初の警告、失敗したアクション、予期しない停止を探します。
  </Step>

  <Step title="ワークフローと比較する">
    ログイベントを、タスク内の対応するアクションと照合します。
  </Step>

  <Step title="タスクを調整する">
    必要に応じて、待機、セレクター、ページネーション、ログイン、Cookie、[プロキシ](/docs/jp/platform/proxy)、抽出設定を更新します。
  </Step>

  <Step title="サンプルを再実行する">
    スケジュール設定や大規模実行の前に、更新したワークフローをテストします。
  </Step>
</Steps>

## 実行問題の一般的な原因

* ページ構造が変わった
* 要素セレクターが一致しなくなった
* コンテンツの読み込みが遅すぎた
* ログインセッションが期限切れになった
* CAPTCHAまたはブロックが表示された
* ページネーションが続かなかった
* クラウド環境がローカルテストと異なる
* すべてのページに到達する前にタスクが停止した

## ベストプラクティス

* タスクを大きく変更した後はログを確認します。
* 成功した実行を比較用として残しておきます。
* ページ挙動を直接観察する必要がある場合は、[ローカルでテスト](/docs/jp/platform/local-vs-cloud)します。
* スケジュール実行や無人実行が失敗した場合は、クラウドログを使用します。
* データ件数やエクスポートステータスと組み合わせて、タスクの健全性を確認します。

<Note>
  ログは実行中に起きたことを示しますが、Webサイト側の挙動が変わった理由まですべて説明できるとは限りません。複雑なサイトでは、ローカルテスト、クラウドログ、対象ページの構造をあわせて確認してください。
</Note>