システムログ
ナビゲーション:設定 → システム → システムログ
システムログには、管理プログラムの動作中に発生したイベント(画像の表示、スケジュール、スリープ、エラーなど)が記録されます。問題が起きたとき、ログは原因を突き止めるための最も重要な手がかりです。テクニカルサポートからもログの提供をお願いすることがよくあります。
ページの説明
タイトルの横に「合計 N 件、約 X MB」と表示されます(容量は推定値です)。タイトルの下の 1 行は直近 24 時間の概要です:「直近 24 時間:エラー N · 警告 N」。数字はリンクで、押すと直近 24 時間のエラー(または警告)だけに絞り込みます。
右上のボタン:
| ボタン | 説明 |
|---|---|
| 全ログをダウンロード | 全ログとデバイスの状態を 1 つのファイルにまとめます。全ログのダウンロードを参照 |
| 全ログをダウンロードの横の ▼ | メニューの「ブラックボックスのインシデント」でインシデントのウィンドウを開きます。ブラックボックスのインシデントパッケージを参照 |
| 再読み込み(↻) | 一覧と概要を読み込み直し、再読み込みしたことを表示します |
ログ一覧
- 新しいものが一番上に並び、日付ごとにまとめて表示されます。日ごとに見出し(日付、曜日、その日の件数)があり、スクロールしても見出しが上に固定されるので、どの日を見ているかいつでも分かります。
- 一度にまとまった件数を読み込み、一番下までスクロールすると古い記録が自動的に読み込まれます。ボタンを押す必要はありません。
- 各行:時刻(時:分:秒)、メッセージ、操作。メッセージは途中で切られません。CMS コンポーネントの記録には先頭に「CMS ·」が付きます。
- 同じメッセージが続いたときは 1 行にまとめ、「×N」を付けます。「×N」を押すと、それぞれの発生時刻を確認できます。
- 各行の背景色がレベルを表します:
| レベル | 背景色 | 意味 |
|---|---|---|
| DEBUG | 青 | デバッグ用の詳細(本番のデバイスでは通常ありません) |
| INFO | 緑 | 一般的なイベント。例:デバイスがスリープしなかった理由 |
| WARNING | 黄 | 問題が起きたが、自動で再試行・回復した、または代わりの方法で動作している |
| ERROR | 赤 | 自動では回復できず、対応が必要。例:画像の表示に失敗 |
| CRITICAL | 紫 | 重大なエラー。例:シャットダウン前の白表示に失敗 |
- 操作:
- 目のアイコン 全文表示:レベル、完全な時刻、コピーできる全文を表示します。
- コピーのアイコン コピー:
[時刻] [レベル] [Thread] メッセージの形式でコピーし(まとめた行には「×N」が付きます)、コピーしたことを表示します。
ログの絞り込み
絞り込み条件は 1 列に並び、変更するとすぐに適用されます:
| 条件 | 説明 |
|---|---|
| レベル | 「すべて(INFO を含む)」「警告以上」「エラー以上」。**既定は「警告以上」**です。一般的なイベント(例:スリープしなかった理由)を見るときは「すべて(INFO を含む)」を選びます |
| 期間 | 「1 時間」「今日」「24 時間」「7 日」「すべて」「カスタム」。既定は「すべて」です。「カスタム」を選ぶと日時の範囲を選べます。時刻はデバイスの時刻です |
| ソース | 「App」または「CMS」。選ばなければ両方です |
| キーワード検索 | メッセージ内容と照合します(大文字小文字を区別しません)。入力後に Enter または虫眼鏡で適用します |
よく使う検索
- 概要の「エラー N」を押す:直近 24 時間のエラーを確認
- レベル「すべて(INFO を含む)」、キーワード
取消休眠:デバイスがスリープしなかった理由を確認 - レベル「警告以上」と問題が起きた期間:異常をすばやく見つける
全ログのダウンロード
テクニカルサポートに問題を報告するときは、ページ右上の「全ログをダウンロード」を押し、ダウンロードしたファイルをサポートに送ってください。自分でログを絞り込んだり整理したりする必要はありません。
- 全ログをダウンロードを押してダイアログを開きます。
- まとめてダウンロードを押し、30 秒ほど待ちます(「全ログをまとめています。30秒ほどかかります…」と表示されます)。
- ブラウザーでのダウンロードが終わったら、ファイルをテクニカルサポートに送ります。
ファイルにはデバイス上の全ログ(システム記録、App ログ、イベントパック)と現在のデバイス状態が入っており、パスワードは含まれません。画面のフィルターには左右されず、常に完全な内容です。まとめるのに失敗したときは、少し待ってもう一度お試しください。
ログの消去
ナビゲーション:設定 → システム → ログを消去
「ログを消去」はシステムログのページから「システム設定」のページに移動しました。問題を報告する前に誤って消してしまうのを防ぐためです。
- 「システム設定」でログを消去を押します。
- 確認ダイアログで、元に戻せないことを確認して確定を押します。
- クリーンアップした件数が表示されます。
クリーンアップのルール:
- 180 日を超えた記録を削除します。
- それでも約 500 MB を超えている場合は、上限を下回るまで古いものから削除します。
ログは自動ではクリーンアップされません
上記のルールは「ログを消去」を押したときだけ適用され、普段は自動で削除されません。長期間使うデバイスでは、ときどきクリーンアップすることをおすすめします。問題を報告するときは、先に全ログをダウンロードしてから消去してください。
ブラックボックスのインシデントパッケージ
端末は常に直近 10 分間のシステム記録と状態を保持しています(これが「ブラックボックス」です)。問題が起きると、発生前 10 分間、発生時、発生後最大 10 分間の内容を「インシデントパッケージ」として自動的に保存します。次のような場合です。
- プログラムがクラッシュした、または再起動を繰り返している
- ネットワークアダプターが消えた
- システムカーネルでエラーが出た
- 温度、メモリ、ストレージがしきい値を超えた
- CMS の画像が 3 回続けて更新に失敗した
- CMS コンポーネントが消えた
- ソフトウェア更新に失敗し、古いバージョンに戻された
- 工場出荷時設定へのリセットが行われた
確認とダウンロードの手順です。
- 「システムログ」ページ右上の「全ログをダウンロード」の横の ▼ を押し、ブラックボックスのインシデント を選んでウィンドウを開きます。
- 一覧に、各パッケージの「発生時刻」「トリガー」「サイズ」「状態」が表示されます。「収集中」は発生後の 10 分間がまだ終わっていないことを示し、終わると「完了」になります。
- 該当行の ダウンロード を押し、ファイルをテクニカルサポートに渡します。パッケージがないときは「インシデントはありません」と表示されます。
ウィンドウ内の「更新」で一覧を再読み込みできます。サイズ上限を超えたパッケージには「* サイズ上限を超えたため、重要度の低いメッセージから削除されています。」と表示されます。ブラックボックスに接続できないときは「ブラックボックスに接続できません(サービスが動作していません)。」と表示されます。
| 項目 | 説明 |
|---|---|
| ソフトウェア更新、工場出荷時設定へのリセット | パッケージは保持されます(リセット自体も 1 つのパッケージとして記録されます) |
| 数と容量の上限 | 最大 20 個、合計 50 MiB。超えると古いものから自動的に削除されます |
ログのアップロード
ナビゲーション:設定 → システム → ログのアップロード
オンにすると、この端末のシステムログが会社のログサーバーへ送られ、テクニカルサポートが問題をすばやく見つけられます。パスワードなどは伏せ字にしてから送信します。初期状態はオフで、オフの間は何も送信されません。
「ログのアップロード」の行でダイアログを開き、「ログのアップロード」のスイッチをオンにして、次の項目を入力し、「保存」を押します(「保存しました」と表示されます)。
| 項目 | 説明 |
|---|---|
| 送信先URL | ログサーバーのアドレス |
| 環境名 | この端末がどの環境のものかを区別するための名前 |
「接続テスト」を押すと、サーバーが受け取れるか確認できます。成功すると「テスト成功。サーバーが受け付けました」、失敗すると「テスト失敗:{理由}」と表示されます。
ダイアログと行には現在の状況が表示されます。
| 項目 | 説明 |
|---|---|
| 状態 | 「正常」:送信できています。「接続中」:接続を試みています。「接続できません」:サーバーに届かず、理由(「最後のエラー」)が表示されます |
| 最終成功時刻 | 最後に送信できた時刻。例:「たった今」「5 分前」。一度も成功していないときは「なし」 |
| 送信済み行数、省略した行数、破棄した行数 | 送信済み:サーバーに届いた行数。省略:同じサービスが短時間に大量の行を出力したとき、超えた分は送信しません(ログが埋もれないようにするため)。破棄:サーバーに長時間つながらず、装置内の一時保存がいっぱいになったため、古い行から捨てられた行数 |
サーバーに届かないとき
サーバーに一時的に届かないときは、端末がゆっくり再試行を続け、ほかの機能には影響しません。「ログのアップロード」をオフにすると、送信はすべて止まります。
注意事項
- ログの時刻はデバイスの時刻で記録されます。デバイスの時刻が正しくないと、ログの時刻も正しくなくなるため、先に時刻設定を確認してください。
- ソフトウェア更新や工場出荷時リセットの詳細な記録はここにはありません(その間は管理プログラム自体が停止しているため)。テクニカルサポートが別途確認します。
- 工場出荷時設定に戻すと、すべてのシステムログが削除されます。
テクニカルサポートへのログの提供
- 問題が起きたおおよその時刻を控えます。
- 全ログをダウンロードを押し、ダウンロードしたファイルをテクニカルサポートに送ります。
- 問題の説明と端末情報のスクリーンショットも添えてください。
関連する章:端末情報とモニタリング、トラブルシューティング