ログファイル

サポート問い合わせの場合は log/ フォルダ以下をすべて圧縮して送ってください

log/ 以下のログファイル

Sora は log/ ディレクトリ以下にログファイルを出力します。

Sora の運用に関係するログ

  • sora.log

    • Sora の開始、終了や問題があった場合に出力されますので、まずはこの監視をお願いいたします

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • event_webhook.log

    • event_webhook で外部に通知する処理を全て書き込みます

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • event_webhook_error.log

    • event_webhook で外部に通知が失敗した処理を書き込みます

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

Sora の内部的なログ

  • connection.log

    • 接続が切断した際にクライアントとサーバの統計情報を出力するログです

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • signaling.log

    • シグナリングでやりとりされている offer/answer/candidate/re-offer/re-answer と接続終了を 記録したログです

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • api.log

    • 一部の API 操作に関するログを出力します

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • internal.log

    • Sora が予定外の動作をしたときに出力されるログです、問題解決に必須となるログです

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • crash.log

    • Sora が予定外の動作をしたときに出力されるログです、問題解決に必須となるログです

    • ログローテーションされませんので、ログローテーションをお願いします

    • 週次ログローテーションを推奨します

  • erlang.log.<1-5>

    • サポート時に必要となるログですので、気にする必要はありません

    • 自動でログローテーションされますので、ログローテーションは不要です

    • sora foreground コマンドで起動する場合には出力されません

  • sysctl.log

    • 起動時に取得するログで、毎回上書きされます

    • sysctl -a の結実行果を記録します

    • ログローテーションは不要です

  • ulimit.log

    • 起動時に取得するログで、毎回上書きされます

    • ulimit -n の実行結果を記録します

    • ログローテーションは不要です

  • sasl-error.log

    • 起動後に何かあった場合書かれるログですが、ほとんどログが出力されることはありません

    • ログローテーションされませんので、必要あればログローテーションをお願いします

  • run_erl.log

    • 起動時にに出力されるログのため、ほとんどログが出力されることはありません

    • ログローテーションされませんので、必要あればログローテーションをお願いします

    • sora foreground コマンドで起動する場合には出力されません

  • connection-created-timeout-error/<timestamp>_<connection_id>.json

    • CONNECTION-CREATED-TIMEOUT-ERROR が sora.log に出た際の接続情報を出力します

    • クライアントと Sora との間で WebRTC が確立できなかった場合の情報です

    • ファイル名は時刻とコネクション ID の組み合わせです

  • connection_destroyed/<timesmamp>_<connection_id>.json

    • このログはサポート時にアンドキュメントな設定を有効にしてもらうことで出力されます

    • connection.destroyed ウェブフック発火時にこのログが出力されます

    • ファイル名は時刻とコネクション ID の組み合わせです

特別なログ

Sora が異常終了した際 erl_crash.dump というファイルが log/ ディレクトリに生成されます。

こちらは 必ず 保存し、送っていただけるようお願いいたします。

監視用確認目的で erl_crash.dump ログを強制的に出力させる方法

監視を行う際に実際に erl_crash.dump を生成したい場合には、 sora daemon で起動した上で、 kill -SIGUSR1 を使用して run_erl プロセスを落としてください。

$ kill -SIGUSR1 <プロセス ID>

この方法で log/ ディレクトリに erl_crash.dump が生成されます。