EAのログ出力を増やしたい時に整理すること｜Experts・Journal・CSV・通知

EAを使っていると、「なぜ注文しなかったのか」「なぜ決済されなかったのか」「どの条件で停止したのか」「通知が送られたのか」を後から確認したい場面があります。

そのような時に役立つのが、Expertsログ、Journalログ、CSV出力、通知ログなどの記録です。

ただし、ログは増やせばよいというものではありません。出力が多すぎると、重要な情報が埋もれたり、バックテストが重くなったり、長時間稼働時にファイルが大きくなったりする場合があります。

また、ログには口座番号、Webhook URL、APIキー、トークン、認証情報など、公開すべきではない情報が含まれる可能性があります。ログ出力を増やす場合は、何を出すかだけでなく、何を出さないかも整理する必要があります。

この記事では、EAのログ出力を増やしたい時に、開発依頼前に整理したいExpertsログ、Journalログ、CSV出力、通知ログ、出力タイミング、ログ量、機密情報、検証条件をまとめます。

なお、この記事はEA改修や開発依頼前の技術確認を目的とした内容です。特定の売買手法、推奨エントリー、推奨決済、推奨ロット、利益保証を行うものではありません。

この記事で確認すること

EAのログ出力を増やす目的

EAのログ出力を増やす目的は、EAの挙動を後から確認できるようにすることです。

たとえば、EAが注文しない場合、エントリー条件が未成立なのか、スプレッドで止まったのか、時間帯で止まったのか、自動売買が許可されていないのか、証拠金不足なのかをログで切り分けます。

依頼前には、「何を確認するためにログを増やしたいのか」を明確にしてください。

ExpertsログとJournalログの違い

EAのログ確認では、ExpertsログとJournalログを分けて見ることが重要です。

Expertsログは、EA側が出力する動作記録です。Journalログは、MT4/MT5側の操作、注文、接続、プラットフォーム状態を含む記録です。

「EAが動かない」という相談では、Expertsログだけでなく、Journalログも必要になる場合があります。

どの処理にログを追加するか整理する

ログ出力を増やす場合は、EA全体に無差別にログを追加するのではなく、処理の責務ごとに分けて整理します。

signal、execution、risk、exit、notification、external control、manual、UI などを分けておくと、後から原因を追いやすくなります。

依頼時には、「注文しない理由を知りたい」「決済しない理由を知りたい」「通知失敗を知りたい」など、確認したい目的ごとにログ分類を整理してください。

ログレベルを整理する

ログ出力には、通常運用で見るログと、検証時だけ見る詳細ログがあります。

すべての詳細ログを常時出すと、ログが多くなりすぎて確認しづらくなります。そのため、ログレベルや出力モードを分けることが重要です。

開発中は詳細ログ、本番運用ではコンパクトログというように、用途ごとに切り替えられる設計にすると扱いやすくなります。

CSV出力で整理すること

CSV出力は、ログや履歴を表形式で保存したい場合に使います。

Expertsログは確認しやすい一方で、長期集計やExcelでの分析には向かない場合があります。CSV出力を追加すると、取引履歴、判定結果、日次集計、エラー履歴などを後から整理しやすくなります。

CSV出力を依頼する場合は、何を保存するかだけでなく、どの形式で、どの頻度で、どのくらい保存するかを整理してください。

CSVログ出力の設計であわせて確認したいページ

EAのログ出力を増やす場合は、ExpertsログやJournalログだけでなく、CSVへ何を残すか、どの保存先を使うか、どの粒度で出力するかも整理しておくと確認しやすくなります。

通知ログで整理すること

Discord通知やメール通知を使うEAでは、通知が成功したか、失敗したかをログに残すことが重要です。

通知が届かない場合、EAが通知を送っていないのか、WebRequestが失敗したのか、外部サービス側で拒否されたのかを切り分ける必要があります。

通知ログには、Webhook URLやトークンをそのまま出さないようにしてください。

ログを出しすぎるリスク

ログは不具合調査に役立ちますが、出しすぎると逆に問題になる場合があります。

特に、OnTickごとに詳細ログを出すEAでは、バックテストが遅くなったり、Expertsログがすぐに大量になったり、重要なエラーが見つけにくくなることがあります。

ログ出力を増やす場合は、検証に必要なログと、本番運用に残すログを分けて設計することが重要です。

機密情報をログに出さない

ログには、後から確認するための情報を残しますが、すべてをそのまま出してよいわけではありません。

口座番号、認証キー、APIキー、Webhook URL、Google Sheetsのトークン、外部URL、個人情報に近い内容は、ログへ出す場合にマスクが必要です。

問い合わせ時にログを共有する場合も、機密情報が含まれていないか確認してください。

ログ出力のON/OFFを整理する

ログ出力は、必要に応じてON/OFFできるようにしておくと便利です。

すべてのログを1つのON/OFFで管理するのではなく、カテゴリごとに切り替えられると、不具合調査や本番運用で使いやすくなります。

依頼前には、どのログを常時ONにしたいか、どのログは検証時だけONにしたいかを整理してください。

バックテスト用ログと実運用ログを分ける

バックテストでは、短時間に大量の判定が行われるため、ログを出しすぎると非常に重くなる場合があります。

そのため、バックテストでは要点だけを出すCOMPACTログ、本番運用ではエラーや主要イベントだけを出すログ、開発検証では詳細ログというように分けると扱いやすくなります。

ログ方針は、AdminDevとUserLiveで分けておくと、開発・検証・配布時の混乱を防ぎやすくなります。

依頼前に用意するとよい資料

ログ出力の追加や強化を依頼する場合は、現在のログ、確認したい内容、出力したい項目、出力先を整理します。

依頼前チェック表

FAQ

EAのログ出力だけを増やせますか？

ソースコードがあり、出力したい処理箇所が確認できる場合は相談できます。ただし、ログを増やしすぎると重くなったり確認しづらくなったりするため、出力目的とログ量を整理する必要があります。

ExpertsログとJournalログは何が違いますか？

ExpertsログはEA側の出力、JournalログはMT4/MT5全体の操作・注文・接続ログです。EA内部の判定はExperts、取引許可や注文結果はJournalもあわせて確認します。

CSV出力を追加すると何が便利ですか？

取引履歴、判定結果、エラー履歴、日次集計などを表形式で確認しやすくなります。ただし、列構成、保存場所、追記方式、ファイル肥大化を事前に整理する必要があります。

ログが多すぎる場合はどうすればよいですか？

ログレベル、カテゴリ別ON/OFF、COMPACTログ、出力間隔、イベント時のみ出力などを使って、必要なログだけを出す設計にします。

通知が届かない原因もログで確認できますか？

通知ログを追加すれば、通知イベント、送信先、送信結果、HTTPステータス、エラー内容、連投防止で見送ったかを確認できる場合があります。

ex5ファイルだけでもログ出力を追加できますか？

ex5だけでは既存EAへ直接ログ出力を追加できない場合があります。通常はmq5やmqhなどのソースコードが必要です。ソースがない場合は、補助EAや外部監視ツールとして検討する場合があります。

関連ページ

EAのログ出力を増やす時は、見積依頼前の資料整理に加えて、コンパイル確認、通知、外部シート連携との関係も確認すると、ログの出力目的や出力先を整理しやすくなります。

まとめ

EAのログ出力を増やしたい場合は、単にログを多く出すのではなく、何を確認するためのログなのかを最初に整理することが重要です。

Expertsログ、Journalログ、CSV出力、通知ログは役割が異なります。注文しない理由、決済しない理由、通知失敗、外部連携失敗、パネル操作など、確認したい内容ごとにログ分類を分けてください。

また、ログ量が多すぎると、バックテストが重くなったり、重要な情報が見つけにくくなったりします。ログレベル、カテゴリ別ON/OFF、COMPACTログ、CSV出力、保存期間などを整理すると扱いやすくなります。

ログには、口座番号、Webhook URL、APIキー、トークンなどの機密情報をそのまま出さないように注意してください。依頼前には、現在のログ、確認したい内容、出力したい項目、出力先、ログ量、検証条件、ソースコードの有無をまとめておくと確認が進めやすくなります。