ログとリクエストの検査
このページの内容 8セクション
トンネルで何が起きているかを確認できます。受信した HTTP リクエストの検査と再送、接続の一覧、開始、停止、設定変更のログの確認、1 日のヘルスチェックの確認ができます。このページでは、トンネルが停止したときに見る場所も説明します。
どこで何が使えるか #
これらはすべてトンネルの設定パネルにある項目です。マイトンネルで該当するトンネルタイプのページを開き、トンネルの行で設定を選びます。
| 項目 | 開く内容 | トンネルの種類 |
|---|---|---|
| リクエストログ | リクエストインスペクター。記録されたリクエストとレスポンスを表示します。 | HTTP、MCPゲートウェイ |
| リクエストログ | 接続ログ。誰が、いつ、どこに接続したかを表示します。 | TCP - UDP、TLS、ファイルサーバー、プロキシサーバー |
| アクティビティログ | トンネルの開始、停止、設定変更。 | すべてのトンネルタイプ |
| トンネルのヘルス | 定期的なヘルスチェックの結果。 | ファイルサーバーを除くすべてのトンネルタイプ |
| 帯域幅トラフィック | トンネルを通過したデータ量です。制限と有効期限をご覧ください。 | すべてのトンネルタイプ |
ローテーティングプロキシは、リクエストログをクライアントごとに保持します。クライアントのリクエストログボタンを使ってください。ローテーティングプロキシをご覧ください。
HTTP トンネルのリクエストインスペクター #
インスペクターは、HTTP または MCPゲートウェイのトンネルに届く HTTP リクエストを、ヘッダー、本文、およびお使いのサービスが返したレスポンスとともに表示します。自分のコードにログ出力を追加せずに、Webhook や API 呼び出しをデバッグできます。リクエストは、後述の方法でログを有効にした後にのみ記録されます。
記録はバイト単位の完全なコピーではありません。本文は最大 16 KB まで保存され、JSON、XML、HTML、プレーンテキスト、URL エンコードされたフォームデータなどのテキスト形式のみが対象です。Authorization、Cookie、X-Api-Key などの機密ヘッダーの値は、[MASKED] として保存されます。
インスペクターを開く #
- トンネルの設定でリクエストログ › 表示を選ぶか、
- トンネル一覧で、ツールチップがリクエストとレスポンスのログを表示のボタンを選びます。トンネルが停止している場合、このボタンは先にトンネルを開始するよう求めます。サーバー列がローカルまたは VPN のトンネルでは、このボタンは無効で、ツールチップに「Client Relayでは利用できません」と表示されます。
インスペクターページが新しいタブで開きます。
リクエスト一覧 #
HTTPリクエストカードに、リクエストが新しい順に表示され、スクロールするとさらに読み込まれます。バッジがライブのあいだ、一覧は 3 秒ごとに更新されます。
| 列 | 表示内容 |
|---|---|
| メソッド | GET や POST などの HTTP メソッド。 |
| エンドポイント | リクエストされたパス。 |
| 国、IP | リクエストの送信元。 |
| 日時 | リクエストが届いた日時。お使いのブラウザーの時刻で表示されます。 |
| ステータス | お使いのサービスが返した HTTP ステータスコード。 |
| 所要時間 | 応答にかかった時間(秒)。 |
フィルターなしの一覧は、直近 24 時間を対象とします。日付で絞り込みには今日、昨日、過去7日間、期間を指定があり、今日とその前の 6 日間が対象です。日付フィルターを使うとライブ一覧は一時停止します。戻るにはライブに戻るを選びます。インスペクションログは最大 7 日間保持されます。
リクエストとレスポンスの詳細 #
リクエストを選ぶと詳細が開きます。
| 部分 | タブ | 表示内容 |
|---|---|---|
| リクエスト | 概要 | リクエスト ID、リクエスト IP、メソッド、ホスト、パス、完全な URL、タイムスタンプ、URL の長さ、ヘッダーの数。 |
| リクエスト | ヘッダー | すべてのリクエストヘッダーとその値。 |
| リクエスト | 本文 | リクエストの本文。JSON は読みやすく整形されます。コピーでコピーできます。 |
| リクエスト | IP情報 | 訪問者の IP アドレスのタイムゾーン、大陸、国、市、郵便番号、地域、座標。 |
| レスポンス | 概要 | レスポンス ID、ステータス、応答時間、ヘッダーの数。 |
| レスポンス | ヘッダー、本文 | お使いのサービスが返した内容。 |
リクエストを再送する #
再送すれば、送信元に同じ Webhook をもう一度送ってもらう必要がありません。
- 再送は、選択したリクエストを記録から再び送信します。再送が要求された時点で、ページに「リクエストを再送しました。」と表示されます。結果は待ちません。
- 変更でリクエストを変更が開きます。再送を選ぶ前に、メソッド(GET、POST、PUT、DELETE、PATCH)、パス、ヘッダー(ヘッダーを追加)、本文を変更できます。
再送されるリクエストは、トンネルのデバイス上の Localtonet アプリが送信します。そのため、アプリが接続されている必要があります。
リクエストログのオンとオフ #
リクエストはログがオンのあいだだけ取得され、トンネルはログがオフの状態で開始します。オフのあいだ、ページには「リクエストログは無効です - 新しいリクエストは記録されません。」とログを有効化ボタンが表示されます。ログを無効化で、新しいリクエストの取得を再び止められます。パスワードや個人データなど、保存したくないデータがリクエスト本文に含まれるトンネルでは、ログをオフにしてください。この変更は、「HTTP Webhook設定を変更しました。」としてアクティビティログに記録されます。
その他のトンネルの接続ログ #
TCP - UDP、TLS、ファイルサーバー、プロキシサーバーのトンネルでは、リクエストログ › 表示でリクエストログダイアログが開きます。トンネルへの接続が新しい順に 1 ページ 30 件で表示されます。
| 列 | 表示内容 |
|---|---|
| 訪問者IP | トンネルに接続したアドレス。 |
| クライアントIP | その接続に対して記録されたクライアントのアドレス。 |
| 接続先 | 接続の行き先。プロキシトンネルでは、アクセスされたホストとポートです。 |
| 日付 | 発生した日時。アカウントのタイムゾーンで表示されます。 |
このログには接続のメタデータのみが含まれます。接続で送受信された内容は含まれません。
ログを CSV でダウンロードする #
CSVでダウンロードで最大 30 日間の期間を選び、ダウンロードを選びます。ファイル名は RequestLogs- で始まり、トンネルの内部識別子が続き、.csv で終わります。列は日時、リクエストIP、クライアントIP、接続先、トークン、プロトコルです。それより長い期間は、複数の範囲を順にダウンロードしてください。ダウンロードは 1 分に 1 回までなので、次のダウンロードまで 1 分待ってください。
アクティビティログ #
アクティビティログ › 表示には、トンネル自体に起きたことが新しい順に表示されます。各エントリには、アカウントのタイムゾーンでの日時、操作の元になったチャネル、何が変わったかを説明する文があります。
| チャネル | 操作の元 |
|---|---|
| Web | ダッシュボード。 |
| API | API。 |
| CLI | コマンドライン。 |
| システム | Localtonet 自身。たとえば、上限に達したときです。 |
典型的なエントリ:
- トンネルを開始しました。
- トンネルを停止しました。
- ローカルポートを「3000」から「8080」に変更しました。
- IP 制限を追加しました:「203.0.113.10」
- 帯域幅制限を変更しました:「10.00 GB」
- 有効期限をオフにしました。
新しいパスワードや変更後のパスワードはログに書き込まれません。「パスワードを設定しました。」または「パスワードを変更しました。」と表示されます。
トンネルのヘルス #
トンネルのヘルス › 表示でヘルスチェックダイアログが開きます。Localtonet はトンネルを 10 分ごとにチェックします。四角 1 つが当日の時間帯ごとの 1 回のチェックを表します。
| 値 | 意味 |
|---|---|
| 正常 | そのチェックの時点でトンネルが接続されていました。 |
| 異常 | そのチェックの時点でトンネルが接続されていませんでした。 |
| 不明 | その時刻にも、それ以前にも結果がありません。 |
| データなし | その時刻は今日まだ来ていません。 |
| 稼働率 | 正常と異常のチェックのうち、正常だったチェックの割合。 |
ダイアログに表示する四角がない場合は、「まだチェックの記録がありません。トンネルがしばらく稼働すると、ここに結果が表示されます。」と表示されます。
トンネルが停止したとき #
まずトンネルのアクティビティログを開いてください。最新の「停止」エントリに理由が記載されています。
| アクティビティログのエントリ | 何が起きたか | 対処方法 |
|---|---|---|
| 「トンネルを停止しました。」 | 誰かが停止しました。チャネルに操作の元が表示されます。たとえば、ダッシュボードなら Web、API なら API です。 | 開始を選びます。 |
| 「トンネルの帯域幅上限に達したため、トンネルを停止しました。」 | トンネル自身の帯域幅制限に達しました。 | 上限を引き上げるか、使用量をリセットします。制限と有効期限をご覧ください。 |
| 「有効期限に達したため、トンネルを停止しました。」 | トンネルの有効期限が過ぎました。 | より後の日付を設定するか、オフにします。制限と有効期限をご覧ください。 |
| 「無料の利用上限に達したため、トンネルを停止しました。」 | 無料プランのセッション上限に達しました。 | 開始を選んで新しいセッションを始めるか、残高を追加します。プランと残高をご覧ください。 |
| 「合計帯域幅の上限を超えたため、トンネルを停止しました。」 | アカウントの帯域幅を使い切りました。 | プランと残高をご覧ください。 |
| 「非アクティブで接続がなかったため、トンネルを停止しました。」 | 開始されたものの接続されなかったトンネルを、Localtonet が停止しました。 | Localtonet アプリを接続したままにし、トンネルが再び必要になったら開始を選びます。 |
ログに停止の記録がないのにアドレスが応答しない場合は、トンネル一覧の接続列を確認してください。オフは、トンネルが接続されていないことを意味します。デバイスで Localtonet アプリを起動してください。アプリがオフラインのときに開始を選ぶと、ダッシュボードに「NAME is offline」というタイトルのダイアログが開き、「アプリの接続を待っています…」と表示されます。アプリが接続すると、トンネルは自動的に開始します。このまま開始を選ぶとトンネルをすぐにオンにし、アプリが接続した時点で公開されます。
トンネルが停止したら通知を受け取れます。ダッシュボードの Webhookページから、トンネルの接続時または切断時に、指定した URL へ JSON の POST リクエストを送信できます。Webhookをご覧ください。
トラブルシューティング #
「先にトンネルを開始してください。」
トンネル一覧のインスペクターボタンは、実行中のトンネルでのみ開きます。トンネルを開始するか、トンネル設定のリクエストログ › 表示からインスペクターを開いてください。
インスペクターが空のまま
次の 3 点を確認してください。「リクエストログは無効です」のバナーが表示されていないこと、日付フィルターが有効になっていないこと(ライブに戻るを選びます)、そしてリクエストがサービスの別のアドレスではなく、トンネルのアドレスに実際に届いていることです。
「まだリクエストの記録がありません。」または「データが見つかりません!」
トンネルの接続ログにエントリがないか、CSV に選んだ期間にエントリがありません。別の期間を選んでください。
「このトンネルのログはありません。」
アクティビティログにまだエントリがありません。トンネルの開始、停止、変更に応じて記録が増えていきます。