> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/monitoring/view-device-logs.md).

# デバイスログを表示

デバイス上で実行されているRoboflowサービスのログを検索、フィルタリング、ダウンロードします。

デバイスログを使うと、デバイスの実行中にRoboflowサービスの出力を確認したり、過去の出力を振り返ったりできます。

デバイスからRoboflowに送信されるログ行には、デプロイメント [クレジット](https://docs.roboflow.com/platform/billing-and-plans#credits) が消費されます。料金は [クレジットページ](https://roboflow.com/credits).

## Webアプリ

Deployment Managerでデバイスを開き、「ログ」を選択します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-54a9cefd594a894757bedbfd9a107ecc8e61e3ae%2Fenterprise-device-logs.png?alt=media" alt="Logs tab with the keyword filter, severity and service filters, Live, and the histogram"><figcaption></figcaption></figure>

### ライブログと履歴ログ

タブは「ライブ」で開き、新しい行は下部に表示されます。「ライブ」の横にある一時停止ボタンをクリックすると、新しい行の表示が止まります。再生をクリックするまで、タブには「一時停止」と表示されます。

上にスクロールすると、古い行が読み込まれます。最下部以外の場所にいる間、タブには「一時停止」と表示されます。一時停止ボタンを使っていない場合は、最下部に戻ると再び新しい行を追跡できます。

指定した期間を振り返るには、時間メニューを開き、「過去15分間」、「過去1時間」、「過去24時間」、「過去7日間」、「過去30日間」のいずれかを選択します。同じメニューには「カスタム範囲」のカレンダーもあります。期間を選択すると新しい行の表示が止まり、タブには「履歴」と表示されます。「全期間」を選ぶと、日付で絞り込まずに新しい行を追跡します。「更新」をクリックすると、同じ期間のログが再読み込みされます。「ライブに戻る」をクリックすると、再び新しい行を追跡します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-18cc1dfe218830cea346ffcd8bd94faf314bb33c%2Fdevice-logs-historical.png?alt=media" alt="Historical logs for a custom range, with Refresh and Return to Live"><figcaption></figcaption></figure>

### カスタム範囲

「カスタム範囲」で、カレンダーから開始日と終了日を選択します。「開始」と「終了」を設定し、「適用」をクリックします。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-4d549c65775165e90a0212de48104093b514335e%2Fdevice-logs-custom-range.png?alt=media" alt="Custom Range calendar with Start, End, and Apply"><figcaption></figcaption></figure>

### 検索

「キーワードでログを絞り込む」に入力すると、メッセージ本文とサービス名が検索されます。検索では大文字と小文字は区別されず、入力した文字列そのものに一致するため、スペースや句読点も検索対象になります。また、次のような文字にも `*` 特別な意味はありません。ヒストグラムにもリストと同じ検索が適用されます。ハイライト表示されるのは、入力した文字列そのものだけです。単語を1つ入力すると、その単語が出現する箇所にマークが付きます（例： `error`）。複数の単語を入力した場合は、同じ順序で連続して出現する場合にのみマークが付きます。そのため、 `error timeout` は、これらの単語が離れた位置にある行にはマークされません。引用符で囲んだフレーズは、行に引用符も含まれている場合にのみマークされます。

* 複数の単語を入力すると、いずれかの単語を含む行が一致します（例： `error timeout`）。単語は、より長い単語の一部として含まれている場合も一致します（例： `back` は `backend`).
* にも一致します。
* 二重引用符で囲んだテキストは、1つのフレーズとして一致します。

特定のリクエストを見つけるには、 `"GET /stats HTTP/1.1"` のように引用符も含めて検索します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-7cdd4c050796aad4f2065fab5d266f7e94076213%2Fdevice-logs-search-phrase.png?alt=media" alt="Quoted phrase GET /stats HTTP/1.1 in the filter, highlighted in the matching lines"><figcaption></figcaption></figure>

### 重大度

「すべてのログタイプ」を開くと、リストとヒストグラムを特定の重大度に絞り込めます。「すべて選択」または「すべて解除」をクリックしてから、目的のレベルを選択するか、レベルの横にある「のみ」をクリックして、そのレベルだけに絞り込みます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-333262b4193de7e89323af6c63ebeeffd508efa9%2Fdevice-logs-severity.png?alt=media" alt="Severity menu with Select All, Clear All, and Debug through Emergency"><figcaption></figcaption></figure>

メニューに表示されるレベルはsyslogのレベルです。表では重大度の高い順に並んでおり、Linuxおよびjournaldと同じ順序です。メニューではDebugからEmergencyの順に並んでいます。

<table data-search="false"><thead><tr><th>レベル</th><th>番号</th><th>意味</th></tr></thead><tbody><tr><td>Emergency（緊急）</td><td>0</td><td>システムが使用不能な状態です。</td></tr><tr><td>Alert（警報）</td><td>1</td><td>直ちに対応してください。</td></tr><tr><td>Critical（重大）</td><td>2</td><td>重大な状態です。</td></tr><tr><td>Error（エラー）</td><td>3</td><td>エラーが発生しました。</td></tr><tr><td>Warning（警告）</td><td>4</td><td>警告です。「WARN」も同じレベルです。</td></tr><tr><td>Notice（通知）</td><td>5</td><td>通常の状態ですが、注意が必要です。</td></tr><tr><td>Info（情報）</td><td>6</td><td>通常の操作。</td></tr><tr><td>デバッグ</td><td>7</td><td>トラブルシューティングの詳細。</td></tr></tbody></table>

Roboflow では、Error、Warning、Info、Debug、Success が保存されます。Notice、Critical、Alert、Emergency は Info として保存されるため、これらのレベルでフィルターしても一致するログ行はありません。

### サービス

「All Services」を開いて、表示するサービスを選択します。サービスの横にある「only」をクリックすると、そのサービスだけに絞り込めます。「Clear All」をクリックすると選択をやり直せます。サービスが選択されていない場合、一覧に「Select at least one service to view logs.」と表示されます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-b8c8716ed438b294c3ed10e1fe34d545270823eb%2Fdevice-logs-services.png?alt=media" alt="Services menu listing event-store, hmi, inference, redis, and rfdm"><figcaption></figcaption></figure>

メニューにはデバイス上のサービスが一覧表示されます。一般的なデバイスでは、次のサービスがあります。

* `inference` モデルと Workflow を実行します。
* `rfdm` コンテナをインストールし、ログ、テレメトリ、デバイスのヘルス情報をRoboflowに送信します。
* `hmi` 設定されている場合、デバイス上のインターフェースを実行します。
* `redis` Roboflowと同期するまでテレメトリを保持します。
* `event-store` 設定されている場合、直近のビジョンイベントを保存します。詳細は [イベントストア](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/services/event-store.md).

Kernelとsystemd-oomdの行（例：メモリ不足によるプロセスの強制終了）は、Dockerデバイスでのみ、またそのデバイスの `device.json` 設定します `collect_kernel_logs` を true にします。この設定はデフォルトでオフです。このタブにはホストのジャーナル全体は表示されません。

デバイスから Roboflow へのレポートが停止した場合は、 `sudo /opt/rfdm/bin/rfdm tools run-checks` をデバイス上で実行します。Docker、Roboflow への接続、ディスク、メモリ、時刻同期、RFDM サービスを確認し、その後デバイスのコンテナを一覧表示します。 `--json` を追加すると、スクリプトで読み取れる形式で出力されます。

### ヒストグラム

「1h」「6h」「24h」「7d」「30d」をクリックすると、ヒストグラムの対象期間を設定できます。「Reset」をクリックすると7日間に戻ります。「Hide chart」をクリックすると折りたたまれます。グラフの下にある色付きの点は、それぞれの重大度を示します。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-b53ef79f6d5d08fb1a3d4b8501eb53a73ca0cd31%2Fdevice-logs-histogram.png?alt=media" alt="Histogram bars for a steady stretch, with the window buttons, Reset, and the severity legend"><figcaption></figcaption></figure>

### タイムスタンプ

ブラウザーのタイムゾーンで時刻を表示するには「ユーザーの時刻」を、デバイスのタイムゾーンで表示するには「デバイスの時刻」を選択します。「デバイスの時刻」は、Deployment Manager にデバイスの有効なタイムゾーンが設定されている場合に利用できます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-c717b0ee617b818401529a40f726b40251f0df78%2Fdevice-logs-timezone.png?alt=media" alt="User Time selected next to Device Time"><figcaption></figcaption></figure>

### ダウンロード

ダウンロードボタンをクリックすると、現在のフィルターに一致する行を CSV ファイルとしてエクスポートできます。

1. 「ログのダウンロード」で、「サービス」、「重大度」、「期間」、「検索」を確認します。「行数の上限」は、エクスポートに含める最大行数です。
2. 「一致するログをすべてエクスポート（最大 50,000 行）」がすでに選択されています。ブラウザーに現在読み込まれている行のみをエクスポートするには、「読み込み済みのログをエクスポート」を選択します。この選択肢では、ブラウザーで適用済みのフィルターを反映したうえで、最大 10,000 行が含まれます。
3. 「開始」をクリックします。
4. ファイルの準備ができたら、「CSV をダウンロード」をクリックします。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-59c0f3c0207849b72df2c74984e3696870e5c0fc%2Fdevice-logs-download.png?alt=media" alt="Download Logs dialog with the current filters, row limit, and the two export choices"><figcaption></figcaption></figure>

### アクティビティ

オン [アクティビティ](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/monitoring/view-device-activity.md)、エラーの「ログを表示」をクリックすると、その時点のこのタブが開きます。

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-5df570bad4636c493ca670536e1dadec4974e2b7%2Fdevice-logs-activity.png?alt=media" alt="View logs on an inference error in Activity"><figcaption></figcaption></figure>

### ログ送信レベル

デバイスからRoboflowに送信するログの最低重要度を選択するには、「Configuration」の「Advanced Configuration」で「Log Shipping Level」を設定します。デバイスは最大24時間分のログを保持します。デフォルトの送信レベルであるINFOでは、Infoおよびそれより重要度の高いすべてのレベル（顧客のPRINT出力を含む）に加え、デバイスイベントとレベルのない行が送信されます。DEBUGではすべての行が送信されます。詳しくは、 [デバイス設定を更新する](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager/making-changes/update-device-configuration.md).

<figure><img src="https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-cd0ad0d6723b0e9386e67a47eb0cc5a03df26a40%2Fdevice-logs-shipping.png?alt=media" alt="Log Shipping Level set to INFO under Advanced Configuration"><figcaption></figcaption></figure>

## エージェントとAPI

「 [Deployment Manager API](https://docs.roboflow.com/deployment/ja/self-hosted/enterprise/deployment-manager.md#device-logs-and-telemetry) は、時間範囲、サービス、重要度でフィルタリングした保存済みの行を返します。1回のリクエストで返される行は最大1,000件です。 `next_cursor` 戻すには `cursor` 古い行を読み取ります。このAPIにはキーワード検索機能はありません。

MCPクライアントは、次の方法でログを読み取ります。 `devices_get_logs` （ [MCPツール一覧](https://docs.roboflow.com/agents/mcp-server#devices-and-streams)を参照）。 [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) は、デバイスについて質問するとログを読み取ります。どちらも同じフィルターを使用し、行数の上限も1,000行です。また、Roboflow Agentは各メッセージからシークレットを削除します。
